@tomtom-org/maps-sdk 0.59.0 → 0.61.0

package/services/dist/index.d.ts

@@ -1,181 +1,5 @@
-import { AddressProperties, AreaAnalyticsMetricKey, Avoidable, ChargingPark, ChargingParkWithAvailability, ChargingPoint, ChargingStation, ChargingStationsAccessType, ChargingStationsAvailability, ChargingStopProps, CommonPlaceProps, Connector, ConnectorType, CurrentType, EVChargingStationWithAvailabilityPlaceProps, EntryPoint, Fuel, GeographyType, GetPositionEntryPointOption, GlobalConfig, HasBBox, HasLngLat, MapcodeType, OpeningHours, OpeningHoursMode, POICategory, Place, PlaceType, Places, PlugType, PolygonFeature, PolygonFeatures, RevGeoAddressProps, RoadShieldReference, Route, RoutePlanningLocation, Routes, SearchPlaceProps, StaticChargingPoint, TimeZone, TomTomAPIHeaders, TomTomHeaders, TrafficAreaAnalytics, TrafficIncidentDetails, TrafficIncidentRequestCategory, TrafficIncidentTEC, TrafficIncidentTimeValidity, TravelMode, View, inputSectionTypes } from "@tomtom-org/maps-sdk/core";
+import { AddressProperties, AreaAnalyticsMetricKey, Avoidable, ChargingPark, ChargingParkWithAvailability, ChargingPoint, ChargingStation, ChargingStationsAccessType, ChargingStationsAvailability, ChargingStopProps, CommonPlaceProps, Connector, ConnectorType, CurrentType, EVChargingStationWithAvailabilityPlaceProps, EntryPoint, Fuel, GeographyType, GeopoliticalView, GetPositionEntryPointOption, GlobalConfig, HasBBox, HasLngLat, MapcodeType, OpeningHours, OpeningHoursMode, POICategory, Place, PlaceType, Places, PlugType, PolygonFeature, PolygonFeatures, RevGeoAddressProps, RoadShieldReference, Route, RoutePlanningLocation, Routes, SearchPlaceProps, StaticChargingPoint, TimeZone, TomTomAPIHeaders, TomTomHeaders, TrafficAreaAnalytics, TrafficIncidentDetails, TrafficIncidentRequestCategory, TrafficIncidentTEC, TrafficIncidentTimeValidity, TravelMode, inputSectionTypes } from "@tomtom-org/maps-sdk/core";
 import { ZodError, ZodIssue, ZodObject } from "zod";
-//#region ../node_modules/.pnpm/@types+geojson@7946.0.16/node_modules/@types/geojson/index.d.ts
-/**
- * The value values for the "type" property of GeoJSON Objects.
- * https://tools.ietf.org/html/rfc7946#section-1.4
- */
-type GeoJsonTypes = GeoJSON["type"];
-/**
- * Bounding box
- * https://tools.ietf.org/html/rfc7946#section-5
- */
-type BBox = [number, number, number, number] | [number, number, number, number, number, number];
-/**
- * A Position is an array of coordinates.
- * https://tools.ietf.org/html/rfc7946#section-3.1.1
- * Array should contain between two and three elements.
- * The previous GeoJSON specification allowed more elements (e.g., which could be used to represent M values),
- * but the current specification only allows X, Y, and (optionally) Z to be defined.
- *
- * Note: the type will not be narrowed down to `[number, number] | [number, number, number]` due to
- * marginal benefits and the large impact of breaking change.
- *
- * See previous discussions on the type narrowing:
- * - {@link https://github.com/DefinitelyTyped/DefinitelyTyped/pull/21590|Nov 2017}
- * - {@link https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/67773|Dec 2023}
- * - {@link https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/71441| Dec 2024}
- *
- * One can use a
- * {@link https://www.typescriptlang.org/docs/handbook/2/narrowing.html#using-type-predicates|user-defined type guard that returns a type predicate}
- * to determine if a position is a 2D or 3D position.
- *
- * @example
- * import type { Position } from 'geojson';
- *
- * type StrictPosition = [x: number, y: number] | [x: number, y: number, z: number]
- *
- * function isStrictPosition(position: Position): position is StrictPosition {
- *   return position.length === 2 || position.length === 3
- * };
- *
- * let position: Position = [-116.91, 45.54];
- *
- * let x: number;
- * let y: number;
- * let z: number | undefined;
- *
- * if (isStrictPosition(position)) {
- *   // `tsc` would throw an error if we tried to destructure a fourth parameter
- * 	 [x, y, z] = position;
- * } else {
- * 	 throw new TypeError("Position is not a 2D or 3D point");
- * }
- */
-type Position = number[];
-/**
- * The base GeoJSON object.
- * https://tools.ietf.org/html/rfc7946#section-3
- * The GeoJSON specification also allows foreign members
- * (https://tools.ietf.org/html/rfc7946#section-6.1)
- * Developers should use "&" type in TypeScript or extend the interface
- * to add these foreign members.
- */
-interface GeoJsonObject {
-  // Don't include foreign members directly into this type def.
-  // in order to preserve type safety.
-  // [key: string]: any;
-  /**
-   * Specifies the type of GeoJSON object.
-   */
-  type: GeoJsonTypes;
-  /**
-   * Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections.
-   * The value of the bbox member is an array of length 2*n where n is the number of dimensions
-   * represented in the contained geometries, with all axes of the most southwesterly point
-   * followed by all axes of the more northeasterly point.
-   * The axes order of a bbox follows the axes order of geometries.
-   * https://tools.ietf.org/html/rfc7946#section-5
-   */
-  bbox?: BBox | undefined;
-}
-/**
- * Union of GeoJSON objects.
- */
-type GeoJSON<G extends Geometry | null = Geometry, P = GeoJsonProperties> = G | Feature<G, P> | FeatureCollection<G, P>;
-/**
- * Geometry object.
- * https://tools.ietf.org/html/rfc7946#section-3
- */
-type Geometry = Point | MultiPoint | LineString | MultiLineString | Polygon | MultiPolygon | GeometryCollection;
-/**
- * Point geometry object.
- * https://tools.ietf.org/html/rfc7946#section-3.1.2
- */
-interface Point extends GeoJsonObject {
-  type: "Point";
-  coordinates: Position;
-}
-/**
- * MultiPoint geometry object.
- *  https://tools.ietf.org/html/rfc7946#section-3.1.3
- */
-interface MultiPoint extends GeoJsonObject {
-  type: "MultiPoint";
-  coordinates: Position[];
-}
-/**
- * LineString geometry object.
- * https://tools.ietf.org/html/rfc7946#section-3.1.4
- */
-interface LineString extends GeoJsonObject {
-  type: "LineString";
-  coordinates: Position[];
-}
-/**
- * MultiLineString geometry object.
- * https://tools.ietf.org/html/rfc7946#section-3.1.5
- */
-interface MultiLineString extends GeoJsonObject {
-  type: "MultiLineString";
-  coordinates: Position[][];
-}
-/**
- * Polygon geometry object.
- * https://tools.ietf.org/html/rfc7946#section-3.1.6
- */
-interface Polygon extends GeoJsonObject {
-  type: "Polygon";
-  coordinates: Position[][];
-}
-/**
- * MultiPolygon geometry object.
- * https://tools.ietf.org/html/rfc7946#section-3.1.7
- */
-interface MultiPolygon extends GeoJsonObject {
-  type: "MultiPolygon";
-  coordinates: Position[][][];
-}
-/**
- * Geometry Collection
- * https://tools.ietf.org/html/rfc7946#section-3.1.8
- */
-interface GeometryCollection<G extends Geometry = Geometry> extends GeoJsonObject {
-  type: "GeometryCollection";
-  geometries: G[];
-}
-type GeoJsonProperties = {
-  [name: string]: any;
-} | null;
-/**
- * A feature object which contains a geometry and associated properties.
- * https://tools.ietf.org/html/rfc7946#section-3.2
- */
-interface Feature<G extends Geometry | null = Geometry, P = GeoJsonProperties> extends GeoJsonObject {
-  type: "Feature";
-  /**
-   * The feature's geometry
-   */
-  geometry: G;
-  /**
-   * A value that uniquely identifies this feature in a
-   * https://tools.ietf.org/html/rfc7946#section-3.2.
-   */
-  id?: string | number | undefined;
-  /**
-   * Properties associated with this feature.
-   */
-  properties: P;
-}
-/**
- * A collection of feature objects.
- *  https://tools.ietf.org/html/rfc7946#section-3.3
- */
-interface FeatureCollection<G extends Geometry | null = Geometry, P = GeoJsonProperties> extends GeoJsonObject {
-  type: "FeatureCollection";
-  features: Array<Feature<G, P>>;
-}
-//#endregion
 //#region src/shared/types/apiResponseErrorTypes.d.ts
 /**
  * @ignore
@@ -748,10 +572,9 @@ export type SearchIndexType = 'Geo' | 'PAD' | 'Addr' | 'Str' | 'XStr' | 'POI';
  *
  * @remarks
  * **Applied to Services:**
- * - {@link discoverPlaces} and {@link fuzzySearch}
+ * - {@link discoverPlaces}
  * - {@link geocode}
  * - {@link reverseGeocode}
- * - {@link geometrySearch}
  *
  * **Key Features:**
  * - Result limits and pagination
@@ -763,7 +586,7 @@ export type SearchIndexType = 'Geo' | 'PAD' | 'Addr' | 'Str' | 'XStr' | 'POI';
  * ```typescript
  * // Search with mapcodes and specific geopolitical view
  * const detailedSearch: CommonPlacesParams<URL, Response> = {
- *   view: 'IN',  // India's perspective
+ *   geopoliticalView: 'IN', // India's perspective
  *   mapcodes: ['Local', 'International'],
  *   extendedPostalCodesFor: ['PAD', 'POI'],
  *   limit: 5
@@ -864,48 +687,6 @@ export type CommonPlacesParams<ApiRequest, ApiResponse> = CommonServiceParams<Ap
    * ```
    */
   mapcodes?: MapcodeType[];
-  /**
-   * Geopolitical view for disputed territories.
-   *
-   * Determines how borders and place names are displayed for disputed
-   * territories, according to different countries' perspectives.
-   *
-   * @remarks
-   * **Available Views:**
-   * - `Unified`: International/neutral view (default)
-   * - `AR`: Argentina's perspective
-   * - `IN`: India's perspective
-   * - `PK`: Pakistan's perspective
-   * - `IL`: Israel's perspective
-   * - `MA`: Morocco's perspective
-   * - `RU`: Russia's perspective
-   * - `TR`: Turkey's perspective
-   * - `CN`: China's perspective
-   * - `TW`: Taiwan's perspective
-   * - `RS`: Serbia's perspective
-   *
-   * `MA` is accepted by this type but is not supported by the current backend.
-   *
-   * **Affected Elements:**
-   * - Border lines on maps
-   * - Territory names
-   * - Administrative classifications
-   * - Place name spellings
-   *
-   * **Legal Compliance:**
-   * Use appropriate views based on your target audience and
-   * legal requirements in different regions.
-   *
-   * @default 'Unified'
-   *
-   * @example
-   * ```typescript
-   * view: 'Unified'  // Neutral international view
-   * view: 'IN'       // India's perspective
-   * view: 'CN'       // China's perspective
-   * ```
-   */
-  view?: View;
 };
 //#endregion
 //#region src/shared/types/searchFilters.d.ts
