org.elasticsearch.search.suggest.context

クラス GeolocationContextMapping

java.lang.Object

org.elasticsearch.search.suggest.context.ContextMapping

org.elasticsearch.search.suggest.context.GeolocationContextMapping

すべての実装されたインタフェース:

ToXContent

public class GeolocationContextMapping
extends ContextMapping

The GeolocationContextMapping allows to take GeoInfomation into account during building suggestions. The mapping itself works with geohashes explicitly and is configured by three parameters:

• precision: length of the geohash indexed as prefix of the completion field
• neighbors: Should the neighbor cells of the deepest geohash level also be indexed as alternatives to the actual geohash
• location: (optional) location assumed if it is not provided

Internally this mapping wraps the suggestions into a form [geohash][suggestion]. If the neighbor option is set the cells next to the cell on the deepest geohash level ( precision) will be indexed as well. The TokenStream used to build the FST for suggestion will be wrapped into a PrefixAnalyzer.PrefixTokenFilter managing these geohases as prefixes.

ネストされたクラスのサマリー

ネストされたクラス

修飾子とタイプ	クラスと説明
static class	GeolocationContextMapping.Builder

クラスから継承されたネストされたクラス/インタフェース org.elasticsearch.search.suggest.context.ContextMapping

ContextMapping.Context, ContextMapping.ContextConfig, ContextMapping.ContextQuery

インタフェースから継承されたネストされたクラス/インタフェース org.elasticsearch.common.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static String	FIELD_FIELDNAME
static String	FIELD_NEIGHBORS
static String	FIELD_PRECISION
static String	TYPE

クラスから継承されたフィールド org.elasticsearch.search.suggest.context.ContextMapping

EMPTY_CONFIG, EMPTY_CONTEXT, EMPTY_MAPPING, FIELD_MISSING, FIELD_TYPE, FIELD_VALUE, name, SEPARATOR, type

インタフェースから継承されたフィールド org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	GeolocationContextMapping(String name, int[] precision, boolean neighbors, Collection<String> defaultLocations, String fieldName) Create a new GeolocationContextMapping with a given precision

メソッドのサマリー

修飾子とタイプ	メソッドと説明
ContextMapping.ContextConfig	defaultConfig()
boolean	equals(Object obj)
int	hashCode()
protected static GeolocationContextMapping	load(String name, Map<String,Object> config) load a GeolocationContextMapping by configuration.
ContextMapping.ContextConfig	parseContext(ParseContext parseContext, XContentParser parser) A ContextMapping combined with the information provided by a document form a ContextMapping.ContextConfig which is used to build the underlying FST.
org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery	parseQuery(String name, XContentParser parser) Parse a query according to the context.
protected static Collection<String>	parseSinglePointOrList(XContentParser parser)
static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery	query(String name, double lat, double lon, int... precisions) Create a new geolocation query from a given geocoordinate
static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery	query(String name, double lat, double lon, String... precisions)
static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery	query(String name, GeoPoint point) Create a new geolocation query from a given GeoPoint
static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery	query(String name, String geohash, int... precisions) Create a new geolocation query from a given geohash
protected XContentBuilder	toInnerXContent(XContentBuilder builder, ToXContent.Params params) Since every context mapping is assumed to have a name given by the field name of an context object, this method is used to build the value used to serialize the mapping

クラスから継承されたメソッド org.elasticsearch.search.suggest.context.ContextMapping

mappingsAreEqual, name, toString, toXContent, type

クラスから継承されたメソッド java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

フィールドの詳細

TYPE

public static final String TYPE

関連項目:

定数フィールド値

FIELD_PRECISION

public static final String FIELD_PRECISION

関連項目:

定数フィールド値

FIELD_NEIGHBORS

public static final String FIELD_NEIGHBORS

関連項目:

定数フィールド値

FIELD_FIELDNAME

public static final String FIELD_FIELDNAME

関連項目:

