@tomtom-org/maps-sdk 0.48.2 → 0.49.0

package/services/dist/index.d.ts

@@ -19,16 +19,14 @@ import { GeographyType } from '@tomtom-org/maps-sdk/core';
 import { GeoJSON as GeoJSON_2 } from 'geojson';
 import { GetPositionEntryPointOption } from '@tomtom-org/maps-sdk/core';
 import { GlobalConfig } from '@tomtom-org/maps-sdk/core';
-import { Guidance } from '@tomtom-org/maps-sdk/core';
 import { HasBBox } from '@tomtom-org/maps-sdk/core';
 import { HasLngLat } from '@tomtom-org/maps-sdk/core';
 import { inputSectionTypes } from '@tomtom-org/maps-sdk/core';
 import { Instruction } from '@tomtom-org/maps-sdk/core';
-import { LaneDirection } from '@tomtom-org/maps-sdk/core';
-import { LegSummary } from '@tomtom-org/maps-sdk/core';
 import { LineString } from 'geojson';
 import { Mapcode } from '@tomtom-org/maps-sdk/core';
 import { MapcodeType } from '@tomtom-org/maps-sdk/core';
+import { MultiPoint } from 'geojson';
 import { MultiPolygon } from 'geojson';
 import { OpeningHours } from '@tomtom-org/maps-sdk/core';
 import { OpeningHoursMode } from '@tomtom-org/maps-sdk/core';
@@ -47,19 +45,16 @@ import { PolygonFeature } from '@tomtom-org/maps-sdk/core';
 import { PolygonFeatures } from '@tomtom-org/maps-sdk/core';
 import { PolygonFeatures as PolygonFeatures_2 } from '@tomtom-org/maps-sdk/core';
 import { Position } from 'geojson';
-import { PossibleLaneSeparator } from '@tomtom-org/maps-sdk/core';
 import { RevGeoAddressProps } from '@tomtom-org/maps-sdk/core';
 import { RoadShieldReference } from '@tomtom-org/maps-sdk/core';
 import { Route } from '@tomtom-org/maps-sdk/core';
-import { RoutePathPoint } from '@tomtom-org/maps-sdk/core';
 import { RoutePlanningLocation } from '@tomtom-org/maps-sdk/core';
-import { RouteProgressPoint } from '@tomtom-org/maps-sdk/core';
 import { Routes } from '@tomtom-org/maps-sdk/core';
-import { RouteSummary } from '@tomtom-org/maps-sdk/core';
 import { SearchPlaceProps } from '@tomtom-org/maps-sdk/core';
 import { SearchPlaceProps as SearchPlaceProps_2 } from '@tomtom-org/maps-sdk/core';
 import { SideOfStreet } from '@tomtom-org/maps-sdk/core';
 import { TimeZone } from '@tomtom-org/maps-sdk/core';
+import { TomTomAPIHeaders } from '@tomtom-org/maps-sdk/core';
 import { TomTomHeaders } from '@tomtom-org/maps-sdk/core';
 import { TrafficAreaAnalytics } from '@tomtom-org/maps-sdk/core';
 import { TrafficIncidentDetails } from '@tomtom-org/maps-sdk/core';
