search:search-client-api-v2/com.tomtom.sdk.search.client.search/SearchOptions

SearchOptions

data class SearchOptions( val query: String = "", @IntRange(from = 1, to = 100) val limit: Int = 10, @IntRange(from = 0, to = 1900) val offset: Int = 0, val countryCodeSet: Set<String> = emptySet(), val geoBias: GeoCoordinate? = null, val searchAreas: Set<Geometry> = emptySet(), val locale: Locale? = null, @IntRange(from = 1, to = 4) val fuzzyLevel: Int = 2, val resultTypeSet: Set<SearchResultType> = emptySet(), val categorySet: Set<CategoryId> = emptySet(), val brandSet: Set<Brand> = emptySet(), val connectorSet: Set<ConnectorType> = emptySet(), val minPowerKW: Double? = null, val maxPowerKW: Double? = null, val fuelSet: Set<FuelType> = emptySet(), val geoPoliticalView: GeoPoliticalView? = null, val openingHours: OpeningHoursMode? = null, val sessionId: String = "")

Defines the parameters of a Fuzzy Search.

Parameters

query

The search query.

limit

The maximum number of search results that will be returned.

offset

The starting offset of the returned results within the full result set.

countryCodeSet

A set of ISO 3166-1 alpha3 country codes. (e.g., FRA,ESP). This will limit the search to the specified countries.

geoBias

The GeoCoordinate position where results should be biased.

searchAreas

The geographic filter for search, all search results returned are confined in the specified geography.

locale

The language in which search results should be returned. If not specified, language is set to the default official language of the location of the result.

fuzzyLevel

The fuzziness level to be used. When missing the implementation uses a default fuzzy search level of 2. The maximum value is 4.

resultTypeSet

A set of SearchResultType which should be used for the search. An empty set implies search can return results of any type.

categorySet

Restricts the Points Of Interest in the response to those whose ID is listed.

brandSet

A list of brand names used to restrict the result.

connectorSet

A list of connector types used to restrict the result to Points Of Interest of type Electric Vehicle Station, supporting specific connector types. See https://developer.tomtom.com/search-api/search-api-documentation/supported-connector-types for more details.

minPowerKW

A double value representing the power rate in kilowatts, used to restrict the result to the Points Of Interest of type Electric Vehicle Station supporting at least one connector with at that minimum power value (in kilowatts).

maxPowerKW

fuelSet

A set of a FuelType used to restrict the result to Points Of Interest with those specific fuels.

geoPoliticalView

Defines what kind of geopolitical view should be used.

openingHours

The opening hours scope.

sessionId

A search session is a user session during which a user performs multiple search requests to find a specific address ot point of interest. This is needed for sending feedback to the online search.

Constructors

SearchOptions

fun SearchOptions( query: String = "", @IntRange(from = 1, to = 100) limit: Int = 10, @IntRange(from = 0, to = 1900) offset: Int = 0, countryCodeSet: Set<String> = emptySet(), geoBias: GeoCoordinate? = null, searchAreas: Set<Geometry> = emptySet(), locale: Locale? = null, @IntRange(from = 1, to = 4) fuzzyLevel: Int = 2, resultTypeSet: Set<SearchResultType> = emptySet(), categorySet: Set<CategoryId> = emptySet(), brandSet: Set<Brand> = emptySet(), connectorSet: Set<ConnectorType> = emptySet(), minPowerKW: Double? = null, maxPowerKW: Double? = null, fuelSet: Set<FuelType> = emptySet(), geoPoliticalView: GeoPoliticalView? = null, openingHours: OpeningHoursMode? = null, sessionId: String = "")