@@ -976,7 +757,7 @@ export type SearchFilters = PlaceFilters & GeographicFilters;
  *
  * @remarks
  * Used by:
- * - {@link fuzzySearch}
+ * - {@link discoverPlaces}
  * - {@link geocode}
  *
  * @group Places Search
@@ -1248,6 +1029,8 @@ type ChargingModel = {
    * Must contain from zero to up to 20 (inclusive) json objects describing a battery point,
    * each containing stateOfChargeInkWh and maxPowerInkW.
    *
+   * Required for a route with charging stops (`preferences.chargingPreferences`): the service rejects one without it.
+   *
    * None of the stateOfChargeInkWh values from such an object may equal any other stateOfChargeInkWh of an object.
    * maxPowerInkW must be larger than zero.
    */
@@ -2214,7 +1997,7 @@ export type ElectricVehicleParams = {
    * @remarks
    * Should include battery capacity, charging curve, and consumption profiles. A predefined
    * `variantId` is accepted here, but only `calculateRoute` with charging preferences understands
-   * one — a range or a matrix has no charging stops to plan for.
+   * one — a range has no charging stops to plan for.
    */
   model?: VehicleModel<'electric'>;
   /**
@@ -2597,8 +2380,8 @@ export type DepartArriveParams<Option extends DepartArriveOption = DepartArriveO
  * They provide a consistent interface across different routing services.
  *
  * @remarks
- * Most routing services (calculateRoute, calculateMatrixRoute, calculateReachableRange)
- * accept these parameters to customize route calculation. They control:
+ * Both routing services (calculateRoute, calculateReachableRange) accept these parameters
+ * to customize route calculation. They control:
  * - What to optimize for (time, distance, fuel)
  * - Vehicle constraints and capabilities
  * - When to travel (affecting traffic)
@@ -2607,7 +2390,6 @@ export type DepartArriveParams<Option extends DepartArriveOption = DepartArriveO
  *
  * **Service Compatibility:**
  * - {@link calculateRoute}: All parameters supported
- * - {@link calculateMatrixRoute}: Subset of parameters
  * - {@link calculateReachableRange}: Subset of parameters
  *
  * @example
@@ -2770,10 +2552,7 @@ export type TimeZoneRequest = 'iana';
  * @typeParam ApiResponse - The API response type
  *
  * @remarks
- * Used by:
- * - {@link discoverPlaces}
- * - {@link fuzzySearch}
- * - {@link geometrySearch}
+ * Used by {@link discoverPlaces}.
  *
  * Provides:
  * - POI category, brand, EV charging and fuel type filters (`filters`)
@@ -2895,57 +2674,231 @@ export type CommonSearchParams<ApiRequest, ApiResponse> = CommonPlacesParams<Api
   relatedPois?: RelatedPoisRequest;
 };
 //#endregion
-//#region src/shared/types/searchSummary.d.ts
+//#region ../node_modules/.pnpm/@types+geojson@7946.0.16/node_modules/@types/geojson/index.d.ts
 /**
- * Query type classification for search results.
- *
- * Indicates whether the search was location-based or general.
- *
- * @remarks
- * - `NEARBY`: Results are based on proximity to a specified location (uses `at` parameter)
- * - `NON_NEAR`: General search without location bias, or results span a wide area
- *
- * @group Places Search
+ * The value values for the "type" property of GeoJSON Objects.
+ * https://tools.ietf.org/html/rfc7946#section-1.4
  */
-type SummaryQueryType = 'NEARBY' | 'NON_NEAR';
+type GeoJsonTypes = GeoJSON["type"];
 /**
- * Metadata summary for search API responses.
+ * Bounding box
+ * https://tools.ietf.org/html/rfc7946#section-5
+ */
+type BBox = [number, number, number, number] | [number, number, number, number, number, number];
+/**
+ * A Position is an array of coordinates.
+ * https://tools.ietf.org/html/rfc7946#section-3.1.1
+ * Array should contain between two and three elements.
+ * The previous GeoJSON specification allowed more elements (e.g., which could be used to represent M values),
+ * but the current specification only allows X, Y, and (optionally) Z to be defined.
  *
- * Provides information about the search query execution, result counts, and the cursor that
- * continues the search. This metadata helps understand how the search was processed and page
- * through results.
+ * Note: the type will not be narrowed down to `[number, number] | [number, number, number]` due to
+ * marginal benefits and the large impact of breaking change.
  *
- * @remarks
- * This summary is included in responses from:
- * - {@link discoverPlaces}
- * - {@link fuzzySearch}
- * - {@link geometrySearch}
- * - {@link geocode}
+ * See previous discussions on the type narrowing:
+ * - {@link https://github.com/DefinitelyTyped/DefinitelyTyped/pull/21590|Nov 2017}
+ * - {@link https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/67773|Dec 2023}
+ * - {@link https://github.com/DefinitelyTyped/DefinitelyTyped/discussions/71441| Dec 2024}
+ *
+ * One can use a
+ * {@link https://www.typescriptlang.org/docs/handbook/2/narrowing.html#using-type-predicates|user-defined type guard that returns a type predicate}
+ * to determine if a position is a 2D or 3D position.
  *
  * @example
- * ```typescript
- * const results = await discoverPlaces({
- *   query: 'pizza',
- *   geoBias: { position: [4.9, 52.3] }
- * });
+ * import type { Position } from 'geojson';
  *
- * const summary = results.properties;
- * console.log(`Found ${summary?.totalResults ?? 'an unknown number of'} total results`);
- * console.log(`Showing ${summary?.numResults} results`);
- * console.log(`Query type: ${summary?.queryType}`); // 'NEARBY'
- * console.log(`Search took ${summary?.queryTime}ms`);
- * ```
+ * type StrictPosition = [x: number, y: number] | [x: number, y: number, z: number]
  *
- * @group Places Search
- */
-export type SearchSummary = {
-  /**
-   * The search query as interpreted and processed by the search engine.
-   *
-   * May differ from the original input due to:
-   * - Normalization (case, spacing, diacritics)
-   * - Spelling corrections
-   * - Query expansion
+ * function isStrictPosition(position: Position): position is StrictPosition {
+ *   return position.length === 2 || position.length === 3
+ * };
+ *
+ * let position: Position = [-116.91, 45.54];
+ *
+ * let x: number;
+ * let y: number;
+ * let z: number | undefined;
+ *
+ * if (isStrictPosition(position)) {
+ *   // `tsc` would throw an error if we tried to destructure a fourth parameter
+ * 	 [x, y, z] = position;
+ * } else {
+ * 	 throw new TypeError("Position is not a 2D or 3D point");
+ * }
+ */
+type Position = number[];
+/**
+ * The base GeoJSON object.
+ * https://tools.ietf.org/html/rfc7946#section-3
+ * The GeoJSON specification also allows foreign members
+ * (https://tools.ietf.org/html/rfc7946#section-6.1)
+ * Developers should use "&" type in TypeScript or extend the interface
+ * to add these foreign members.
+ */
+interface GeoJsonObject {
+  // Don't include foreign members directly into this type def.
+  // in order to preserve type safety.
+  // [key: string]: any;
+  /**
+   * Specifies the type of GeoJSON object.
+   */
+  type: GeoJsonTypes;
+  /**
+   * Bounding box of the coordinate range of the object's Geometries, Features, or Feature Collections.
+   * The value of the bbox member is an array of length 2*n where n is the number of dimensions
+   * represented in the contained geometries, with all axes of the most southwesterly point
+   * followed by all axes of the more northeasterly point.
+   * The axes order of a bbox follows the axes order of geometries.
+   * https://tools.ietf.org/html/rfc7946#section-5
+   */
+  bbox?: BBox | undefined;
+}
+/**
+ * Union of GeoJSON objects.
+ */
+type GeoJSON<G extends Geometry | null = Geometry, P = GeoJsonProperties> = G | Feature<G, P> | FeatureCollection<G, P>;
+/**
+ * Geometry object.
+ * https://tools.ietf.org/html/rfc7946#section-3
+ */
+type Geometry = Point | MultiPoint | LineString | MultiLineString | Polygon | MultiPolygon | GeometryCollection;
+/**
+ * Point geometry object.
+ * https://tools.ietf.org/html/rfc7946#section-3.1.2
+ */
+interface Point extends GeoJsonObject {
+  type: "Point";
+  coordinates: Position;
+}
+/**
+ * MultiPoint geometry object.
+ *  https://tools.ietf.org/html/rfc7946#section-3.1.3
+ */
+interface MultiPoint extends GeoJsonObject {
+  type: "MultiPoint";
+  coordinates: Position[];
+}
+/**
+ * LineString geometry object.
+ * https://tools.ietf.org/html/rfc7946#section-3.1.4
+ */
+interface LineString extends GeoJsonObject {
+  type: "LineString";
+  coordinates: Position[];
+}
+/**
+ * MultiLineString geometry object.
+ * https://tools.ietf.org/html/rfc7946#section-3.1.5
+ */
+interface MultiLineString extends GeoJsonObject {
+  type: "MultiLineString";
+  coordinates: Position[][];
+}
+/**
+ * Polygon geometry object.
+ * https://tools.ietf.org/html/rfc7946#section-3.1.6
+ */
+interface Polygon extends GeoJsonObject {
+  type: "Polygon";
+  coordinates: Position[][];
+}
+/**
+ * MultiPolygon geometry object.
+ * https://tools.ietf.org/html/rfc7946#section-3.1.7
+ */
+interface MultiPolygon extends GeoJsonObject {
+  type: "MultiPolygon";
+  coordinates: Position[][][];
+}
+/**
+ * Geometry Collection
+ * https://tools.ietf.org/html/rfc7946#section-3.1.8
+ */
+interface GeometryCollection<G extends Geometry = Geometry> extends GeoJsonObject {
+  type: "GeometryCollection";
+  geometries: G[];
+}
+type GeoJsonProperties = {
+  [name: string]: any;
+} | null;
+/**
+ * A feature object which contains a geometry and associated properties.
+ * https://tools.ietf.org/html/rfc7946#section-3.2
+ */
+interface Feature<G extends Geometry | null = Geometry, P = GeoJsonProperties> extends GeoJsonObject {
+  type: "Feature";
+  /**
+   * The feature's geometry
+   */
+  geometry: G;
+  /**
+   * A value that uniquely identifies this feature in a
+   * https://tools.ietf.org/html/rfc7946#section-3.2.
+   */
+  id?: string | number | undefined;
+  /**
+   * Properties associated with this feature.
+   */
+  properties: P;
+}
+/**
+ * A collection of feature objects.
+ *  https://tools.ietf.org/html/rfc7946#section-3.3
+ */
+interface FeatureCollection<G extends Geometry | null = Geometry, P = GeoJsonProperties> extends GeoJsonObject {
+  type: "FeatureCollection";
+  features: Array<Feature<G, P>>;
+}
+//#endregion
+//#region src/shared/types/searchSummary.d.ts
+/**
+ * Query type classification for search results.
+ *
+ * Indicates whether the search was location-based or general.
+ *
+ * @remarks
+ * - `NEARBY`: Results are based on proximity to a specified location (uses `at` parameter)
+ * - `NON_NEAR`: General search without location bias, or results span a wide area
+ *
+ * @group Places Search
+ */
+type SummaryQueryType = 'NEARBY' | 'NON_NEAR';
+/**
+ * Metadata summary for search API responses.
+ *
+ * Provides information about the search query execution, result counts, and the cursor that
+ * continues the search. This metadata helps understand how the search was processed and page
+ * through results.
+ *
+ * @remarks
+ * This summary is included in responses from:
+ * - {@link discoverPlaces}
+ * - {@link geocode}
+ *
+ * @example
+ * ```typescript
+ * const results = await discoverPlaces({
+ *   query: 'pizza',
+ *   geoBias: { position: [4.9, 52.3] }
+ * });
+ *
+ * const summary = results.properties;
+ * console.log(`Found ${summary?.totalResults ?? 'an unknown number of'} total results`);
+ * console.log(`Showing ${summary?.numResults} results`);
+ * console.log(`Query type: ${summary?.queryType}`); // 'NEARBY'
+ * console.log(`Search took ${summary?.queryTime}ms`);
+ * ```
+ *
+ * @group Places Search
+ */
+export type SearchSummary = {
+  /**
+   * The search query as interpreted and processed by the search engine.
+   *
+   * May differ from the original input due to:
+   * - Normalization (case, spacing, diacritics)
+   * - Spelling corrections
+   * - Query expansion
    * - Stop word removal
    *
    * @example
@@ -3074,28 +3027,6 @@ export type SearchSummary = {
   geoBias?: Position;
 };
 //#endregion
-//#region src/along-route-search/types/alongRouteSearchRequestAPI.d.ts
-/**
- * @ignore
- */
-type RoutePointAPI = {
-  lat: number;
-  lon: number;
-};
-/**
- * @ignore
- */
-type AlongRouteSearchPayloadAPI = {
-  route: {
-    points: RoutePointAPI[];
-  };
-};
-/**
- * Along-route search request type.
- * @ignore
- */
-type AlongRouteSearchRequestAPI = PostObject<AlongRouteSearchPayloadAPI>;
-//#endregion
 //#region src/shared/types/apiPlacesResponseTypes.d.ts
 /**
  * @ignore
@@ -3270,228 +3201,50 @@ type CommonSearchPlaceResultAPI = Omit<SearchPlaceProps, 'distance' | 'position'
   chargingStations?: ChargingStationAPI[];
 };
 //#endregion
-//#region src/along-route-search/types/alongRouteSearchResponseAPI.d.ts
+//#region src/ev-charging-stations-availability/types/apiTypes.d.ts
 /**
  * @ignore
  */
-type AlongRouteSearchResultAPI = CommonSearchPlaceResultAPI;
+type EVChargingStationResultAPI = {
+  id: string;
+  name: string;
+  position: LatLonAPI;
+  openingHours: OpeningHoursAPI;
+  timeZone: TimeZone;
+  accessType: ChargingStationsAccessType;
+  chargingStations: ChargingStationAPI<Pick<ChargingPoint, 'status'>>[];
+};
 /**
  * @ignore
  */
-type AlongRouteSearchResponseAPI = {
-  /**
-   * Summary information about the search that was performed.
-   */
-  summary: SummaryAPI$1;
-  /**
-   * The result list, sorted by detour time or offset.
-   */
-  results: AlongRouteSearchResultAPI[];
+type ChargingStationsAvailabilityResponseAPI = {
+  summary: {
+    numResults: number;
+    offset: number;
+    totalResults: number;
+  };
+  results?: EVChargingStationResultAPI[];
 };
 //#endregion
-//#region src/along-route-search/types/alongRouteSearchParams.d.ts
+//#region src/ev-charging-stations-availability/types/evChargingStationsAvailabilityParams.d.ts
 /**
- * Result sorting order for along-route search.
+ * Parameters for the EV Charging Stations Availability service.
  *
- * Controls how the returned POIs are ordered relative to the route.
+ * Fetches real-time availability status of charging points at an EV charging park.
  *
  * @remarks
- * Pass these to {@link discoverPlaces}, which selects the request variant from the params it is given:
- * a `route` property dispatches to along-route search, a `geometries` property to geometry search,
- * and neither to fuzzy search. {@link alongRouteSearch} is also exported directly.
- *
- * - `detourTime`: Sort by additional travel time required to visit the POI (default)
- * - `detourOffset`: Sort by how far along the route the detour point falls
- *
- * @group Along Route Search
- */
-type AlongRouteSortBy = 'detourTime' | 'detourOffset';
-/**
- * Parameters for searching places along a route.
- *
- * Along-route search finds POIs near a provided route geometry and ranks them
- * by the detour cost (time or distance offset) required to visit them.
- *
- * @remarks
- * **Key Features:**
- * - Search for POIs within a detour budget from the route
- * - Sort results by detour time or route offset
- * - Combine with POI category and brand filters
- * - Use directly with a {@link calculateRoute} result
- *
- * **Use Cases:**
- * - Find fuel stations or EV chargers along a trip
- * - Locate rest stops or restaurants near a route
- * - Surface services reachable within a time budget
- *
- * @example
- * ```typescript
- * // Find coffee shops within a 5-minute detour from a route
- * const results = await discoverPlaces({
- *   route: routeResult.features[0],
- *   maxDetourTimeSeconds: 300,
- *   query: 'coffee',
- * });
- *
- * // Find EV charging stations using a plain coordinate array
- * const chargers = await discoverPlaces({
- *   route: [[4.9, 52.37], [4.95, 52.28], [5.1, 52.09]],
- *   maxDetourTimeSeconds: 600,
- *   filters: { poiCategories: ['CHARGING_LOCATION'] },
- *   sortBy: 'detourOffset',
- * });
- * ```
- *
- * @group Along Route Search
- */
-type AlongRouteSearchParams = CommonSearchParams<AlongRouteSearchRequestAPI, AlongRouteSearchResponseAPI> & {
-  /**
-   * Route geometry to search along.
-   *
-   * Accepts any of three forms:
-   * - **`Route`** feature as returned by {@link calculateRoute} (most common)
-   * - **`LineString`** GeoJSON geometry object
-   * - **`Position[]`** — a plain array of `[longitude, latitude]` coordinate pairs
-   *
-   * Coordinates must always be in `[longitude, latitude]` order.
-   *
-   * @example
-   * ```typescript
-   * // Route Feature from calculateRoute (most common)
-   * route: routeResult.features[0]
-   *
-   * // GeoJSON LineString geometry
-   * route: routeResult.features[0].geometry
-   *
-   * // Plain coordinate array
-   * route: [[4.9, 52.37], [4.95, 52.28], [5.1, 52.09]]
-   * ```
-   */
-  route: LineString | Route | Position[];
-  /**
-   * Maximum allowed detour time in seconds.
-   *
-   * Only POIs reachable within this additional travel time from the route
-   * will be returned. Controls the width of the search corridor.
-   *
-   * @example
-   * ```typescript
-   * maxDetourTimeSeconds: 300  // 5-minute detour budget
-   * ```
-   */
-  maxDetourTimeSeconds: number;
-  /**
-   * Sort order for the results.
-   *
-   * @default 'detourTime'
-   *
-   * @example
-   * ```typescript
-   * sortBy: 'detourOffset'  // order by position along the route
-   * ```
-   */
-  sortBy?: AlongRouteSortBy;
-};
-//#endregion
-//#region src/along-route-search/types/alongRouteSearchResponse.d.ts
-/**
- * Response from an along-route search query.
- *
- * Contains places found near the route, sorted by detour time or offset,
- * along with summary information about the search results.
- *
- * @group Along Route Search
- */
-type AlongRouteSearchResponse = Places<SearchPlaceProps, SearchSummary>;
-//#endregion
-//#region src/along-route-search/alongRouteSearch.d.ts
-/**
- * Search for places along a route, ranked by detour cost.
- *
- * Returns POIs reachable within a given detour budget from the provided route geometry.
- * Results are sorted by detour time (or offset along the route) so the most
- * accessible stops appear first.
- *
- * @remarks
- * This service is ideal for trip planning use cases:
- * - Find fuel or EV charging stations along the way
- * - Locate food stops or rest areas near the route
- * - Surface services reachable within a time budget
- *
- * The `route` is typically sourced from a {@link calculateRoute} result.
- *
- * @param params Along-route search parameters including the route geometry and detour budget
- *
- * @returns Promise resolving to a collection of matching places sorted by detour cost
- *
- * @example
- * ```typescript
- * // Find coffee shops within a 5-minute detour
- * const results = await alongRouteSearch({
- *   route: routeResult.features[0].geometry,
- *   maxDetourTimeSeconds: 300,
- *   query: 'coffee',
- * });
- *
- * // EV chargers with a 10-minute budget, sorted by position on route
- * const chargers = await alongRouteSearch({
- *   route: routeResult.features[0].geometry,
- *   maxDetourTimeSeconds: 600,
- *   filters: { poiCategories: ['CHARGING_LOCATION'] },
- *   sortBy: 'detourOffset',
- * });
- * ```
- *
- * @see [Along Route Search API Documentation](https://docs.tomtom.com/search-api/documentation/tomtom-orbis-maps/search-service/along-route-search)
- *
- * @ignore (exposed via 'search')
- */
-export declare const alongRouteSearch: (params: AlongRouteSearchParams) => Promise<AlongRouteSearchResponse>;
-//#endregion
-//#region src/ev-charging-stations-availability/types/apiTypes.d.ts
-/**
- * @ignore
- */
-type EVChargingStationResultAPI = {
-  id: string;
-  name: string;
-  position: LatLonAPI;
-  openingHours: OpeningHoursAPI;
-  timeZone: TimeZone;
-  accessType: ChargingStationsAccessType;
-  chargingStations: ChargingStationAPI<Pick<ChargingPoint, 'status'>>[];
-};
-/**
- * @ignore
- */
-type ChargingStationsAvailabilityResponseAPI = {
-  summary: {
-    numResults: number;
-    offset: number;
-    totalResults: number;
-  };
-  results?: EVChargingStationResultAPI[];
-};
-//#endregion
-//#region src/ev-charging-stations-availability/types/evChargingStationsAvailabilityParams.d.ts
-/**
- * Parameters for the EV Charging Stations Availability service.
- *
- * Fetches real-time availability status of charging points at an EV charging park.
- *
- * @remarks
- * **Key Information Returned:**
- * - Charging point availability status (Available, Occupied, Reserved, Out of Service)
- * - Connector details (power ratings, plug types)
- * - Aggregated availability counts
- * - Access restrictions
- * - Opening hours
+ * **Key Information Returned:**
+ * - Charging point availability status (Available, Occupied, Reserved, Out of Service)
+ * - Connector details (power ratings, plug types)
+ * - Aggregated availability counts
+ * - Access restrictions
+ * - Opening hours
  *
  * @example
  * ```typescript
  * // Basic usage
  * const params: ChargingStationsAvailabilityParams = {
- *   key: 'your-api-key',
+ *   apiKey: 'your-api-key',
  *   id: 'charging-park-id-from-search'
  * };
  *
@@ -3500,7 +3253,7 @@ type ChargingStationsAvailabilityResponseAPI = {
  * const chargingParkId = searchResult.features[0].properties.dataSources?.chargingAvailability?.id;
  *
  * const params: ChargingStationsAvailabilityParams = {
- *   key: 'your-api-key',
+ *   apiKey: 'your-api-key',
  *   id: chargingParkId
  * };
  * ```
@@ -3532,6 +3285,31 @@ type ChargingStationsAvailabilityParams = CommonServiceParams<URL, ChargingStati
    */
   id: string;
 };
+/**
+ * Options of {@link getPlacesWithEVAvailability}: the common service parameters forwarded to each
+ * availability request, how many of those requests may be in flight at once, and what to do with
+ * the places left without availability.
+ *
+ * @group EV Charging
+ */
+type PlacesWithEVAvailabilityOptions = Omit<ChargingStationsAvailabilityParams, 'id'> & {
+  /**
+   * The most availability requests in flight at once. Values below 1 count as 1.
+   *
+   * @remarks
+   * Each request counts against your API key's QPS (queries per second) limit. The SDK retries a
+   * rate-limited (`429`) request with backoff bounded by the global `retry.timeoutMs`, so a value
+   * above that limit slows the call down; a request still rejected leaves its place with unknown
+   * availability.
+   * @default 1
+   */
+  maxConcurrentRequests?: number;
+  /**
+   * If true, places with unknown availability are filtered out. Otherwise, they are returned unchanged.
+   * @default false
+   */
+  excludeIfAvailabilityUnknown?: boolean;
+};
 //#endregion
 //#region src/ev-charging-stations-availability/evChargingStationsAvailability.d.ts
 /**
@@ -3624,15 +3402,15 @@ export declare const getPlaceWithEVAvailability: <P extends CommonPlaceProps = C
  * and merges it into their properties. Non-EV places and EV stations without availability data are returned unchanged.
  *
  * @remarks
- * **Important**: Availability requests are made sequentially to avoid exceeding
- * API rate limits (QPS - Queries Per Second). For large result sets, this may
- * take some time. Pass a `signal` to stop early: aborting it cancels the in-flight
- * request, skips the remaining ones and rejects with {@link SDKAbortError}.
+ * **One request per station**, at most `maxConcurrentRequests` at a time — one by default, so a
+ * large result set takes as many round trips in series. A failed request leaves its place with
+ * unknown availability rather than failing the call.
  *
- * Needs the same API key access as {@link evChargingStationsAvailability}. A place whose request
- * fails, including for a key without that access, counts as having unknown availability.
+ * Pass a `signal` to stop early: aborting it cancels the in-flight requests, skips the remaining
+ * ones and rejects with {@link SDKAbortError}. Needs the same API key access as
+ * {@link evChargingStationsAvailability}.
  *
- * @param places - Collection of places to enhance
+ * @param places - Collection of places to enhance, returned in the same order
  * @param options - Configuration options, including common service parameters (e.g. `apiKey`, `onAPIRequest`, `signal`) forwarded to each availability request
  *
  * @returns Promise resolving to places collection with merged availability
@@ -3658,16 +3436,10 @@ export declare const getPlaceWithEVAvailability: <P extends CommonPlaceProps = C
  *
  * @group EV Charging
  */
-export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(places: Places<P>, options?: Omit<ChargingStationsAvailabilityParams, 'id'> & {
+export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(places: Places<P>, options: PlacesWithEVAvailabilityOptions & {
   excludeIfAvailabilityUnknown: true;
 }): Promise<Places<EVChargingStationWithAvailabilityPlaceProps>>;
-export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(places: Places<P>, options?: Omit<ChargingStationsAvailabilityParams, 'id'> & {
-  /**
-   * If true, places with unknown availability will be filtered out. Otherwise, they will be included.
-   * @default false
-   */
-  excludeIfAvailabilityUnknown?: false;
-}): Promise<Places<P | EVChargingStationWithAvailabilityPlaceProps>>;
+export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(places: Places<P>, options?: PlacesWithEVAvailabilityOptions): Promise<Places<P | EVChargingStationWithAvailabilityPlaceProps>>;
 /**
  * Type guard to check if a ChargingPark has availability data.
  *
@@ -4104,388 +3876,93 @@ type GeometryPlaceParams = CommonServiceParamsWithZoom & {
 /**
  * Union type for all geometry data parameter formats.
  *
- * Accepts either geometry IDs directly or places containing geometry IDs.
- *
- * @remarks
- * **Choose the right type:**
- * - {@link GeometryDataParams}: When you have geometry IDs as strings
- * - {@link GeometryPlaceParams}: When you have place objects from search
- *
- * @example
- * ```typescript
- * // Using IDs
- * const idParams: GeometryParams = {
- *   key: 'your-api-key',
- *   geometries: ['g1234567890']
- * };
- *
- * // Using places
- * const placeParams: GeometryParams = {
- *   key: 'your-api-key',
- *   geometries: searchResults
- * };
- * ```
- *
- * @group Geometry
- */
-type GeometryParams = GeometryDataParams | GeometryPlaceParams;
-//#endregion
-//#region src/geometry-data/geometryData.d.ts
-/**
- * Retrieve polygon geometries representing geographic area boundaries.
- *
- * The Geometry Data service returns coordinate sets that define the outlines of
- * geographic areas such as cities, countries, administrative regions, or POI footprints.
- * These polygons enable visualization of area boundaries, spatial analysis, and
- * geofencing applications.
- *
- * @remarks
- * Key features:
- * - **Batch requests**: Fetch up to 20 geometries in a single call
- * - **Multiple scales**: From countries down to building footprints
- * - **Place integration**: Can merge with place data for enriched results
- * - **Standard GeoJSON**: Returns standard Polygon/MultiPolygon features
- *
- * Common use cases:
- * - Display city or country boundaries on maps
- * - Show POI building footprints
- * - Create geofences for spatial queries
- * - Visualize administrative divisions
- * - Calculate areas and spatial relationships
- *
- * Returns polygons, not places. Pass the result to `GeometriesModule.show()`,
- * not `PlacesModule.show()`. The `geometryId` comes from a prior search result.
- *
- * @param params - Geometry parameters with IDs or places to fetch boundaries for
- *
- * @returns Promise resolving to polygon features representing area boundaries
- *
- * @example
- * ```typescript
- * // Fetch geometry by ID
- * const cityBoundary = await geometryData({
- *   key: 'your-api-key',
- *   geometries: ['geometry-id-123']
- * });
- *
- * // Fetch multiple geometries at once
- * const boundaries = await geometryData({
- *   key: 'your-api-key',
- *   geometries: ['country-id-1', 'city-id-2', 'poi-id-3']
- * });
- *
- * // Fetch and merge with place data
- * const searchResults = await discoverPlaces({ query: 'Amsterdam' });
- * const withBoundaries = await geometryData({
- *   key: 'your-api-key',
- *   geometries: searchResults  // Places with geometry IDs
- * });
- * // Result includes both place properties and polygon boundaries
- * ```
- *
- * @see [Geometry Data API Documentation](https://docs.tomtom.com/search-api/documentation/additional-data-service/additional-data)
- * @see [Places Quickstart Guide](https://docs.tomtom.com/maps-sdk-js/guides/services/places/quickstart)
- * @see [Geometry Data Guide](https://docs.tomtom.com/maps-sdk-js/guides/services/places/geometry-data)
- *
- * @group Geometry
- */
-export declare function geometryData(params: GeometryDataParams): Promise<PolygonFeatures>;
-export declare function geometryData(params: GeometryPlaceParams): Promise<PolygonFeatures<CommonPlaceProps>>;
-//#endregion
-//#region src/geometry-search/types/geometrySearchRequestAPI.d.ts
-/**
- * @ignore
- */
-type PolygonAPI = {
-  type: 'POLYGON';
-  vertices: string[];
-};
-/**
- * @ignore
- */
-type CircleAPI = {
-  type: 'CIRCLE';
-  position: string;
-  radius: number;
-};
-/**
- * @ignore
- */
-type GeometryAPI = PolygonAPI | CircleAPI;
-/**
- * @ignore
- */
-type GeometrySearchPayloadAPI = {
-  geometryList: GeometryAPI[];
-};
-/**
- * Geometry search request type.
- * @ignore
- */
-type GeometrySearchRequestAPI = PostObject<GeometrySearchPayloadAPI>;
-//#endregion
-//#region src/geometry-search/types/geometrySearchResponseAPI.d.ts
-/**
- * @ignore
- */
-type GeometrySearchResultAPI = CommonSearchPlaceResultAPI;
-/**
- * @ignore
- */
-type GeometrySearchResponseAPI = {
-  /**
-   * Summary information about the search that was performed.
-   */
-  summary: SummaryAPI$1;
-  /**
-   * The result list, sorted in descending order by score.
-   */
-  results: GeometrySearchResultAPI[];
-};
-//#endregion
-//#region src/geometry-search/types/geometrySearchParams.d.ts
-/**
- * Parameters for searching places within specific geographic areas (geometry search).
- *
- * Geometry search finds places that fall within or near the boundaries of one or more
- * geometric shapes (polygons, circles, or multipolygons). This enables area-based searches
- * like "restaurants in this neighborhood" or "hotels within these city boundaries".
- *
- * @remarks
- * Pass these to {@link discoverPlaces}, which selects the request variant from the params it is given:
- * a `route` property dispatches to along-route search, a `geometries` property to geometry search,
- * and neither to fuzzy search. There is no separate exported function for geometry search.
- *
- * **Key Features:**
- * - Search within multiple geometries simultaneously
- * - Supports polygons, multipolygons, and circles
- * - Can use geometries from previous search results
- * - Combines with text queries for filtered results
- *
- * **Use Cases:**
- * - Find POIs within administrative boundaries
- * - Search within custom drawn areas on map
- * - Filter results to specific neighborhoods or regions
- * - Proximity searches using circles
- *
- * @example
- * ```typescript
- * // Search within a circular area
- * const results = await discoverPlaces({
- *   key: 'your-api-key',
- *   query: 'restaurant',
- *   geometries: [{
- *     type: 'Circle',
- *     coordinates: [4.9041, 52.3676],
- *     radius: 1000  // meters
- *   }]
- * });
- * ```
- *
- * @example
- * ```typescript
- * // Search within a polygon
- * const results = await discoverPlaces({
- *   key: 'your-api-key',
- *   query: 'parking',
- *   geometries: [{
- *     type: 'Polygon',
- *     coordinates: [[
- *       [4.88, 52.36],
- *       [4.90, 52.36],
- *       [4.90, 52.38],
- *       [4.88, 52.38],
- *       [4.88, 52.36]
- *     ]]
- *   }]
- * });
- * ```
- *
- * @group Places Search
- */
-type GeometrySearchParams = CommonSearchParams<GeometrySearchRequestAPI, GeometrySearchResponseAPI> & {
-  /**
-   * List of geometries to search within.
-   *
-   * Can be a mix of polygons, multipolygons, circles, or geometry feature collections
-   * from previous search results. Places that fall within or near these geometries
-   * will be returned.
-   *
-   * @remarks
-   * Also referred to as "geometryList" in API documentation.
-   *
-   * **Supported Types:**
-   * - {@link Circle} - Circular search area with radius
-   * - `Polygon` - Custom polygon boundary (GeoJSON)
-   * - `MultiPolygon` - Multiple polygon areas (GeoJSON)
-   * - `PolygonFeatures` - Feature collection with polygon geometries
-   *
-   * @example
-   * ```typescript
-   * // Multiple geometries
-   * geometries: [
-   *   { type: 'Circle', coordinates: [4.9, 52.3], radius: 500 },
-   *   { type: 'Polygon', coordinates: [[...]] }
-   * ]
-   * ```
-   */
-  geometries: SearchGeometryInput[];
-};
-/**
- * Circular search geometry (non-standard GeoJSON extension).
- *
- * Defines a circular search area by center point and radius. This is a convenience
- * type since standard GeoJSON does not include circles.
- *
- * @remarks
- * **Note:** This is not part of the official GeoJSON specification. It's a Maps SDK
- * extension that gets converted to the appropriate API format internally.
- *
- * **Coordinate Format:** `[longitude, latitude]` (standard GeoJSON order)
- *
- * @example
- * ```typescript
- * const circle: Circle = {
- *   type: 'Circle',
- *   coordinates: [4.9041, 52.3676],  // Amsterdam center
- *   radius: 2000  // 2km radius
- * };
- * ```
- *
- * @group Places Search
- */
-interface Circle {
-  /**
-   * Geometry type identifier.
-   * Must be the literal string `'Circle'`.
-   */
-  type: 'Circle';
-  /**
-   * Center point of the circle in `[longitude, latitude]` format.
-   *
-   * @example [4.9041, 52.3676]
-   */
-  coordinates: Position;
-  /**
-   * Radius of the circle in meters.
-   *
-   * @remarks
-   * Defines the search area around the center point. Places within or near
-   * this radius will be included in results.
-   *
-   * @example 1000 // 1 kilometer
-   */
-  radius: number;
-}
-/**
- * Union type of all supported geometry search input formats.
- *
- * Accepts standard GeoJSON polygons/multipolygons, custom circles, or polygon
- * feature collections (such as those returned from previous searches or the
- * geometry data service).
- *
+ * Accepts either geometry IDs directly or places containing geometry IDs.
+ *
  * @remarks
- * **Flexibility:**
- * - Mix different geometry types in a single search
- * - Use results from {@link geometryData} directly
- * - Pass search results with geometries as boundaries
- * - Define custom polygons for precise area searches
+ * **Choose the right type:**
+ * - {@link GeometryDataParams}: When you have geometry IDs as strings
+ * - {@link GeometryPlaceParams}: When you have place objects from search
  *
  * @example
  * ```typescript
- * // Using different geometry types
- * const geometries: SearchGeometryInput[] = [
- *   // Circle
- *   { type: 'Circle', coordinates: [4.9, 52.3], radius: 1000 },
- *
- *   // Polygon
- *   {
- *     type: 'Polygon',
- *     coordinates: [[
- *       [4.88, 52.36], [4.90, 52.36], [4.90, 52.38], [4.88, 52.38], [4.88, 52.36]
- *     ]]
- *   },
+ * // Using IDs
+ * const idParams: GeometryParams = {
+ *   key: 'your-api-key',
+ *   geometries: ['g1234567890']
+ * };
  *
- *   // From previous geometry data call
- *   cityBoundaries  // PolygonFeatures
- * ];
+ * // Using places
+ * const placeParams: GeometryParams = {
+ *   key: 'your-api-key',
+ *   geometries: searchResults
+ * };
  * ```
  *
- * @group Places Search
+ * @group Geometry
  */
-type SearchGeometryInput = Polygon | MultiPolygon | Circle | PolygonFeatures;
+type GeometryParams = GeometryDataParams | GeometryPlaceParams;
 //#endregion
-//#region src/geometry-search/types/geometrySearchResponse.d.ts
+//#region src/geometry-data/geometryData.d.ts
 /**
- * Response from a geometry search query.
+ * Retrieve polygon geometries representing geographic area boundaries.
  *
- * Contains places found within or along a specified geometry (polygon or circle),
- * along with summary information about the search results.
+ * The Geometry Data service returns coordinate sets that define the outlines of
+ * geographic areas such as cities, countries, administrative regions, or POI footprints.
+ * These polygons enable visualization of area boundaries, spatial analysis, and
+ * geofencing applications.
  *
  * @remarks
- * **Use Cases:**
- * - Find POIs within a delivery zone
- * - Search along a route corridor
- * - Discover places within a custom boundary
- * - Find facilities within a service area
- * - Search within administrative boundaries
- *
- * **Supported Geometries:**
- * - Polygon: Search within a multi-sided boundary
- * - Circle: Search within a radius around a point
+ * Key features:
+ * - **Batch requests**: Fetch up to 20 geometries in a single call
+ * - **Multiple scales**: From countries down to building footprints
+ * - **Place integration**: Can merge with place data for enriched results
+ * - **Standard GeoJSON**: Returns standard Polygon/MultiPolygon features
  *
- * @example
- * ```typescript
- * const response: GeometrySearchResponse = {
- *   type: 'FeatureCollection',
- *   features: [
- *     {
- *       type: 'Feature',
- *       geometry: { type: 'Point', coordinates: [4.9, 52.3] },
- *       properties: {
- *         type: 'POI',
- *         poi: { name: 'Restaurant', categories: ['RESTAURANT'] },
- *         address: { streetName: 'Main Street' },
- *         score: 0.95
- *       }
- *     }
- *   ],
- *   summary: {
- *     numResults: 1,
- *     query: 'restaurant',
- *     queryTime: 45
- *   }
- * };
- * ```
+ * Common use cases:
+ * - Display city or country boundaries on maps
+ * - Show POI building footprints
+ * - Create geofences for spatial queries
+ * - Visualize administrative divisions
+ * - Calculate areas and spatial relationships
  *
- * @group Geometry Search
- */
-type GeometrySearchResponse = Places<SearchPlaceProps, GeometrySearchFeatureCollectionProps>;
-/**
- * Properties attached to the geometry search feature collection.
+ * Returns polygons, not places. Pass the result to `GeometriesModule.show()`,
+ * not `PlacesModule.show()`. The `geometryId` comes from a prior search result.
  *
- * Contains summary information about the search operation and its results.
+ * @param params - Geometry parameters with IDs or places to fetch boundaries for
  *
- * @remarks
- * Provides metadata about:
- * - Number of results found
- * - Query that was executed
- * - Performance metrics
- * - Fuzzy matching level applied
+ * @returns Promise resolving to polygon features representing area boundaries
  *
  * @example
  * ```typescript
- * const collectionProps: GeometrySearchFeatureCollectionProps = {
- *   numResults: 25,
- *   query: 'coffee shop',
- *   queryTime: 123,
- *   fuzzyLevel: 1
- * };
+ * // Fetch geometry by ID
+ * const cityBoundary = await geometryData({
+ *   key: 'your-api-key',
+ *   geometries: ['geometry-id-123']
+ * });
+ *
+ * // Fetch multiple geometries at once
+ * const boundaries = await geometryData({
+ *   key: 'your-api-key',
+ *   geometries: ['country-id-1', 'city-id-2', 'poi-id-3']
+ * });
+ *
+ * // Fetch and merge with place data
+ * const searchResults = await discoverPlaces({ query: 'Amsterdam' });
+ * const withBoundaries = await geometryData({
+ *   key: 'your-api-key',
+ *   geometries: searchResults  // Places with geometry IDs
+ * });
+ * // Result includes both place properties and polygon boundaries
  * ```
  *
- * @group Geometry Search
+ * @see [Geometry Data API Documentation](https://docs.tomtom.com/search-api/documentation/additional-data-service/additional-data)
+ * @see [Places Quickstart Guide](https://docs.tomtom.com/maps-sdk-js/guides/services/places/quickstart)
+ * @see [Geometry Data Guide](https://docs.tomtom.com/maps-sdk-js/guides/services/places/geometry-data)
+ *
+ * @group Geometry
  */
-type GeometrySearchFeatureCollectionProps = SearchSummary;
+export declare function geometryData(params: GeometryDataParams): Promise<PolygonFeatures>;
+export declare function geometryData(params: GeometryPlaceParams): Promise<PolygonFeatures<CommonPlaceProps>>;
 //#endregion
 //#region src/place-details/types/placeDetailsResponseAPI.d.ts
 /**
@@ -4534,34 +4011,10 @@ type PlaceDetailsOptionalParams = {
    */
   mapcodes?: MapcodeType[];
   /**
-   * Geopolitical view context for disputed territories.
-   *
-   * @remarks
-   * Determines how disputed territories are handled in the response.
-   *
-   * **Available Views:**
-   * - `Unified`: International view (default)
-   * - `AR`: Argentina
-   * - `IN`: India
-   * - `PK`: Pakistan
-   * - `IL`: Israel
-   * - `MA`: Morocco
-   * - `RU`: Russia
-   * - `TR`: Turkey
-   * - `CN`: China
-   * - `TW`: Taiwan
-   * - `RS`: Serbia
-   *
-   * `MA` is accepted by this type but is not supported by the current backend.
-   *
-   * @default 'Unified'
-   *
-   * @example
-   * ```typescript
-   * view: 'IN'  // Indian geopolitical view
-   * ```
+   * Geopolitical view of the result, overriding the global one: which country a place in a
+   * disputed territory belongs to. See {@link GeopoliticalView}.
    */
-  view?: View;
+  geopoliticalView?: GeopoliticalView;
   /**
    * Include opening hours information in the response.
    *
@@ -4776,18 +4229,17 @@ type PoiCategoriesResponseAPI = {
  */
 type POICategoriesParams = CommonServiceParams<GetObject, PoiCategoriesResponseAPI> & {
   /**
-   * One or more filter strings applied client-side against the text index.
-   *
-   * Each filter string is normalized (lowercased, spaces removed) and matched against
-   * the normalized form of every `name` and synonym. A category matches when any of its
-   * normalized texts contains the normalized filter as a substring.
+   * Keywords matched client-side against every category's name and synonyms, strongest match first.
    *
-   * For example, `'gym'` matches a category whose name or synonym normalizes to `'gym'`
-   * or `'fitnessandgym'`. `'italian restaurant'` normalizes to `'italianrestaurant'` and
-   * matches `'Italian Restaurant'` but not `'Mexican Restaurant'`.
+   * - A category code (`'CAFE'`) matches that category only. Any other filter ranks an exact name or
+   *   synonym first, then a name or synonym the filter starts, one holding it as a later word, and
+   *   last one holding it as a substring. Each filter keeps only the matches ranking close to its best.
+   * - Case, accents and punctuation are ignored, and spaces too in the substring tiers: `'bar'` finds
+   *   Bar but not Nail Salon ("Nail Bar"), and `'bookstore'` finds Book Shop ("Book Store").
+   * - Several filters merge round-robin, so each filter's best match comes first, one entry per `code`.
+   *   A category ranking below its matched parent is left out, as the parent already covers it.
    *
-   * Results from all filter strings are merged and deduplicated by `code`.
-   * Omit to return all categories.
+   * A blank filter matches nothing. Omit `filters` to return all categories.
    *
    * @example
    * ```ts
@@ -4803,6 +4255,13 @@ type POICategoriesParams = CommonServiceParams<GetObject, PoiCategoriesResponseA
    */
   filters?: string[];
 };
+/**
+ * Parameters for `resolvePOICategories`: the {@link POICategoriesParams}, with the words to resolve
+ * required in `filters`.
+ *
+ * @group POI Categories
+ */
+type ResolvePOICategoriesParams = POICategoriesParams & Required<Pick<POICategoriesParams, 'filters'>>;
 //#endregion
 //#region src/poi-categories/types/poiCategoriesResponse.d.ts
 /**
@@ -4819,11 +4278,7 @@ type POICategoryResult = {
    */
   code: POICategory;
   /**
-   * Codes of sub-categories that also matched the current filter result set.
-   *
-   * Only contains codes present in the filtered result set — not the full list of
-   * possible sub-categories — so you can understand the category hierarchy without
-   * additional lookups.
+   * Codes of this category's sub-categories, whether or not they matched the `filters`.
    *
    * Use these values directly in a search's `filters.poiCategories`.
    */
@@ -4845,6 +4300,17 @@ type POICategoryResult = {
 type POICategoriesResponse = {
   poiCategories: POICategoryResult[];
 };
+/**
+ * What `resolvePOICategories` returns.
+ *
+ * @group POI Categories
+ */
+type ResolvedPOICategories = {
+  /** The codes for a search's `filters.poiCategories`, best first. Empty when no filter matched. */
+  poiCategories: POICategory[];
+  /** The filters no category name, synonym or code matched, as given. */
+  unmatched: string[];
+};
 //#endregion
 //#region src/poi-categories/poiCategories.d.ts
 /**
@@ -4866,7 +4332,7 @@ type POICategoriesResponse = {
  * // All categories
  * const { poiCategories: all } = await getPOICategories();
  *
- * // Filtered by keyword, merged and deduplicated
+ * // Filtered by keyword, best match first
  * const { poiCategories: gyms } = await getPOICategories({ filters: ['gym'] });
  * gyms.forEach(c => console.log(c.code, c.name, c.childCategoryCodes));
  * ```
@@ -4899,6 +4365,26 @@ export declare const getPOICategories: (params?: POICategoriesParams) => Promise
  * @group POI Categories
  */
 export declare const getPOICategoryCodes: (params?: POICategoriesParams) => Promise<POICategory[]>;
+/**
+ * Resolves category words, or codes, to the POI categories of one search, and reports the words that
+ * match none.
+ *
+ * @remarks
+ * Each filter matches as on {@link getPOICategories}, so a code stays itself. Each keeps its best three
+ * codes, merged round-robin and capped at the 10 a search accepts. Codes alone skip the catalog request.
+ * `discoverPlaces` runs the same lookup for `filters.poiCategoryQuery`: call this first to decide what to
+ * do about the words that match nothing. To browse every close match instead, use {@link getPOICategories}.
+ *
+ * @example
+ * ```typescript
+ * const { poiCategories, unmatched } = await resolvePOICategories({ filters: ['café', 'PHARMACY', 'xyzzy'] });
+ * // unmatched: ['xyzzy']
+ * const places = await discoverPlaces({ filters: { poiCategories }, geoBias: { position: [4.9041, 52.3676] } });
+ * ```
+ *
+ * @group POI Categories
+ */
+export declare const resolvePOICategories: (parameters: ResolvePOICategoriesParams) => Promise<ResolvedPOICategories>;
 //#endregion
 //#region src/shared/types/apiRoutingRequestTypes.d.ts
 /**
@@ -5696,11 +5182,18 @@ export declare const calculateReachableRange: (params: ReachableRangeParams) =>
  * Note: Ranges are calculated sequentially to avoid rate limiting. For large batches,
  * consider implementing your own parallel processing with appropriate throttling.
  *
+ * **A range the service answers with an error is skipped, not thrown**, unless that error is a 401,
+ * 403 or 429: an origin off the drivable road network answers `NO_RANGE_FOUND`, which
+ * {@link calculateReachableRange} rejects with. So `features` can be shorter than `paramsArray`, or
+ * empty; each feature's `properties` carries the request it answers. An abort and an invalid request
+ * still reject the whole batch.
+ *
  * @param paramsArray Array of reachable range parameters, one for each area to calculate
  * @param options.signal An `AbortSignal` to cancel the in-flight request and skip the remaining ones.
  *   Composed with any per-entry `signal`, so either one cancels.
  *
- * @returns Promise resolving to a FeatureCollection of reachable area polygons
+ * @returns Promise resolving to a FeatureCollection with a polygon per range the service could
+ *   calculate, in request order
  *
  * @example
  * ```typescript
@@ -5875,29 +5368,10 @@ type ReverseGeocodingOptionalParams = {
    */
   radiusMeters?: number;
   /**
-   * Specifies the geopolitical view for the results.
-   *
-   * @remarks
-   * Determines how disputed territories and borders are represented in the response.
-   *
-   * Available views:
-   * - `Unified` - International view (default)
-   * - `AR` - Argentina
-   * - `CN` - China
-   * - `IL` - Israel
-   * - `IN` - India
-   * - `MA` - Morocco
-   * - `PK` - Pakistan
-   * - `RS` - Serbia
-   * - `RU` - Russia
-   * - `TR` - Turkey
-   * - `TW` - Taiwan
-   *
-   * `MA` is accepted by this type but is not supported by the current backend.
-   *
-   * @defaultValue `"Unified"`
+   * Geopolitical view of the result, overriding the global one: which country an address in a
+   * disputed territory belongs to. See {@link GeopoliticalView}.
    */
-  view?: View;
+  geopoliticalView?: GeopoliticalView;
 };
 /**
  * Complete parameter set for reverse geocoding service calls.
@@ -6600,37 +6074,152 @@ type RouteStopOptions = {
   legCostModel?: LegCostModel;
 };
 //#endregion
-//#region src/fuzzy-search/types/fuzzySearchResponse.d.ts
+//#region src/along-route-search/types/alongRouteSearchRequestAPI.d.ts
+/**
+ * @ignore
+ */
+type RoutePointAPI = {
+  lat: number;
+  lon: number;
+};
+/**
+ * @ignore
+ */
+type AlongRouteSearchPayloadAPI = {
+  route: {
+    points: RoutePointAPI[];
+  };
+};
+/**
+ * Along-route search request type.
+ * @ignore
+ */
+type AlongRouteSearchRequestAPI = PostObject<AlongRouteSearchPayloadAPI>;
+//#endregion
+//#region src/along-route-search/types/alongRouteSearchResponseAPI.d.ts
 /**
- * Response from the fuzzy search service.
+ * @ignore
+ */
+type AlongRouteSearchResultAPI = CommonSearchPlaceResultAPI;
+/**
+ * @ignore
+ */
+type AlongRouteSearchResponseAPI = {
+  /**
+   * Summary information about the search that was performed.
+   */
+  summary: SummaryAPI$1;
+  /**
+   * The result list, sorted by detour time or offset.
+   */
+  results: AlongRouteSearchResultAPI[];
+};
+//#endregion
+//#region src/along-route-search/types/alongRouteSearchParams.d.ts
+/**
+ * Result sorting order for along-route search.
  *
- * Collection of places matching the search query, with additional metadata
- * about detected query intents (coordinates, nearby searches, what3words, bookmarks).
+ * Controls how the returned POIs are ordered relative to the route.
  *
- * @group Fuzzy Search
+ * @remarks
+ * Pass these to {@link discoverPlaces}, which selects the request variant from the params it is given:
+ * a `route` property dispatches to along-route search, a `geometries` property to geometry search,
+ * and neither to fuzzy search.
+ *
+ * - `detourTime`: Sort by additional travel time required to visit the POI (default)
+ * - `detourOffset`: Sort by how far along the route the detour point falls
+ *
+ * @group Along Route Search
  */
-type FuzzySearchResponse = Places<SearchPlaceProps, FuzzySearchFeatureCollectionProps>;
+type AlongRouteSortBy = 'detourTime' | 'detourOffset';
 /**
- * Additional properties for fuzzy search feature collection.
+ * Parameters for searching places along a route.
  *
- * Extends the base search summary with detected query intents that provide
- * insight into how the search engine interpreted the user's query.
+ * Along-route search finds POIs near a provided route geometry and ranks them
+ * by the detour cost (time or distance offset) required to visit them.
  *
- * @group Fuzzy Search
+ * @remarks
+ * **Key Features:**
+ * - Search for POIs within a detour budget from the route
+ * - Sort results by detour time or route offset
+ * - Combine with POI category and brand filters
+ * - Use directly with a {@link calculateRoute} result
+ *
+ * **Use Cases:**
+ * - Find fuel stations or EV chargers along a trip
+ * - Locate rest stops or restaurants near a route
+ * - Surface services reachable within a time budget
+ *
+ * @example
+ * ```typescript
+ * // Find coffee shops within a 5-minute detour from a route
+ * const results = await discoverPlaces({
+ *   route: routeResult.features[0],
+ *   maxDetourTimeSeconds: 300,
+ *   query: 'coffee',
+ * });
+ *
+ * // Find EV charging stations using a plain coordinate array
+ * const chargers = await discoverPlaces({
+ *   route: [[4.9, 52.37], [4.95, 52.28], [5.1, 52.09]],
+ *   maxDetourTimeSeconds: 600,
+ *   filters: { poiCategories: ['CHARGING_LOCATION'] },
+ *   sortBy: 'detourOffset',
+ * });
+ * ```
+ *
+ * @group Along Route Search
  */
-type FuzzySearchFeatureCollectionProps = SearchSummary & {
+type AlongRouteSearchParams = CommonSearchParams<AlongRouteSearchRequestAPI, AlongRouteSearchResponseAPI> & {
+  /**
+   * Route geometry to search along.
+   *
+   * Accepts any of three forms:
+   * - **`Route`** feature as returned by {@link calculateRoute} (most common)
+   * - **`LineString`** GeoJSON geometry object
+   * - **`Position[]`** — a plain array of `[longitude, latitude]` coordinate pairs
+   *
+   * Coordinates must always be in `[longitude, latitude]` order.
+   *
+   * @example
+   * ```typescript
+   * // Route Feature from calculateRoute (most common)
+   * route: routeResult.features[0]
+   *
+   * // GeoJSON LineString geometry
+   * route: routeResult.features[0].geometry
+   *
+   * // Plain coordinate array
+   * route: [[4.9, 52.37], [4.95, 52.28], [5.1, 52.09]]
+   * ```
+   */
+  route: LineString | Route | Position[];
+  /**
+   * Maximum allowed detour time in seconds.
+   *
+   * Only POIs reachable within this additional travel time from the route
+   * will be returned. Controls the width of the search corridor.
+   *
+   * @example
+   * ```typescript
+   * maxDetourTimeSeconds: 300  // 5-minute detour budget
+   * ```
+   */
+  maxDetourTimeSeconds: number;
   /**
-   * Array of detected query intents.
+   * Sort order for the results.
    *
-   * Indicates how the search engine interpreted the query
-   * (e.g., as coordinates, nearby search, what3words, or bookmark).
+   * @default 'detourTime'
    *
-   * @remarks
-   * Optional — query-intent detection is not guaranteed, so guard it rather than assuming it is
-   * present.
+   * @example
+   * ```typescript
+   * sortBy: 'detourOffset'  // order by position along the route
+   * ```
    */
-  queryIntent?: QueryIntent[];
+  sortBy?: AlongRouteSortBy;
 };
+//#endregion
+//#region src/fuzzy-search/types/fuzzySearchResponse.d.ts
 /**
  * Union type for all possible query intents.
  *
@@ -6888,7 +6477,7 @@ type NearbyIntentDetailsAPI = Omit<NearbyIntentDetails, 'position'> & {
  * @remarks
  * Pass these to {@link discoverPlaces}, which selects the request variant from the params it is given:
  * a `route` property dispatches to along-route search, a `geometries` property to geometry search,
- * and neither to fuzzy search. There is no separate exported function for fuzzy search.
+ * and neither to fuzzy search.
  *
  * **Key Features:**
  * - Tolerates typos and spelling mistakes
@@ -6907,14 +6496,12 @@ type NearbyIntentDetailsAPI = Omit<NearbyIntentDetails, 'position'> & {
  * ```typescript
  * // Basic fuzzy search
  * const params: FuzzySearchParams = {
- *   key: 'your-api-key',
  *   query: 'pizz',  // Will find "pizza" restaurants
  *   geoBias: { position: [4.9041, 52.3676] }
  * };
  *
  * // Fuzzy search with custom fuzziness
  * const customParams: FuzzySearchParams = {
- *   key: 'your-api-key',
  *   query: 'restaurnt',  // Misspelled "restaurant"
  *   minFuzzyLevel: 1,
  *   maxFuzzyLevel: 3,
@@ -6979,20 +6566,272 @@ type FuzzySearchParams = CommonSearchParams<GetObject, FuzzySearchResponseAPI> &
   maxFuzzyLevel?: number;
 };
 //#endregion
+//#region src/geometry-search/types/geometrySearchRequestAPI.d.ts
+/**
+ * @ignore
+ */
+type PolygonAPI = {
+  type: 'POLYGON';
+  vertices: string[];
+};
+/**
+ * @ignore
+ */
+type CircleAPI = {
+  type: 'CIRCLE';
+  position: string;
+  radius: number;
+};
+/**
+ * @ignore
+ */
+type GeometryAPI = PolygonAPI | CircleAPI;
+/**
+ * @ignore
+ */
+type GeometrySearchPayloadAPI = {
+  geometryList: GeometryAPI[];
+};
+/**
+ * Geometry search request type.
+ * @ignore
+ */
+type GeometrySearchRequestAPI = PostObject<GeometrySearchPayloadAPI>;
+//#endregion
+//#region src/geometry-search/types/geometrySearchResponseAPI.d.ts
+/**
+ * @ignore
+ */
+type GeometrySearchResultAPI = CommonSearchPlaceResultAPI;
+/**
+ * @ignore
+ */
+type GeometrySearchResponseAPI = {
+  /**
+   * Summary information about the search that was performed.
+   */
+  summary: SummaryAPI$1;
+  /**
+   * The result list, sorted in descending order by score.
+   */
+  results: GeometrySearchResultAPI[];
+};
+//#endregion
+//#region src/geometry-search/types/geometrySearchParams.d.ts
+/**
+ * Parameters for searching places within specific geographic areas (geometry search).
+ *
+ * Geometry search finds places that fall within or near the boundaries of one or more
+ * geometric shapes (polygons, circles, or multipolygons). This enables area-based searches
+ * like "restaurants in this neighborhood" or "hotels within these city boundaries".
+ *
+ * @remarks
+ * Pass these to {@link discoverPlaces}, which selects the request variant from the params it is given:
+ * a `route` property dispatches to along-route search, a `geometries` property to geometry search,
+ * and neither to fuzzy search.
+ *
+ * **Key Features:**
+ * - Search within multiple geometries simultaneously
+ * - Supports polygons, multipolygons, and circles
+ * - Can use geometries from previous search results
+ * - Combines with text queries for filtered results
+ *
+ * **Use Cases:**
+ * - Find POIs within administrative boundaries
+ * - Search within custom drawn areas on map
+ * - Filter results to specific neighborhoods or regions
+ * - Proximity searches using circles
+ *
+ * @example
+ * ```typescript
+ * // Search within a circular area
+ * const results = await discoverPlaces({
+ *   query: 'restaurant',
+ *   geometries: [{
+ *     type: 'Circle',
+ *     coordinates: [4.9041, 52.3676],
+ *     radius: 1000  // meters
+ *   }]
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Search within a polygon
+ * const results = await discoverPlaces({
+ *   query: 'parking',
+ *   geometries: [{
+ *     type: 'Polygon',
+ *     coordinates: [[
+ *       [4.88, 52.36],
+ *       [4.90, 52.36],
+ *       [4.90, 52.38],
+ *       [4.88, 52.38],
+ *       [4.88, 52.36]
+ *     ]]
+ *   }]
+ * });
+ * ```
+ *
+ * @group Places Search
+ */
+type GeometrySearchParams = CommonSearchParams<GeometrySearchRequestAPI, GeometrySearchResponseAPI> & {
+  /**
+   * List of geometries to search within.
+   *
+   * Can be a mix of polygons, multipolygons, circles, or geometry feature collections
+   * from previous search results. Places that fall within or near these geometries
+   * will be returned.
+   *
+   * @remarks
+   * Also referred to as "geometryList" in API documentation.
+   *
+   * **Supported Types:**
+   * - {@link Circle} - Circular search area with radius
+   * - `Polygon` - Custom polygon boundary (GeoJSON)
+   * - `MultiPolygon` - Multiple polygon areas (GeoJSON)
+   * - `PolygonFeatures` - Feature collection with polygon geometries
+   *
+   * @example
+   * ```typescript
+   * // Multiple geometries
+   * geometries: [
+   *   { type: 'Circle', coordinates: [4.9, 52.3], radius: 500 },
+   *   { type: 'Polygon', coordinates: [[...]] }
+   * ]
+   * ```
+   */
+  geometries: SearchGeometryInput[];
+};
+/**
+ * Circular search geometry (non-standard GeoJSON extension).
+ *
+ * Defines a circular search area by center point and radius. This is a convenience
+ * type since standard GeoJSON does not include circles.
+ *
+ * @remarks
+ * **Note:** This is not part of the official GeoJSON specification. It's a Maps SDK
+ * extension that gets converted to the appropriate API format internally.
+ *
+ * **Coordinate Format:** `[longitude, latitude]` (standard GeoJSON order)
+ *
+ * @example
+ * ```typescript
+ * const circle: Circle = {
+ *   type: 'Circle',
+ *   coordinates: [4.9041, 52.3676],  // Amsterdam center
+ *   radius: 2000  // 2km radius
+ * };
+ * ```
+ *
+ * @group Places Search
+ */
+interface Circle {
+  /**
+   * Geometry type identifier.
+   * Must be the literal string `'Circle'`.
+   */
+  type: 'Circle';
+  /**
+   * Center point of the circle in `[longitude, latitude]` format.
+   *
+   * @example [4.9041, 52.3676]
+   */
+  coordinates: Position;
+  /**
+   * Radius of the circle in meters.
+   *
+   * @remarks
+   * Defines the search area around the center point. Places within or near
+   * this radius will be included in results.
+   *
+   * @example 1000 // 1 kilometer
+   */
+  radius: number;
+}
+/**
+ * Union type of all supported geometry search input formats.
+ *
+ * Accepts standard GeoJSON polygons/multipolygons, custom circles, or polygon
+ * feature collections (such as those returned from previous searches or the
+ * geometry data service).
+ *
+ * @remarks
+ * **Flexibility:**
+ * - Mix different geometry types in a single search
+ * - Use results from {@link geometryData} directly
+ * - Pass search results with geometries as boundaries
+ * - Define custom polygons for precise area searches
+ *
+ * @example
+ * ```typescript
+ * // Using different geometry types
+ * const geometries: SearchGeometryInput[] = [
+ *   // Circle
+ *   { type: 'Circle', coordinates: [4.9, 52.3], radius: 1000 },
+ *
+ *   // Polygon
+ *   {
+ *     type: 'Polygon',
+ *     coordinates: [[
+ *       [4.88, 52.36], [4.90, 52.36], [4.90, 52.38], [4.88, 52.38], [4.88, 52.36]
+ *     ]]
+ *   },
+ *
+ *   // From previous geometry data call
+ *   cityBoundaries  // PolygonFeatures
+ * ];
+ * ```
+ *
+ * @group Places Search
+ */
+type SearchGeometryInput = Polygon | MultiPolygon | Circle | PolygonFeatures;
+//#endregion
 //#region src/search/discoverPlaces.d.ts
 type SearchFeatureCollectionProps = SearchSummary & {
   queryIntent?: QueryIntent[];
 };
 /** The keys of `Params` that `Base` lacks, each forbidden. */
 type Without<Params, Base> = { [Key in Exclude<keyof Params, keyof Base>]?: never; };
+/**
+ * What {@link discoverPlaces} adds to its search variant's `filters`: the POI categories as codes in
+ * `poiCategories`, or in words with `poiCategoryQuery`, never both.
+ *
+ * @group Places Search
+ */
+export type DiscoverPlacesCategoryFilters = {
+  poiCategoryQuery?: never;
+} | {
+  /**
+   * Categories in words — `'sushi'`, `['gym', 'ev charging']` — kept as the POI categories they name.
+   *
+   * @remarks
+   * Resolved with {@link resolvePOICategories} in the call's `language`, whose codes become the search's
+   * `poiCategories`. The category list costs one request per language and session. A word nothing
+   * matches is left out; when none matches, the call rejects with {@link SDKError} and sends no search.
+   *
+   * @example
+   * ```typescript
+   * const sushi = await discoverPlaces({
+   *     filters: { poiCategoryQuery: 'sushi' },
+   *     geoBias: { position: [4.9041, 52.3676] },
+   * });
+   * ```
+   */
+  poiCategoryQuery: string | string[];
+  poiCategories?: never;
+};
 /**
  * What {@link discoverPlaces} takes: one search variant's params, with the other variants' own
- * options forbidden. So `{ geometries, cursor }` is a compile error rather than a cursor silently
- * dropped, as it would be with a plain union.
+ * options forbidden, and {@link DiscoverPlacesCategoryFilters} added to `filters`. So
+ * `{ geometries, cursor }` is a compile error rather than a cursor silently dropped, as it would be
+ * with a plain union.
  *
  * @group Places Search
  */
-export type DiscoverPlacesParams = (FuzzySearchParams & Without<GeometrySearchParams, FuzzySearchParams> & Without<AlongRouteSearchParams, FuzzySearchParams>) | (GeometrySearchParams & Without<FuzzySearchParams, GeometrySearchParams> & Without<AlongRouteSearchParams, GeometrySearchParams> & {
+export type DiscoverPlacesParams = {
+  filters?: DiscoverPlacesCategoryFilters;
+} & ((FuzzySearchParams & Without<GeometrySearchParams, FuzzySearchParams> & Without<AlongRouteSearchParams, FuzzySearchParams>) | (GeometrySearchParams & Without<FuzzySearchParams, GeometrySearchParams> & Without<AlongRouteSearchParams, GeometrySearchParams> & {
   filters?: {
     countries?: never;
   };
@@ -7000,7 +6839,7 @@ export type DiscoverPlacesParams = (FuzzySearchParams & Without<GeometrySearchPa
   filters?: {
     countries?: never;
   };
-});
+}));
 /**
  * Search service response containing places that match the query.
  *
@@ -7010,11 +6849,12 @@ export type DiscoverPlacesParams = (FuzzySearchParams & Without<GeometrySearchPa
  */
 export type DiscoverPlacesResponse = Places<SearchPlaceProps, SearchFeatureCollectionProps>;
 /**
- * Universal search function for finding places by text query or within geometries.
+ * Universal search function for finding places by text query, within geometries or along a route.
  *
- * This is a unified interface that automatically routes to either:
- * - **Geometry Search**: When geometries parameter is provided (search within specific areas)
- * - **Fuzzy Search**: When no geometries provided (free-text search)
+ * Runs one of three searches, picked from its params:
+ * - **Along-route search** when `route` is given: places within a detour budget of the route
+ * - **Geometry search** when `geometries` is given: places inside those areas
+ * - **Fuzzy search** otherwise: free text, optionally biased by `geoBias`
  *
  * @remarks
  * The search service provides:
@@ -7051,6 +6891,12 @@ export type DiscoverPlacesResponse = Places<SearchPlaceProps, SearchFeatureColle
  *   filters: { poiCategories: ['ITALIAN_RESTAURANT'] },
  *   geoBias: { position: [4.9041, 52.3676], radiusMeters: 5000 }  // Within 5km
  * });
+ *
+ * // The same, from a category in words
+ * const italian = await discoverPlaces({
+ *   filters: { poiCategoryQuery: 'italian food' },
+ *   geoBias: { position: [4.9041, 52.3676], radiusMeters: 5000 }
+ * });
  * ```
  *
  * @see [Search API Documentation](https://docs.tomtom.com/search-api/documentation/search-service/search-service)
@@ -7220,7 +7066,6 @@ type SearchSuggestionsParams = CommonServiceParams & {
    * measured from.
    */
   origin?: HasLngLat;
-  view?: View;
 };
 /**
  * The result of a {@link getSearchSuggestions} call.
@@ -7770,4 +7615,4 @@ type TrafficIncidentDetailsParams = TrafficIncidentDetailsByBBoxParams | Traffic
  */
 export declare const trafficIncidentDetails: (params: TrafficIncidentDetailsParams) => Promise<TrafficIncidentDetails>;
 //#endregion
-export type { AdditionalDataAPI, AlongRouteSearchParams, AlongRouteSearchPayloadAPI, AlongRouteSearchRequestAPI, AlongRouteSearchResponse, AlongRouteSearchResponseAPI, AlongRouteSearchResultAPI, AlongRouteSortBy, AreaAnalyticsDateInput, ArrivalSide, BookmarkIntent, BookmarkIntentDetails, BrandSuggestion, CalculateRouteParams, CategorySuggestion, ChargingStationsAvailabilityParams, ChargingStopsStrategy, Circle, CircleAPI, CommonServiceParamsWithZoom, ComputeTravelTimeFor, CoordinateIntent, CoordinateIntentAPI, CoordinateIntentDetails, CoordinateIntentDetailsAPI, ExtendedRouteRepresentation, FunctionalRoadClass, FuzzySearchParams, FuzzySearchResponse, FuzzySearchResponseAPI, FuzzySearchResultAPI, GeocodingParams, GeocodingProps, GeocodingResponse, GeometriesInput, GeometryAPI, GeometryDataParams, GeometryDataResponseAPI, GeometryParams, GeometryPlaceParams, GeometrySearchFeatureCollectionProps, GeometrySearchParams, GeometrySearchPayloadAPI, GeometrySearchRequestAPI, GeometrySearchResponse, GeometrySearchResponseAPI, GeometrySearchResultAPI, GuidanceParams, InputSectionType, InputSectionTypes, LegCostModel, MaxNumberOfAlternatives, NearbyIntent, NearbyIntentAPI, NearbyIntentDetails, NearbyIntentDetailsAPI, POICategoriesParams, POICategoriesResponse, POICategoryResult, PlaceDetailsMandatoryParams, PlaceDetailsOptionalParams, PlaceDetailsParams, PlaceDetailsResponse, PlaceDetailsResponseAPI, PlaceDetailsResultAPI, PlaceSuggestion, PoiCategoriesResponseAPI, PoiCategoryAPI, PolygonAPI, QueryIntent, QueryIntentAPI, RefinementSuggestion, ReverseGeocodingMandatoryParams, ReverseGeocodingOptionalParams, ReverseGeocodingParams, RoutePointAPI, RouteStopOptions, SearchGeometryInput, SearchSuggestion, SearchSuggestionKind, SearchSuggestionsParams, SearchSuggestionsResponse, TrafficAreaAnalyticsDateRange, TrafficAreaAnalyticsDays, TrafficAreaAnalyticsParams, TrafficIncidentDetailsByBBoxParams, TrafficIncidentDetailsByIdsParams, TrafficIncidentDetailsByPolygonParams, TrafficIncidentDetailsParams, W3WIntent, W3WIntentDetails, arrivalSides, chargingStopsStrategies, functionalRoadClasses };
+export type { AdditionalDataAPI, AlongRouteSearchParams, AlongRouteSortBy, AreaAnalyticsDateInput, ArrivalSide, BookmarkIntent, BookmarkIntentDetails, BrandSuggestion, CalculateRouteParams, CategorySuggestion, ChargingStationsAvailabilityParams, ChargingStopsStrategy, Circle, CommonServiceParamsWithZoom, ComputeTravelTimeFor, CoordinateIntent, CoordinateIntentDetails, ExtendedRouteRepresentation, FunctionalRoadClass, FuzzySearchParams, GeocodingParams, GeocodingProps, GeocodingResponse, GeometriesInput, GeometryDataParams, GeometryDataResponseAPI, GeometryParams, GeometryPlaceParams, GeometrySearchParams, GuidanceParams, InputSectionType, InputSectionTypes, LegCostModel, MaxNumberOfAlternatives, NearbyIntent, NearbyIntentDetails, POICategoriesParams, POICategoriesResponse, POICategoryResult, PlaceDetailsMandatoryParams, PlaceDetailsOptionalParams, PlaceDetailsParams, PlaceDetailsResponse, PlaceDetailsResponseAPI, PlaceDetailsResultAPI, PlaceSuggestion, PlacesWithEVAvailabilityOptions, PoiCategoriesResponseAPI, PoiCategoryAPI, QueryIntent, RefinementSuggestion, ResolvePOICategoriesParams, ResolvedPOICategories, ReverseGeocodingMandatoryParams, ReverseGeocodingOptionalParams, ReverseGeocodingParams, RouteStopOptions, SearchGeometryInput, SearchSuggestion, SearchSuggestionKind, SearchSuggestionsParams, SearchSuggestionsResponse, TrafficAreaAnalyticsDateRange, TrafficAreaAnalyticsDays, TrafficAreaAnalyticsParams, TrafficIncidentDetailsByBBoxParams, TrafficIncidentDetailsByIdsParams, TrafficIncidentDetailsByPolygonParams, TrafficIncidentDetailsParams, W3WIntent, W3WIntentDetails, arrivalSides, chargingStopsStrategies, functionalRoadClasses };