SearchOptions

Initializes the search options with the provided parameters for a search request.

Initializes the search options along a specified route with additional parameters. This constructor is useful for defining searches that are constrained along a route, such as finding points of interest along the remaining part of a journey.

Contains the default values for the SearchOptions class.

A list of brand names (case sensitive) used to restrict the result.

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

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.

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

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

The GeoPoint position where results should be biased.

The maximum number of search results that will be returned. Defaults to DEFAULT_LIMIT. Please note that results are distributed across the provided geometries or countries. The returned number of results from each geometry or country may vary, and it could even be possible that all results come from one geometry or none at all.

The language in which search results should be returned. If not specified, language is set to the system default language.

The maximum detour duration (for a passenger car) limits the search area. The detour duration is the value added to the estimated time of arrival (to the final destination) after a point of interest is added to the route. Search results that add more than this value are filtered out. The maximum accepted value is 3600 seconds (which equals one hour). Default duration is set to MAX_DETOUR_DURATION_UPPER_LIMIT.

A power rate, used to restrict the results to electric vehicle stations with at least one connector that has a power lesser or equal to that maximum power.

A power rate, used to restrict the results to electric vehicle stations with at least one connector that has a power greater or equal to that minimum power.

The opening hours scope. If it's not provided, no data about opening hours will be returned.

The search query.

The route points define the skeleton of the search area. When conducting a search along a route, be aware that the number of points in the route influences the bandwidth usage. A route with a higher number of points consumes more data, which could lead to increased data cost while performing online search. Always consider this aspect when defining the route for your search.

The geographic filter for search, all search results returned are confined in the specified geography. Max number of geometries is MAX_NUMBER_OF_SEARCH_AREAS. Three types of geometries can be passed as searchAreas: CircleGeometry, RectangleGeometry and PolygonGeometry When a single CircleGeometry is set the CircleGeometry center overrides geoBias.

A set of SearchResultType which should be used for the search. An empty set implies search can return results of any type. Other filters can influence the selection of searchResultTypes. For example when a category filter is set, result types are limited to SearchResultType.Poi.

A search session is a user session during which a user performs multiple search requests to find a specific address or point of interest. This is needed for sending feedback to the online search. It must be a valid UUIDv4. If it is not provided, no feedback is sent.

Defines how the results will be sorted. Default value is SortOrder.ByDetourTime.