# Routing ## Calculate a route between two points `routing().route(RoutingRouteParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : RouteResult` **post** `/api/v1/route` Calculate a route between two points ### Parameters - `params: RoutingRouteParams` - `routeRequest: RouteRequest` Request body for route calculation. Origin and destination are lat/lng coordinate objects. Supports optional waypoints, alternative routes, turn-by-turn steps, and EV routing parameters. ### Returns - `class RouteResult:` GeoJSON Feature representing a calculated route. The geometry is a LineString or MultiLineString of the route path. When `alternatives > 0`, the response is a FeatureCollection containing multiple route Features. - `geometry: GeoJsonGeometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `coordinates: Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `List` - `List>` - `List>>` - `List>>>` - `type: Type` Geometry type - `POINT("Point")` - `LINE_STRING("LineString")` - `POLYGON("Polygon")` - `MULTI_POINT("MultiPoint")` - `MULTI_LINE_STRING("MultiLineString")` - `MULTI_POLYGON("MultiPolygon")` - `properties: Properties` Route metadata - `distanceM: Double` Total route distance in meters - `durationS: Double` Estimated travel duration in seconds - `annotations: Optional` Per-edge annotations (present when `annotations: true` in request) - `chargeProfile: Optional>>` Battery charge level at route waypoints as [distance_fraction, charge_pct] pairs (EV routes only) - `chargingStops: Optional>` Recommended charging stops along the route (EV routes only) - `edges: Optional>` Edge-level route details (present when `annotations: true`) - `energyUsedWh: Optional` Total energy consumed in watt-hours (EV routes only) - `type: Type` - `FEATURE("Feature")` ### Example ```kotlin package com.plazafyi.example import com.plazafyi.client.PlazaClient import com.plazafyi.client.okhttp.PlazaOkHttpClient import com.plazafyi.models.routing.RouteRequest import com.plazafyi.models.routing.RouteResult import com.plazafyi.models.routing.RoutingRouteParams fun main() { val client: PlazaClient = PlazaOkHttpClient.fromEnv() val params: RouteRequest = RouteRequest.builder() .destination(RouteRequest.Destination.builder() .lat(48.8584) .lng(2.2945) .build()) .origin(RouteRequest.Origin.builder() .lat(48.8566) .lng(2.3522) .build()) .build() val routeResult: RouteResult = client.routing().route(params) } ``` #### Response ```json { "geometry": { "coordinates": [ 2.3522, 48.8566 ], "type": "Point" }, "properties": { "distance_m": 4523.7, "duration_s": 847.2, "annotations": { "foo": "bar" }, "charge_profile": [ [ 0 ] ], "charging_stops": [ { "foo": "bar" } ], "edges": [ { "foo": "bar" } ], "energy_used_wh": 0 }, "type": "Feature" } ``` ## Snap a coordinate to the nearest road `routing().nearest(RoutingNearestParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : NearestResult` **get** `/api/v1/nearest` Snap a coordinate to the nearest road ### Parameters - `params: RoutingNearestParams` - `lat: Double` Latitude - `lng: Double` Longitude - `outputFields: Optional` Comma-separated property fields to include - `outputInclude: Optional` Extra computed fields: bbox, distance, center - `outputPrecision: Optional` Coordinate decimal precision (1-15, default 7) - `radius: Optional` Search radius in meters (default 500, max 5000) ### Returns - `class NearestResult:` GeoJSON Point Feature representing the nearest point on the road network to the input coordinate. Used for snapping GPS coordinates to roads. - `geometry: GeoJsonGeometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `coordinates: Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `List` - `List>` - `List>>` - `List>>>` - `type: Type` Geometry type - `POINT("Point")` - `LINE_STRING("LineString")` - `POLYGON("Polygon")` - `MULTI_POINT("MultiPoint")` - `MULTI_LINE_STRING("MultiLineString")` - `MULTI_POLYGON("MultiPolygon")` - `properties: Properties` Snap result metadata - `distanceM: Optional` Distance from the input coordinate to the snapped point in meters - `edgeId: Optional` ID of the road network edge that was snapped to - `edgeLengthM: Optional` Length of the matched road edge in meters - `highway: Optional` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `osmWayId: Optional` OSM way ID of the matched road segment - `surface: Optional` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `type: Type` - `FEATURE("Feature")` ### Example ```kotlin package com.plazafyi.example import com.plazafyi.client.PlazaClient import com.plazafyi.client.okhttp.PlazaOkHttpClient import com.plazafyi.models.routing.NearestResult import com.plazafyi.models.routing.RoutingNearestParams fun main() { val client: PlazaClient = PlazaOkHttpClient.fromEnv() val params: RoutingNearestParams = RoutingNearestParams.builder() .lat(0.0) .lng(0.0) .build() val nearestResult: NearestResult = client.routing().nearest(params) } ``` #### Response ```json { "geometry": { "coordinates": [ 2.3522, 48.8566 ], "type": "Point" }, "properties": { "distance_m": 12.4, "edge_id": 0, "edge_length_m": 0, "highway": "highway", "osm_way_id": 0, "surface": "surface" }, "type": "Feature" } ``` ## Snap a coordinate to the nearest road `routing().nearestPost(RoutingNearestPostParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : NearestResult` **post** `/api/v1/nearest` Snap a coordinate to the nearest road ### Parameters - `params: RoutingNearestPostParams` - `lat: Double` Latitude - `lng: Double` Longitude - `outputFields: Optional` Comma-separated property fields to include - `outputInclude: Optional` Extra computed fields: bbox, distance, center - `outputPrecision: Optional` Coordinate decimal precision (1-15, default 7) - `radius: Optional` Search radius in meters (default 500, max 5000) ### Returns - `class NearestResult:` GeoJSON Point Feature representing the nearest point on the road network to the input coordinate. Used for snapping GPS coordinates to roads. - `geometry: GeoJsonGeometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `coordinates: Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `List` - `List>` - `List>>` - `List>>>` - `type: Type` Geometry type - `POINT("Point")` - `LINE_STRING("LineString")` - `POLYGON("Polygon")` - `MULTI_POINT("MultiPoint")` - `MULTI_LINE_STRING("MultiLineString")` - `MULTI_POLYGON("MultiPolygon")` - `properties: Properties` Snap result metadata - `distanceM: Optional` Distance from the input coordinate to the snapped point in meters - `edgeId: Optional` ID of the road network edge that was snapped to - `edgeLengthM: Optional` Length of the matched road edge in meters - `highway: Optional` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `osmWayId: Optional` OSM way ID of the matched road segment - `surface: Optional` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `type: Type` - `FEATURE("Feature")` ### Example ```kotlin package com.plazafyi.example import com.plazafyi.client.PlazaClient import com.plazafyi.client.okhttp.PlazaOkHttpClient import com.plazafyi.models.routing.NearestResult import com.plazafyi.models.routing.RoutingNearestPostParams fun main() { val client: PlazaClient = PlazaOkHttpClient.fromEnv() val params: RoutingNearestPostParams = RoutingNearestPostParams.builder() .lat(0.0) .lng(0.0) .build() val nearestResult: NearestResult = client.routing().nearestPost(params) } ``` #### Response ```json { "geometry": { "coordinates": [ 2.3522, 48.8566 ], "type": "Point" }, "properties": { "distance_m": 12.4, "edge_id": 0, "edge_length_m": 0, "highway": "highway", "osm_way_id": 0, "surface": "surface" }, "type": "Feature" } ``` ## Calculate an isochrone from a point `routing().isochrone(RoutingIsochroneParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : RoutingIsochroneResponse` **get** `/api/v1/isochrone` Calculate an isochrone from a point ### Parameters - `params: RoutingIsochroneParams` - `lat: Double` Latitude - `lng: Double` Longitude - `time: Double` Travel time in seconds (1-7200) - `mode: Optional` Travel mode (auto, foot, bicycle) - `outputFields: Optional` Comma-separated property fields to include - `outputGeometry: Optional` Include geometry (default true) - `outputInclude: Optional` Extra computed fields: bbox, center - `outputPrecision: Optional` Coordinate decimal precision (1-15, default 7) - `outputSimplify: Optional` Simplify geometry tolerance in meters ### Returns - `class RoutingIsochroneResponse:` GeoJSON Feature or FeatureCollection representing isochrone polygons — areas reachable within the specified travel time(s). Single time value returns a Feature; comma-separated times return a FeatureCollection with one polygon per contour. - `features: Optional>` Array of isochrone polygon Features (multi-contour only) - `geometry: GeoJsonGeometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `coordinates: Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `List` - `List>` - `List>>` - `List>>>` - `type: Type` Geometry type - `POINT("Point")` - `LINE_STRING("LineString")` - `POLYGON("Polygon")` - `MULTI_POINT("MultiPoint")` - `MULTI_LINE_STRING("MultiLineString")` - `MULTI_POLYGON("MultiPolygon")` - `properties: Properties` OSM tags flattened as key-value pairs, plus `@type` (node/way/relation) and `@id` (OSM ID) metadata fields. May include `distance_m` for proximity queries. - `type: Type` Always `Feature` - `FEATURE("Feature")` - `id: Optional` Compound identifier in `type/osm_id` format - `geometry: Optional` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `properties: Optional` Isochrone metadata - `areaM2: Optional` Area of the isochrone polygon in square meters (multi-contour features only) - `maxCostS: Optional` Maximum actual travel cost in seconds to the isochrone boundary (single contour only) - `mode: Optional` Travel mode used for the isochrone calculation - `AUTO("auto")` - `FOOT("foot")` - `BICYCLE("bicycle")` - `timeSeconds: Optional` Travel time budget in seconds - `verticesReached: Optional` Number of road network vertices within the isochrone - `type: Optional` `Feature` for single contour, `FeatureCollection` for multiple contours - `FEATURE("Feature")` - `FEATURE_COLLECTION("FeatureCollection")` ### Example ```kotlin package com.plazafyi.example import com.plazafyi.client.PlazaClient import com.plazafyi.client.okhttp.PlazaOkHttpClient import com.plazafyi.models.routing.RoutingIsochroneParams import com.plazafyi.models.routing.RoutingIsochroneResponse fun main() { val client: PlazaClient = PlazaOkHttpClient.fromEnv() val params: RoutingIsochroneParams = RoutingIsochroneParams.builder() .lat(0.0) .lng(0.0) .time(0.0) .build() val response: RoutingIsochroneResponse = client.routing().isochrone(params) } ``` #### Response ```json { "features": [ { "geometry": { "coordinates": [ 2.3522, 48.8566 ], "type": "Point" }, "properties": { "@id": "bar", "@type": "bar", "amenity": "bar", "cuisine": "bar", "name": "bar" }, "type": "Feature", "id": "node/21154906" } ], "geometry": { "coordinates": [ 2.3522, 48.8566 ], "type": "Point" }, "properties": { "area_m2": 0, "max_cost_s": 0, "mode": "auto", "time_seconds": 0, "vertices_reached": 0 }, "type": "Feature" } ``` ## Calculate an isochrone from a point `routing().isochronePost(RoutingIsochronePostParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : RoutingIsochronePostResponse` **post** `/api/v1/isochrone` Calculate an isochrone from a point ### Parameters - `params: RoutingIsochronePostParams` - `lat: Double` Latitude - `lng: Double` Longitude - `time: Double` Travel time in seconds (1-7200) - `mode: Optional` Travel mode (auto, foot, bicycle) - `outputFields: Optional` Comma-separated property fields to include - `outputGeometry: Optional` Include geometry (default true) - `outputInclude: Optional` Extra computed fields: bbox, center - `outputPrecision: Optional` Coordinate decimal precision (1-15, default 7) - `outputSimplify: Optional` Simplify geometry tolerance in meters ### Returns - `class RoutingIsochronePostResponse:` GeoJSON Feature or FeatureCollection representing isochrone polygons — areas reachable within the specified travel time(s). Single time value returns a Feature; comma-separated times return a FeatureCollection with one polygon per contour. - `features: Optional>` Array of isochrone polygon Features (multi-contour only) - `geometry: GeoJsonGeometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `coordinates: Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `List` - `List>` - `List>>` - `List>>>` - `type: Type` Geometry type - `POINT("Point")` - `LINE_STRING("LineString")` - `POLYGON("Polygon")` - `MULTI_POINT("MultiPoint")` - `MULTI_LINE_STRING("MultiLineString")` - `MULTI_POLYGON("MultiPolygon")` - `properties: Properties` OSM tags flattened as key-value pairs, plus `@type` (node/way/relation) and `@id` (OSM ID) metadata fields. May include `distance_m` for proximity queries. - `type: Type` Always `Feature` - `FEATURE("Feature")` - `id: Optional` Compound identifier in `type/osm_id` format - `geometry: Optional` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `properties: Optional` Isochrone metadata - `areaM2: Optional` Area of the isochrone polygon in square meters (multi-contour features only) - `maxCostS: Optional` Maximum actual travel cost in seconds to the isochrone boundary (single contour only) - `mode: Optional` Travel mode used for the isochrone calculation - `AUTO("auto")` - `FOOT("foot")` - `BICYCLE("bicycle")` - `timeSeconds: Optional` Travel time budget in seconds - `verticesReached: Optional` Number of road network vertices within the isochrone - `type: Optional` `Feature` for single contour, `FeatureCollection` for multiple contours - `FEATURE("Feature")` - `FEATURE_COLLECTION("FeatureCollection")` ### Example ```kotlin package com.plazafyi.example import com.plazafyi.client.PlazaClient import com.plazafyi.client.okhttp.PlazaOkHttpClient import com.plazafyi.models.routing.RoutingIsochronePostParams import com.plazafyi.models.routing.RoutingIsochronePostResponse fun main() { val client: PlazaClient = PlazaOkHttpClient.fromEnv() val params: RoutingIsochronePostParams = RoutingIsochronePostParams.builder() .lat(0.0) .lng(0.0) .time(0.0) .build() val response: RoutingIsochronePostResponse = client.routing().isochronePost(params) } ``` #### Response ```json { "features": [ { "geometry": { "coordinates": [ 2.3522, 48.8566 ], "type": "Point" }, "properties": { "@id": "bar", "@type": "bar", "amenity": "bar", "cuisine": "bar", "name": "bar" }, "type": "Feature", "id": "node/21154906" } ], "geometry": { "coordinates": [ 2.3522, 48.8566 ], "type": "Point" }, "properties": { "area_m2": 0, "max_cost_s": 0, "mode": "auto", "time_seconds": 0, "vertices_reached": 0 }, "type": "Feature" } ``` ## Calculate a distance matrix between points `routing().matrix(RoutingMatrixParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : MatrixResult` **post** `/api/v1/matrix` Calculate a distance matrix between points ### Parameters - `params: RoutingMatrixParams` - `matrixRequest: MatrixRequest` Request body for distance matrix calculation. Computes travel durations (and optionally distances) between every origin-destination pair. Maximum 2,500 pairs (origins × destinations), each list capped at 50 coordinates. ### Returns - `class MatrixResult:` Distance matrix result. The exact response shape depends on the routing backend. Contains duration (and optionally distance) data for all origin-destination pairs. Null values indicate unreachable pairs. ### Example ```kotlin package com.plazafyi.example import com.plazafyi.client.PlazaClient import com.plazafyi.client.okhttp.PlazaOkHttpClient import com.plazafyi.models.routing.MatrixRequest import com.plazafyi.models.routing.MatrixResult import com.plazafyi.models.routing.RoutingMatrixParams fun main() { val client: PlazaClient = PlazaOkHttpClient.fromEnv() val params: MatrixRequest = MatrixRequest.builder() .addDestination(MatrixRequest.Destination.builder() .lat(48.8584) .lng(2.2945) .build()) .addOrigin(MatrixRequest.Origin.builder() .lat(48.8566) .lng(2.3522) .build()) .addOrigin(MatrixRequest.Origin.builder() .lat(48.8606) .lng(2.3376) .build()) .build() val matrixResult: MatrixResult = client.routing().matrix(params) } ``` #### Response ```json { "foo": "bar" } ``` ## Domain Types ### Matrix Request - `class MatrixRequest:` Request body for distance matrix calculation. Computes travel durations (and optionally distances) between every origin-destination pair. Maximum 2,500 pairs (origins × destinations), each list capped at 50 coordinates. - `destinations: List` Array of destination coordinates (max 50) - `lat: Double` Latitude in decimal degrees (-90 to 90) - `lng: Double` Longitude in decimal degrees (-180 to 180) - `origins: List` Array of origin coordinates (max 50) - `lat: Double` Latitude in decimal degrees (-90 to 90) - `lng: Double` Longitude in decimal degrees (-180 to 180) - `annotations: Optional` Comma-separated list of annotations to include: `duration` (always included), `distance`. Example: `duration,distance`. - `fallbackSpeed: Optional` Fallback speed in km/h for pairs where no route exists. When set, unreachable pairs get estimated values instead of null. - `mode: Optional` Travel mode (default: `auto`) - `AUTO("auto")` - `FOOT("foot")` - `BICYCLE("bicycle")` ### Matrix Result - `class MatrixResult:` Distance matrix result. The exact response shape depends on the routing backend. Contains duration (and optionally distance) data for all origin-destination pairs. Null values indicate unreachable pairs. ### Nearest Result - `class NearestResult:` GeoJSON Point Feature representing the nearest point on the road network to the input coordinate. Used for snapping GPS coordinates to roads. - `geometry: GeoJsonGeometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `coordinates: Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `List` - `List>` - `List>>` - `List>>>` - `type: Type` Geometry type - `POINT("Point")` - `LINE_STRING("LineString")` - `POLYGON("Polygon")` - `MULTI_POINT("MultiPoint")` - `MULTI_LINE_STRING("MultiLineString")` - `MULTI_POLYGON("MultiPolygon")` - `properties: Properties` Snap result metadata - `distanceM: Optional` Distance from the input coordinate to the snapped point in meters - `edgeId: Optional` ID of the road network edge that was snapped to - `edgeLengthM: Optional` Length of the matched road edge in meters - `highway: Optional` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `osmWayId: Optional` OSM way ID of the matched road segment - `surface: Optional` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `type: Type` - `FEATURE("Feature")` ### Route Request - `class RouteRequest:` Request body for route calculation. Origin and destination are lat/lng coordinate objects. Supports optional waypoints, alternative routes, turn-by-turn steps, and EV routing parameters. - `destination: Destination` Geographic coordinate as a JSON object with `lat` and `lng` fields. - `lat: Double` Latitude in decimal degrees (-90 to 90) - `lng: Double` Longitude in decimal degrees (-180 to 180) - `origin: Origin` Geographic coordinate as a JSON object with `lat` and `lng` fields. - `lat: Double` Latitude in decimal degrees (-90 to 90) - `lng: Double` Longitude in decimal degrees (-180 to 180) - `alternatives: Optional` Number of alternative routes to return (0-3, default 0). When > 0, response is a FeatureCollection of route Features. - `annotations: Optional` Include per-edge annotations (speed, duration) on the route (default: false) - `departAt: Optional` Departure time for traffic-aware routing (ISO 8601) - `ev: Optional` Electric vehicle parameters for EV-aware routing - `batteryCapacityWh: Double` Total battery capacity in watt-hours (required for EV routing) - `connectorTypes: Optional>` Acceptable connector types (e.g. `["ccs", "chademo"]`) - `initialChargePct: Optional` Starting charge as a fraction 0-1 (default: 0.8) - `minChargePct: Optional` Minimum acceptable charge at destination as a fraction 0-1 (default: 0.10) - `minPowerKw: Optional` Minimum charger power in kilowatts - `exclude: Optional` Comma-separated road types to exclude (e.g. `toll,motorway,ferry`) - `geometries: Optional` Geometry encoding format. Default: `geojson`. - `GEOJSON("geojson")` - `POLYLINE("polyline")` - `POLYLINE6("polyline6")` - `mode: Optional` Travel mode (default: `auto`) - `AUTO("auto")` - `FOOT("foot")` - `BICYCLE("bicycle")` - `overview: Optional` Level of geometry detail: `full` (all points), `simplified` (Douglas-Peucker), `false` (no geometry). Default: `full`. - `FULL("full")` - `SIMPLIFIED("simplified")` - `FALSE("false")` - `steps: Optional` Include turn-by-turn navigation steps (default: false) - `trafficModel: Optional` Traffic prediction model (only used when `depart_at` is set) - `BEST_GUESS("best_guess")` - `OPTIMISTIC("optimistic")` - `PESSIMISTIC("pessimistic")` - `waypoints: Optional>` Intermediate waypoints to visit in order (maximum 25) - `lat: Double` Latitude in decimal degrees (-90 to 90) - `lng: Double` Longitude in decimal degrees (-180 to 180) ### Route Result - `class RouteResult:` GeoJSON Feature representing a calculated route. The geometry is a LineString or MultiLineString of the route path. When `alternatives > 0`, the response is a FeatureCollection containing multiple route Features. - `geometry: GeoJsonGeometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `coordinates: Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `List` - `List>` - `List>>` - `List>>>` - `type: Type` Geometry type - `POINT("Point")` - `LINE_STRING("LineString")` - `POLYGON("Polygon")` - `MULTI_POINT("MultiPoint")` - `MULTI_LINE_STRING("MultiLineString")` - `MULTI_POLYGON("MultiPolygon")` - `properties: Properties` Route metadata - `distanceM: Double` Total route distance in meters - `durationS: Double` Estimated travel duration in seconds - `annotations: Optional` Per-edge annotations (present when `annotations: true` in request) - `chargeProfile: Optional>>` Battery charge level at route waypoints as [distance_fraction, charge_pct] pairs (EV routes only) - `chargingStops: Optional>` Recommended charging stops along the route (EV routes only) - `edges: Optional>` Edge-level route details (present when `annotations: true`) - `energyUsedWh: Optional` Total energy consumed in watt-hours (EV routes only) - `type: Type` - `FEATURE("Feature")`