# Routing ## Calculate a route between two points `RouteResult routing().route(RoutingRouteParamsparams, RequestOptionsrequestOptions = RequestOptions.none())` **post** `/api/v1/route` Calculate a route between two points ### Parameters - `RoutingRouteParams params` - `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. - `GeoJsonGeometry geometry` 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 - `double distanceM` Total route distance in meters - `double durationS` Estimated travel duration in seconds - `Optional annotations` Per-edge annotations (present when `annotations: true` in request) - `Optional>> chargeProfile` Battery charge level at route waypoints as [distance_fraction, charge_pct] pairs (EV routes only) - `Optional> chargingStops` Recommended charging stops along the route (EV routes only) - `Optional> edges` Edge-level route details (present when `annotations: true`) - `Optional energyUsedWh` Total energy consumed in watt-hours (EV routes only) - `Type type` - `FEATURE("Feature")` ### Example ```java 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; public final class Main { private Main() {} public static void main(String[] args) { PlazaClient client = PlazaOkHttpClient.fromEnv(); RouteRequest params = 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(); 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 `NearestResult routing().nearest(RoutingNearestParamsparams, RequestOptionsrequestOptions = RequestOptions.none())` **get** `/api/v1/nearest` Snap a coordinate to the nearest road ### Parameters - `RoutingNearestParams params` - `double lat` Latitude - `double lng` Longitude - `Optional outputFields` Comma-separated property fields to include - `Optional outputInclude` Extra computed fields: bbox, distance, center - `Optional outputPrecision` Coordinate decimal precision (1-15, default 7) - `Optional radius` 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. - `GeoJsonGeometry geometry` 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 - `Optional distanceM` Distance from the input coordinate to the snapped point in meters - `Optional edgeId` ID of the road network edge that was snapped to - `Optional edgeLengthM` Length of the matched road edge in meters - `Optional highway` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `Optional osmWayId` OSM way ID of the matched road segment - `Optional surface` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `Type type` - `FEATURE("Feature")` ### Example ```java 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; public final class Main { private Main() {} public static void main(String[] args) { PlazaClient client = PlazaOkHttpClient.fromEnv(); RoutingNearestParams params = RoutingNearestParams.builder() .lat(0.0) .lng(0.0) .build(); 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 `NearestResult routing().nearestPost(RoutingNearestPostParamsparams, RequestOptionsrequestOptions = RequestOptions.none())` **post** `/api/v1/nearest` Snap a coordinate to the nearest road ### Parameters - `RoutingNearestPostParams params` - `double lat` Latitude - `double lng` Longitude - `Optional outputFields` Comma-separated property fields to include - `Optional outputInclude` Extra computed fields: bbox, distance, center - `Optional outputPrecision` Coordinate decimal precision (1-15, default 7) - `Optional radius` 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. - `GeoJsonGeometry geometry` 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 - `Optional distanceM` Distance from the input coordinate to the snapped point in meters - `Optional edgeId` ID of the road network edge that was snapped to - `Optional edgeLengthM` Length of the matched road edge in meters - `Optional highway` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `Optional osmWayId` OSM way ID of the matched road segment - `Optional surface` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `Type type` - `FEATURE("Feature")` ### Example ```java 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; public final class Main { private Main() {} public static void main(String[] args) { PlazaClient client = PlazaOkHttpClient.fromEnv(); RoutingNearestPostParams params = RoutingNearestPostParams.builder() .lat(0.0) .lng(0.0) .build(); 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 `RoutingIsochroneResponse routing().isochrone(RoutingIsochroneParamsparams, RequestOptionsrequestOptions = RequestOptions.none())` **get** `/api/v1/isochrone` Calculate an isochrone from a point ### Parameters - `RoutingIsochroneParams params` - `double lat` Latitude - `double lng` Longitude - `double time` Travel time in seconds (1-7200) - `Optional mode` Travel mode (auto, foot, bicycle) - `Optional outputFields` Comma-separated property fields to include - `Optional outputGeometry` Include geometry (default true) - `Optional outputInclude` Extra computed fields: bbox, center - `Optional outputPrecision` Coordinate decimal precision (1-15, default 7) - `Optional outputSimplify` 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. - `Optional> features` Array of isochrone polygon Features (multi-contour only) - `GeoJsonGeometry geometry` 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")` - `Optional id` Compound identifier in `type/osm_id` format - `Optional geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `Optional properties` Isochrone metadata - `Optional areaM2` Area of the isochrone polygon in square meters (multi-contour features only) - `Optional maxCostS` Maximum actual travel cost in seconds to the isochrone boundary (single contour only) - `Optional mode` Travel mode used for the isochrone calculation - `AUTO("auto")` - `FOOT("foot")` - `BICYCLE("bicycle")` - `Optional timeSeconds` Travel time budget in seconds - `Optional verticesReached` Number of road network vertices within the isochrone - `Optional type` `Feature` for single contour, `FeatureCollection` for multiple contours - `FEATURE("Feature")` - `FEATURE_COLLECTION("FeatureCollection")` ### Example ```java 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; public final class Main { private Main() {} public static void main(String[] args) { PlazaClient client = PlazaOkHttpClient.fromEnv(); RoutingIsochroneParams params = RoutingIsochroneParams.builder() .lat(0.0) .lng(0.0) .time(0.0) .build(); RoutingIsochroneResponse response = 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 `RoutingIsochronePostResponse routing().isochronePost(RoutingIsochronePostParamsparams, RequestOptionsrequestOptions = RequestOptions.none())` **post** `/api/v1/isochrone` Calculate an isochrone from a point ### Parameters - `RoutingIsochronePostParams params` - `double lat` Latitude - `double lng` Longitude - `double time` Travel time in seconds (1-7200) - `Optional mode` Travel mode (auto, foot, bicycle) - `Optional outputFields` Comma-separated property fields to include - `Optional outputGeometry` Include geometry (default true) - `Optional outputInclude` Extra computed fields: bbox, center - `Optional outputPrecision` Coordinate decimal precision (1-15, default 7) - `Optional outputSimplify` 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. - `Optional> features` Array of isochrone polygon Features (multi-contour only) - `GeoJsonGeometry geometry` 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")` - `Optional id` Compound identifier in `type/osm_id` format - `Optional geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `Optional properties` Isochrone metadata - `Optional areaM2` Area of the isochrone polygon in square meters (multi-contour features only) - `Optional maxCostS` Maximum actual travel cost in seconds to the isochrone boundary (single contour only) - `Optional mode` Travel mode used for the isochrone calculation - `AUTO("auto")` - `FOOT("foot")` - `BICYCLE("bicycle")` - `Optional timeSeconds` Travel time budget in seconds - `Optional verticesReached` Number of road network vertices within the isochrone - `Optional type` `Feature` for single contour, `FeatureCollection` for multiple contours - `FEATURE("Feature")` - `FEATURE_COLLECTION("FeatureCollection")` ### Example ```java 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; public final class Main { private Main() {} public static void main(String[] args) { PlazaClient client = PlazaOkHttpClient.fromEnv(); RoutingIsochronePostParams params = RoutingIsochronePostParams.builder() .lat(0.0) .lng(0.0) .time(0.0) .build(); RoutingIsochronePostResponse response = 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 `MatrixResult routing().matrix(RoutingMatrixParamsparams, RequestOptionsrequestOptions = RequestOptions.none())` **post** `/api/v1/matrix` Calculate a distance matrix between points ### Parameters - `RoutingMatrixParams params` - `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 ```java 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; public final class Main { private Main() {} public static void main(String[] args) { PlazaClient client = PlazaOkHttpClient.fromEnv(); MatrixRequest params = 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(); 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. - `List destinations` Array of destination coordinates (max 50) - `double lat` Latitude in decimal degrees (-90 to 90) - `double lng` Longitude in decimal degrees (-180 to 180) - `List origins` Array of origin coordinates (max 50) - `double lat` Latitude in decimal degrees (-90 to 90) - `double lng` Longitude in decimal degrees (-180 to 180) - `Optional annotations` Comma-separated list of annotations to include: `duration` (always included), `distance`. Example: `duration,distance`. - `Optional fallbackSpeed` Fallback speed in km/h for pairs where no route exists. When set, unreachable pairs get estimated values instead of null. - `Optional mode` 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. - `GeoJsonGeometry geometry` 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 - `Optional distanceM` Distance from the input coordinate to the snapped point in meters - `Optional edgeId` ID of the road network edge that was snapped to - `Optional edgeLengthM` Length of the matched road edge in meters - `Optional highway` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `Optional osmWayId` OSM way ID of the matched road segment - `Optional surface` 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. - `double lat` Latitude in decimal degrees (-90 to 90) - `double lng` Longitude in decimal degrees (-180 to 180) - `Origin origin` Geographic coordinate as a JSON object with `lat` and `lng` fields. - `double lat` Latitude in decimal degrees (-90 to 90) - `double lng` Longitude in decimal degrees (-180 to 180) - `Optional alternatives` Number of alternative routes to return (0-3, default 0). When > 0, response is a FeatureCollection of route Features. - `Optional annotations` Include per-edge annotations (speed, duration) on the route (default: false) - `Optional departAt` Departure time for traffic-aware routing (ISO 8601) - `Optional ev` Electric vehicle parameters for EV-aware routing - `double batteryCapacityWh` Total battery capacity in watt-hours (required for EV routing) - `Optional> connectorTypes` Acceptable connector types (e.g. `["ccs", "chademo"]`) - `Optional initialChargePct` Starting charge as a fraction 0-1 (default: 0.8) - `Optional minChargePct` Minimum acceptable charge at destination as a fraction 0-1 (default: 0.10) - `Optional minPowerKw` Minimum charger power in kilowatts - `Optional exclude` Comma-separated road types to exclude (e.g. `toll,motorway,ferry`) - `Optional geometries` Geometry encoding format. Default: `geojson`. - `GEOJSON("geojson")` - `POLYLINE("polyline")` - `POLYLINE6("polyline6")` - `Optional mode` Travel mode (default: `auto`) - `AUTO("auto")` - `FOOT("foot")` - `BICYCLE("bicycle")` - `Optional overview` Level of geometry detail: `full` (all points), `simplified` (Douglas-Peucker), `false` (no geometry). Default: `full`. - `FULL("full")` - `SIMPLIFIED("simplified")` - `FALSE("false")` - `Optional steps` Include turn-by-turn navigation steps (default: false) - `Optional trafficModel` Traffic prediction model (only used when `depart_at` is set) - `BEST_GUESS("best_guess")` - `OPTIMISTIC("optimistic")` - `PESSIMISTIC("pessimistic")` - `Optional> waypoints` Intermediate waypoints to visit in order (maximum 25) - `double lat` Latitude in decimal degrees (-90 to 90) - `double lng` 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. - `GeoJsonGeometry geometry` 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 - `double distanceM` Total route distance in meters - `double durationS` Estimated travel duration in seconds - `Optional annotations` Per-edge annotations (present when `annotations: true` in request) - `Optional>> chargeProfile` Battery charge level at route waypoints as [distance_fraction, charge_pct] pairs (EV routes only) - `Optional> chargingStops` Recommended charging stops along the route (EV routes only) - `Optional> edges` Edge-level route details (present when `annotations: true`) - `Optional energyUsedWh` Total energy consumed in watt-hours (EV routes only) - `Type type` - `FEATURE("Feature")`