@@ -959,11 +954,13 @@ declare type AvoidAreasAPI = {
 };
 
 /**
+ * V3 avoid area rectangle expressed as a GeoJSON Feature with a bbox.
  * @ignore
  */
 declare type AvoidRectangleAPI = {
-    southWestCorner: LatitudeLongitudePointAPI;
-    northEastCorner: LatitudeLongitudePointAPI;
+    type: 'Feature';
+    bbox: [number, number, number, number];
+    geometry: null;
 };
 
 /**
@@ -978,6 +975,15 @@ declare interface BaseAPIResponseErrorBody {
     };
 }
 
+/**
+ * V3 basic section — uses pathIndex instead of pointIndex.
+ * @ignore
+ */
+declare type BasicSectionAPI = {
+    startPathIndex: number;
+    endPathIndex: number;
+};
+
 declare type BatteryCurve = {
     /**
      * Minimum: 0
@@ -1101,6 +1107,7 @@ declare const buildAutocompleteSearchRequest: (params: AutocompleteSearchParams)
 
 /**
  * Default function for building calculate route request from {@link CalculateRouteParams}
+ * targeting the OrbisV3 routing API.
  * @param params The calculate route parameters, with global configuration already merged into them.
  */
 declare const buildCalculateRouteRequest: (params: CalculateRouteParams) => FetchInput<CalculateRoutePOSTDataAPI>;
@@ -1505,9 +1512,12 @@ export declare type CalculateRouteParams = CommonServiceParams<CalculateRouteReq
      * Route section types to include in the response.
      *
      * Sections help you display route characteristics like tolls, ferries, or traffic.
-     * Leg sections are always included regardless of this parameter.
+     * Leg sections are always included regardless of this parameter. A section type is only
+     * present in the response if the route actually traverses it. The `lanes` section is
+     * guidance-only and is returned solely when {@link GuidanceParams | `guidance`} is also
+     * requested.
      *
-     * @default All available section types
+     * @default When omitted, all section types are requested.
      *
      * @example
      * ```typescript
@@ -1542,12 +1552,28 @@ export declare type CalculateRouteParams = CommonServiceParams<CalculateRouteReq
 };
 
 /**
+ * V3 POST body for /routing/routes/calculate and (partially) /routing/calculateLongDistanceEVRoute.
+ * Consumption model parameters are sent as URL query params, not in the POST body.
  * @ignore
  */
 declare type CalculateRoutePOSTDataAPI = {
-    supportingPoints?: LatitudeLongitudePointAPI[];
-    pointWaypoints?: PointWaypointAPI[];
+    routePlanningLocations: RoutePlanningLocationsAPI;
+    path?: LineString;
+    legs?: LegRequestAPI[];
+    routeType?: string;
+    traffic?: string;
+    avoids?: string[];
+    travelMode?: string;
+    maxPathAlternativeRoutes?: number;
+    departureDateTime?: string;
+    arrivalDateTime?: string;
+    vehicleEngineType?: string;
+    vehicleWeightInKilograms?: number;
+    vehicleMaxSpeedInKilometersPerHour?: number;
+    vehicleHeadingInDegrees?: number;
     chargingParameters?: ChargingParametersAPI;
+    guidance?: 'none' | 'instructions';
+    instructionPhonetics?: 'ipa' | 'lhp';
     avoidAreas?: AvoidAreasAPI;
 };
 
@@ -1560,13 +1586,11 @@ declare type CalculateRouteRequestAPI = FetchInput<CalculateRoutePOSTDataAPI>;
  * @ignore
  */
 declare type CalculateRouteResponseAPI = {
-    formatVersion: string;
     routes: RouteAPI[];
-    optimizedWaypoints?: {
-        providedIndex: number;
-        optimizedIndex: number;
-    }[];
-    report?: ReportAPI;
+    /**
+     * Base URL of the Road Shields service (EXPLICIT, top-level). Applied to every instruction's
+     * `roadShieldAtlasReference`. Requested via the top-level `roadShieldAtlasReference` attribute.
+     */
     roadShieldAtlasReference?: string;
 };
 
@@ -1677,7 +1701,15 @@ declare type ChargingModel = {
     chargingTimeOffsetInSec?: number;
 };
 
-declare type ChargingParametersAPI = Omit<ChargingModel, 'maxChargeKWH'>;
+/**
+ * V3 charging model sent in the POST body of the LDEVR endpoint.
+ * @ignore
+ */
+declare type ChargingParametersAPI = {
+    batteryCurve?: BatteryCurve[];
+    chargingConnectors?: ChargingConnector[];
+    chargingTimeOffsetInSec?: number;
+};
 
 /**
  * @ignore
@@ -1690,7 +1722,10 @@ declare type ChargingParkAPI = {
  * @ignore
  */
 declare type ChargingParkLocationAPI = {
-    coordinate: LatitudeLongitudePointAPI;
+    coordinate: {
+        latitude: number;
+        longitude: number;
+    };
     street?: string;
     houseNumber?: string;
     city?: string;
@@ -3418,6 +3453,13 @@ export declare type CostModel = {
     routeType?: RouteType;
 };
 
+/**
+ * @ignore
+ */
+declare type CountrySectionAPI = BasicSectionAPI & {
+    countryCodeIso2?: string;
+};
+
 /**
  * @ignore
  */
@@ -3563,6 +3605,12 @@ declare interface DefaultAPIResponseErrorBody extends BaseAPIResponseErrorBody {
     errorText?: string;
 }
 
+/**
+ * V3 delay magnitude values. `'undefined'` is the raw API value mapped to SDK `'indefinite'`.
+ * @ignore
+ */
+declare type DelayMagnitudeAPI = 'unknown' | 'minor' | 'moderate' | 'major' | 'undefined';
+
 declare type DepartArriveOption = 'departAt' | 'arriveBy';
 
 /**
@@ -4486,14 +4534,13 @@ declare type FeaturePropertiesAPI = {
 
 /**
  * Hybrid HTTP fetch input, supporting different HTTP methods such as GET and POST.
- * * GET method comes with a URL.
- * * POST method comes with a URL and optional POST data.
+ * * GET method comes with a URL and optional headers.
+ * * POST method comes with a URL, optional POST data, and optional headers.
  * @ignore
  */
-export declare type FetchInput<PostData = void> = {
+export declare type FetchInput<PostData = void> = ({
     method: 'GET';
-    url: URL;
-} | ({
+} & GetObject) | ({
     method: 'POST';
 } & PostObject<PostData>);
 
@@ -5555,6 +5602,15 @@ export declare type GeometrySearchResultAPI = CommonSearchPlaceResultAPI;
  */
 declare type GeometrySearchTemplate = ServiceTemplate<GeometrySearchParams, GeometrySearchRequestAPI, GeometrySearchResponseAPI, GeometrySearchResponse>;
 
+/**
+ * GET object with URL and optional service-specific API headers.
+ * @ignore
+ */
+export declare type GetObject = {
+    url: URL;
+    headers?: TomTomAPIHeaders;
+};
+
 /**
  * Enhance multiple places with real-time EV charging availability data.
  *
@@ -5567,7 +5623,7 @@ declare type GeometrySearchTemplate = ServiceTemplate<GeometrySearchParams, Geom
  * take some time.
  *
  * @param places - Collection of places to enhance
- * @param options - Configuration options
+ * @param options - Configuration options, including common service parameters (e.g. `key`, `customServiceBaseURL`, `onAPIRequest`) forwarded to each availability request
  *
  * @returns Promise resolving to places collection with merged availability
  *
@@ -5593,10 +5649,18 @@ declare type GeometrySearchTemplate = ServiceTemplate<GeometrySearchParams, Geom
  *
  * @group EV Charging
  */
-export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(places: Places_2<P>, options?: {
+export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(places: Places_2<P>, options?: Omit<ChargingStationsAvailabilityParams, 'id'> & {
     excludeIfAvailabilityUnknown: true;
 }): Promise<Places_2<EVChargingStationWithAvailabilityPlaceProps>>;
 
+export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps = CommonPlaceProps>(places: Places_2<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_2<P | EVChargingStationWithAvailabilityPlaceProps>>;
+
 /**
  * Enhance a place with real-time EV charging availability data.
  *
@@ -5604,6 +5668,7 @@ export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps =
  * the place properties.
  *
  * @param place - The place to enhance with availability data
+ * @param commonParams - Common service parameters (e.g. `key`, `customServiceBaseURL`, `onAPIRequest`) forwarded to the availability request
  *
  * @returns Promise resolving to the place with merged availability information
  * @returns undefined if no availability data is present for the `place` input parameter.
@@ -5624,7 +5689,7 @@ export declare function getPlacesWithEVAvailability<P extends CommonPlaceProps =
  *
  * @group EV Charging
  */
-export declare const getPlaceWithEVAvailability: <P extends CommonPlaceProps = CommonPlaceProps>(place: Place<P>) => Promise<Place<EVChargingStationWithAvailabilityPlaceProps> | undefined>;
+export declare const getPlaceWithEVAvailability: <P extends CommonPlaceProps = CommonPlaceProps>(place: Place<P>, commonParams?: Omit<ChargingStationsAvailabilityParams, "id">) => Promise<Place<EVChargingStationWithAvailabilityPlaceProps> | undefined>;
 
 /**
  * Retrieve the list of POI category types supported by the TomTom Search API.
@@ -5680,13 +5745,6 @@ export declare const getPOICategories: (params?: POICategoriesParams) => Promise
  */
 export declare const getPOICategoryCodes: (params?: POICategoriesParams) => Promise<POICategory_2[]>;
 
-/**
- * @ignore
- */
-declare type GuidanceAPI = Omit<Guidance, 'instructions'> & {
-    instructions: InstructionAPI[];
-};
-
 /**
  * Configuration for turn-by-turn guidance instructions.
  *
@@ -5739,6 +5797,35 @@ export declare type GuidanceParams = {
  */
 export declare const hasChargingAvailability: (chargingPark: ChargingPark | ChargingParkWithAvailability | undefined) => chargingPark is ChargingParkWithAvailability;
 
+/**
+ * V3 traffic section icon categories.
+ * @ignore
+ */
+declare type IconCategoryAPI = 'jam' | 'accident' | 'brokenDownVehicle' | 'dangerousConditions' | 'flooding' | 'fog' | 'ice' | 'laneClosed' | 'rain' | 'roadClosed' | 'roadWorks' | 'wind';
+
+/**
+ * V3 icon reference — same shape as the SDK's RoadShieldReference.
+ * @ignore
+ */
+declare type IconReferenceAPI = {
+    reference: string;
+    shieldContent?: string;
+    affixes?: string[];
+};
+
+/**
+ * @ignore
+ */
+declare type ImportantRoadStretchSectionAPI = BasicSectionAPI & {
+    importantRoadStretchIndex: number;
+    streetName?: {
+        text: string;
+    };
+    roadNumbers?: {
+        text: string;
+    }[];
+};
+
 /**
  * @ignore
  */
@@ -5844,6 +5931,7 @@ export declare type InputSectionType = (typeof inputSectionTypes)[number];
  * - `lowEmissionZone`: Low emission zones
  * - `speedLimit`: Speed limit changes
  * - `roadShields`: Road shield information
+ * - `importantRoadStretch`: Named important road stretches along the route
  *
  * @example
  * ```typescript
@@ -5857,23 +5945,93 @@ export declare type InputSectionType = (typeof inputSectionTypes)[number];
  * const sectionTypes: InputSectionTypes = [];
  * ```
  *
- * @default All available section types
+ * @remarks
+ * A requested section type is only present in the response if the route actually traverses it
+ * (e.g. `ferry` is omitted on a route with no water crossing). The `lanes` section is guidance-only:
+ * it is returned solely when {@link GuidanceParams | `guidance`} is also requested, and is therefore
+ * not part of this input list.
+ *
+ * @default When omitted, all section types are requested (equivalent to `inputSectionTypes`).
  *
  * @group Routing
  */
 export declare type InputSectionTypes = InputSectionType[];
 
 /**
+ * V3 instruction — raw response shape. Coordinates are lat/lon (not GeoJSON), and several field
+ * names / value casings differ from the SDK's {@link Instruction}; the parser converts them.
  * @ignore
  */
-declare type InstructionAPI = Omit<Instruction, 'maneuverPoint' | 'routePath' | 'pathPointIndex'> & {
-    maneuverPoint: LatitudeLongitudePointAPI;
-    routePath: RoutePathPointAPI[];
+declare type InstructionAPI = {
+    routeOffsetInMeters: number;
+    maneuver?: string;
+    maneuverPoint: LatLonPointAPI;
+    routePath?: RoutePathPointAPI[];
+    nextRoadInformation?: InstructionRoadInformationAPI;
+    previousRoadInformation?: InstructionRoadInformationAPI;
+    signpost?: SignpostAPI;
+    intersectionName?: TextWithPhoneticsAPI;
+    drivingSide?: 'left' | 'right';
+    landmark?: string;
+    distanceToPreviousTrafficLightInMeters?: number;
+    ambiguousExitOffsetFromManeuverInMeters?: number;
+    roundaboutExitNumber?: number;
+    isManeuverObligatory?: boolean;
+    changeOfAngleInDegrees?: number;
+    tollgateName?: TextWithPhoneticsAPI;
+    tollPaymentTypes?: string[];
+    countryCrossingFromName?: TextWithPhoneticsAPI;
+    countryCrossingFromCodeIso2?: string;
+    countryCrossingToName?: TextWithPhoneticsAPI;
+    countryCrossingToCodeIso2?: string;
+    sideRoads?: Instruction['sideRoads'];
 };
 
 /**
+ * V3 road information inside an instruction — field names changed from V2.
+ * @ignore
+ */
+declare type InstructionRoadInformationAPI = {
+    properties?: string[];
+    roadShields?: InstructionRoadShieldAPI[];
+    roadNames?: Array<{
+        identifier: TextWithPhoneticsAPI;
+    }>;
+    roadNumbers?: Array<{
+        identifier: TextWithPhoneticsAPI;
+    }>;
+};
+
+/**
+ * V3 road shield inside an instruction's road information. `iconReference` is EXPLICIT.
+ * @ignore
+ */
+declare type InstructionRoadShieldAPI = {
+    roadNumber?: TextWithPhoneticsAPI;
+    countryCodeIso2?: string;
+    countrySubdivisionCodeIso?: string;
+    iconReference?: IconReferenceAPI;
+};
+
+/**
+ * V3 lanes section — directions/separators are camelCase strings (mapped to the SDK's
+ * UPPER_SNAKE enums during parsing), and lanes are objects rather than flat direction lists.
+ * @ignore
+ */
+declare type LanesSectionAPI = BasicSectionAPI & {
+    lanes?: {
+        directions: string[];
+        follow?: string;
+        laneType?: string;
+        tollPaymentTypes?: string[];
+    }[];
+    laneSeparators?: string[];
+    properties?: string[];
+};
+
+/**
+ * Lat/lon point used by non-routing services (e.g. reachable-range).
  * @ignore
- * @see {@link https://docs.tomtom.com/routing-api/documentation/routing/common-routing-parameters point}
  */
 declare type LatitudeLongitudePointAPI = {
     latitude: number;
@@ -5895,13 +6053,31 @@ declare type LatLonAPI = {
 };
 
 /**
+ * V3 lat/lon point used in guidance instructions (different from GeoJSON used elsewhere).
+ * @ignore
+ */
+declare type LatLonPointAPI = {
+    latitude: number;
+    longitude: number;
+};
+
+/**
+ * V3 leg — path is now a GeoJSON LineString instead of a points array.
  * @ignore
  */
 declare type LegAPI = {
-    points: LatitudeLongitudePointAPI[];
+    path: LineString;
     summary: SummaryAPI_2;
 };
 
+/**
+ * V3 per-leg request (used in the `legs` array for route reconstruction).
+ * @ignore
+ */
+declare type LegRequestAPI = {
+    path?: LineString;
+};
+
 /**
  * Basic low/normal/high intensity level option.
  *
@@ -6194,6 +6370,15 @@ declare const parseTrafficAreaAnalyticsResponse: (apiResponse: AreaAnalyticsResp
  */
 declare const parseTrafficIncidentDetailsResponse: (apiResponse: IncidentDetailsResponseAPI) => TrafficIncidentDetails;
 
+/**
+ * V3 phonetic transcription — an object keyed by phonetic alphabet, not a flat string as in V2.
+ * @ignore
+ */
+declare type PhoneticAPI = {
+    lhp?: string;
+    ipa?: string;
+};
+
 /**
  * Retrieve detailed information about a place using its unique identifier.
  *
@@ -6569,14 +6754,6 @@ export declare type POICategoryResult = {
     synonyms: string[];
 };
 
-/**
- * @ignore
- */
-declare type PointWaypointAPI = {
-    waypointSourceType: 'USER_DEFINED' | 'AUTO_GENERATED';
-    supportingPointIndex: number;
-};
-
 /**
  * @ignore
  */
@@ -6622,12 +6799,13 @@ export declare const POPULATED_AREA_TAGS: readonly ["village", "small_town", "mi
 export declare type PopulatedAreaTag = (typeof POPULATED_AREA_TAGS)[number];
 
 /**
- * POST object with URL and optional payload.
+ * POST object with URL, optional payload, and optional service-specific API headers.
  * @ignore
  */
 export declare type PostObject<D> = {
     url: URL;
     data?: D;
+    headers?: TomTomAPIHeaders;
 };
 
 /**
@@ -6682,6 +6860,16 @@ declare type PredefinedVehicleModel = {
     variantId: string;
 };
 
+/**
+ * V3 progress point — field names differ from the SDK's RouteProgressPoint.
+ * @ignore
+ */
+declare type ProgressPointAPI = {
+    pathIndex: number;
+    distanceInMeters?: number;
+    travelDurationInSeconds?: number;
+};
+
 /**
  * Union type for all possible query intents.
  *
@@ -6992,16 +7180,6 @@ declare type ReachableRangeTemplate = ServiceTemplate<ReachableRangeParams, Reac
  */
 export declare type RelatedPoisRequest = 'child' | 'parent' | 'all' | 'off';
 
-/**
- * @ignore
- */
-declare type ReportAPI = {
-    effectiveSettings: {
-        key: string;
-        value: string;
-    }[];
-};
-
 /**
  * Configuration for services request validation.
  * @ignore
@@ -7350,17 +7528,29 @@ export declare type RoadUse = 'LimitedAccess' | 'Arterial' | 'Terminal' | 'Ramp'
  */
 declare type RouteAPI = {
     legs: LegAPI[];
-    sections: SectionAPI[];
+    sections?: SectionsAPI;
     summary: SummaryAPI_2;
-    guidance?: GuidanceAPI;
-    progress?: RouteProgressPoint[];
+    instructions?: InstructionAPI[];
+    progressPoints?: ProgressPointAPI[];
 };
 
 /**
+ * V3 routePath point — field names changed from V2.
  * @ignore
  */
-declare type RoutePathPointAPI = Omit<RoutePathPoint, 'point'> & {
-    point: LatitudeLongitudePointAPI;
+declare type RoutePathPointAPI = {
+    point: LatLonPointAPI;
+    distanceFromRouteStartInMeters: number;
+    travelTimeFromRouteStartInSeconds: number;
+};
+
+/**
+ * @ignore
+ */
+declare type RoutePlanningLocationsAPI = {
+    origin: Point;
+    destination: Point;
+    waypoints?: MultiPoint;
 };
 
 /**
@@ -7847,38 +8037,32 @@ export declare type SearchSummary = {
 };
 
 /**
+ * V3 sections object — already grouped by type (no flat array + discriminator).
  * @ignore
  */
-declare type SectionAPI = {
-    sectionType: SectionTypeAPI;
-    startPointIndex: number;
-    endPointIndex: number;
-    travelMode?: TravelMode | 'other';
-    countryCode?: string;
-    simpleCategory?: TrafficCategoryAPI;
-    magnitudeOfDelay?: number;
-    effectiveSpeedInKmh?: number;
-    delayInSeconds?: number;
-    tec?: TrafficIncidentTEC;
-    lanes?: LaneDirection[];
-    laneSeparators?: PossibleLaneSeparator[];
-    properties?: string[];
-    maxSpeedLimitInKmh?: number;
-    roadShieldReferences?: RoadShieldReference[];
-    importantRoadStretchIndex?: number;
-    streetName?: {
-        text: string;
-    };
-    roadNumbers?: {
-        text: string;
-    }[];
+declare type SectionsAPI = {
+    carTrain?: BasicSectionAPI[];
+    ferry?: BasicSectionAPI[];
+    tunnel?: BasicSectionAPI[];
+    motorway?: BasicSectionAPI[];
+    pedestrian?: BasicSectionAPI[];
+    toll?: BasicSectionAPI[];
+    country?: CountrySectionAPI[];
+    travelMode?: TravelModeSectionAPI[];
+    traffic?: TrafficSectionAPI[];
+    carpool?: BasicSectionAPI[];
+    urban?: BasicSectionAPI[];
+    unpaved?: BasicSectionAPI[];
+    lowEmissionZone?: BasicSectionAPI[];
+    speedLimit?: SpeedLimitSectionAPI[];
+    lanes?: LanesSectionAPI[];
+    roadShields?: (BasicSectionAPI & {
+        roadShieldReferences?: RoadShieldReference[];
+    })[];
+    tollVignette?: CountrySectionAPI[];
+    importantRoadStretch?: ImportantRoadStretchSectionAPI[];
 };
 
-/**
- * @ignore
- */
-declare type SectionTypeAPI = 'CAR_TRAIN' | 'COUNTRY' | 'FERRY' | 'MOTORWAY' | 'PEDESTRIAN' | 'TOLL' | 'TOLL_VIGNETTE' | 'TRAFFIC' | 'TRAVEL_MODE' | 'TUNNEL' | 'UNPAVED' | 'URBAN' | 'CARPOOL' | 'LOW_EMISSION_ZONE' | 'LANES' | 'SPEED_LIMIT' | 'ROAD_SHIELDS' | 'IMPORTANT_ROAD_STRETCH';
-
 /**
  * Name of a service managed by the SDK.
  */
@@ -7956,6 +8140,29 @@ export declare type ServiceTemplate<Params extends CommonServiceParams<ApiReques
     parseResponseError?: ParseResponseError<any>;
 };
 
+/**
+ * V3 signpost — adds an EXPLICIT `exitIconReference` (mapped to signpostRoadShieldReferences).
+ * @ignore
+ */
+declare type SignpostAPI = {
+    exitName?: TextWithPhoneticsAPI;
+    exitNumber?: TextWithPhoneticsAPI;
+    towardName?: TextWithPhoneticsAPI;
+    exitIconReference?: IconReferenceAPI;
+};
+
+/**
+ * V3 speed limit section — speed values live under `speedRestrictions` (typed maximum/minimum)
+ * instead of the V2 flat `maxSpeedLimitInKmh`.
+ * @ignore
+ */
+declare type SpeedLimitSectionAPI = BasicSectionAPI & {
+    speedRestrictions?: {
+        type: 'maximum' | 'minimum';
+        inKilometersPerHour: number;
+    }[];
+};
+
 /**
  * Specifies the speed-dependent component of consumption.
  * Provided as an unordered list of speed/consumption-rate pairs.
@@ -7986,15 +8193,28 @@ declare type SummaryAPI = Omit<SearchSummary, 'geoBias'> & {
 };
 
 /**
- * @ignore
- */
-declare type SummaryAPI_2 = Omit<RouteSummary & LegSummary, 'arrivalTime' | 'departureTime' | 'batteryConsumptionInPCT' | 'remainingChargeAtArrivalInPCT' | 'chargingInformationAtEndOfLeg' | 'deviationPoint'> & {
-    arrivalTime: string;
-    departureTime: string;
+ * V3 summary — field names changed from V2.
+ * @ignore
+ */
+declare type SummaryAPI_2 = {
+    lengthInMeters: number;
+    travelDurationInSeconds: number;
+    trafficDelayDurationInSeconds?: number;
+    trafficLengthInMeters?: number;
+    departureDateTime: string;
+    arrivalDateTime: string;
+    deviationDistanceInMeters?: number;
+    deviationDurationInSeconds?: number;
+    deviationPoint?: Point;
+    historicTrafficTravelTimeInSeconds?: number;
+    liveTrafficIncidentsTravelTimeInSeconds?: number;
+    noTrafficTravelTimeInSeconds?: number;
+    totalChargingTimeInSeconds?: number;
+    batteryConsumptionInkWh?: number;
+    batteryConsumptionInKilowattHours?: number;
+    remainingChargeAtArrivalInkWh?: number;
+    fuelConsumptionInLiters?: number;
     chargingInformationAtEndOfLeg?: ChargingStopAPI;
-    deviationDistance?: number;
-    deviationTime?: number;
-    deviationPoint?: LatitudeLongitudePointAPI;
 };
 
 /**
@@ -8010,6 +8230,16 @@ declare type SummaryAPI_2 = Omit<RouteSummary & LegSummary, 'arrivalTime' | 'dep
  */
 declare type SummaryQueryType = 'NEARBY' | 'NON_NEAR';
 
+/**
+ * V3 text-with-phonetics — `phonetic` is now an object (mapped to a flat string during parsing).
+ * @ignore
+ */
+declare type TextWithPhoneticsAPI = {
+    text: string;
+    phonetic?: PhoneticAPI;
+    phoneticLanguageCode?: string;
+};
+
 /**
  * @ignore
  */
@@ -8291,11 +8521,6 @@ export declare type TrafficAreaAnalyticsParams = CommonServiceParams & TrafficAr
  */
 declare type TrafficAreaAnalyticsTemplate = ServiceTemplate<TrafficAreaAnalyticsParams, FetchInput<AreaAnalyticsRequestBody>, AreaAnalyticsResponseAPI, TrafficAreaAnalytics>;
 
-/**
- * @ignore
- */
-declare type TrafficCategoryAPI = 'JAM' | 'ROAD_WORK' | 'ROAD_CLOSURE' | 'OTHER';
-
 /**
  * Fetch detailed information about traffic incidents.
  *
@@ -8557,6 +8782,25 @@ declare type TrafficIncidentDetailsTemplate = ServiceTemplate<TrafficIncidentDet
  */
 export declare type TrafficInput = 'live' | 'historical';
 
+/**
+ * @ignore
+ */
+declare type TrafficSectionAPI = BasicSectionAPI & {
+    effectiveSpeedInKilometersPerHour?: number;
+    delayDurationInSeconds?: number;
+    delayMagnitude?: DelayMagnitudeAPI;
+    tec?: TrafficIncidentTEC;
+    iconCategory?: IconCategoryAPI;
+    eventId?: string;
+};
+
+/**
+ * @ignore
+ */
+declare type TravelModeSectionAPI = BasicSectionAPI & {
+    travelMode?: TravelMode | 'other';
+};
+
 /**
  * Validate Error Class for validating params input, this will be used by SDKError class.
  * @ignore