定数フィールド値

コンストラクタの詳細

GeolocationContextMapping

protected GeolocationContextMapping(String name,
                                    int[] precision,
                                    boolean neighbors,
                                    Collection<String> defaultLocations,
                                    String fieldName)

Create a new GeolocationContextMapping with a given precision

パラメータ:

precision - length of the geohashes

neighbors - should neighbors be indexed

defaultLocations - location to use, if it is not provided by the document

メソッドの詳細

load

protected static GeolocationContextMapping load(String name,
                                                Map<String,Object> config)

load a GeolocationContextMapping by configuration. Such a configuration can set the parameters

• precision [String, Double, Float or Integer] defines the length of the underlying geohash
• defaultLocation [String] defines the location to use if it is not provided by the document
• neighbors [Boolean] defines if the last level of the geohash should be extended by neighbor cells

パラメータ:

config - Configuration for GeolocationContextMapping

戻り値:

new GeolocationContextMapping configured by the parameters of config

toInnerXContent

protected XContentBuilder toInnerXContent(XContentBuilder builder,
                                          ToXContent.Params params)
                                   throws IOException

クラスからコピーされた説明: ContextMapping

Since every context mapping is assumed to have a name given by the field name of an context object, this method is used to build the value used to serialize the mapping

定義:

toInnerXContent クラス内 ContextMapping

パラメータ:

builder - builder to append the mapping to

params - parameters passed to the builder

戻り値:

the builder used

例外:

IOException

parseSinglePointOrList

protected static Collection<String> parseSinglePointOrList(XContentParser parser)
                                                    throws IOException

例外:

IOException

defaultConfig

public ContextMapping.ContextConfig defaultConfig()

定義:

defaultConfig クラス内 ContextMapping

parseContext

public ContextMapping.ContextConfig parseContext(ParseContext parseContext,
                                                 XContentParser parser)
                                          throws IOException,
                                                 ElasticsearchParseException

クラスからコピーされた説明: ContextMapping

A ContextMapping combined with the information provided by a document form a ContextMapping.ContextConfig which is used to build the underlying FST.

定義:

parseContext クラス内 ContextMapping

パラメータ:

parseContext - context of parsing phase

parser - XContentParser used to read and setup the configuration

戻り値:

A ContextMapping.ContextConfig related to this mapping

例外:

IOException

ElasticsearchParseException

query

public static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery query(String name,
                                                                                                GeoPoint point)

Create a new geolocation query from a given GeoPoint

パラメータ:

point - query location

戻り値:

new geolocation query

query

public static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery query(String name,
                                                                                                double lat,
                                                                                                double lon,
                                                                                                int... precisions)

Create a new geolocation query from a given geocoordinate

パラメータ:

lat - latitude of the location

lon - longitude of the location

戻り値:

new geolocation query

query

public static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery query(String name,
                                                                                                double lat,
                                                                                                double lon,
                                                                                                String... precisions)

query

public static org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery query(String name,
                                                                                                String geohash,
                                                                                                int... precisions)

Create a new geolocation query from a given geohash

パラメータ:

geohash - geohash of the location

戻り値:

new geolocation query

parseQuery

public org.elasticsearch.search.suggest.context.GeolocationContextMapping.GeoQuery parseQuery(String name,
                                                                                              XContentParser parser)
                                                                                       throws IOException,
                                                                                              ElasticsearchParseException

クラスからコピーされた説明: ContextMapping

Parse a query according to the context. Parsing starts at parsers current position

定義:

parseQuery クラス内 ContextMapping

パラメータ:

name - name of the context

parser - XContentParser providing the data of the query

戻り値:

ContextMapping.ContextQuery according to this mapping

例外:

IOException

ElasticsearchParseException

hashCode

public int hashCode()

オーバーライド:

hashCode クラス内 Object

equals

public boolean equals(Object obj)

オーバーライド:

equals クラス内 Object