# Routing ## Calculate a route between two points `RouteResult Routing.Route(RoutingRouteParamsparameters, CancellationTokencancellationToken = default)` **post** `/api/v1/route` Calculate a route between two points ### Parameters - `RoutingRouteParams parameters` - `required Destination destination` Geographic coordinate as a JSON object with `lat` and `lng` fields. - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `required Origin origin` Geographic coordinate as a JSON object with `lat` and `lng` fields. - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `Long alternatives` Number of alternative routes to return (0-3, default 0). When > 0, response is a FeatureCollection of route Features. - `Boolean annotations` Include per-edge annotations (speed, duration) on the route (default: false) - `DateTimeOffset? departAt` Departure time for traffic-aware routing (ISO 8601) - `Ev? ev` Electric vehicle parameters for EV-aware routing - `required Double BatteryCapacityWh` Total battery capacity in watt-hours (required for EV routing) - `IReadOnlyList? ConnectorTypes` Acceptable connector types (e.g. `["ccs", "chademo"]`) - `Double InitialChargePct` Starting charge as a fraction 0-1 (default: 0.8) - `Double MinChargePct` Minimum acceptable charge at destination as a fraction 0-1 (default: 0.10) - `Double? MinPowerKw` Minimum charger power in kilowatts - `string? exclude` Comma-separated road types to exclude (e.g. `toll,motorway,ferry`) - `Geometries geometries` Geometry encoding format. Default: `geojson`. - `"geojson"Geojson` - `"polyline"Polyline` - `"polyline6"Polyline6` - `Mode mode` Travel mode (default: `auto`) - `"auto"Auto` - `"foot"Foot` - `"bicycle"Bicycle` - `Overview overview` Level of geometry detail: `full` (all points), `simplified` (Douglas-Peucker), `false` (no geometry). Default: `full`. - `"full"Full` - `"simplified"Simplified` - `"false"False` - `Boolean steps` Include turn-by-turn navigation steps (default: false) - `TrafficModel? trafficModel` Traffic prediction model (only used when `depart_at` is set) - `"best_guess"BestGuess` - `"optimistic"Optimistic` - `"pessimistic"Pessimistic` - `IReadOnlyList? waypoints` Intermediate waypoints to visit in order (maximum 25) - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) ### 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. - `required GeoJsonGeometry Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `required Coordinates Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `IReadOnlyList` - `IReadOnlyList>` - `IReadOnlyList>>` - `IReadOnlyList>>>` - `required Type Type` Geometry type - `"Point"Point` - `"LineString"LineString` - `"Polygon"Polygon` - `"MultiPoint"MultiPoint` - `"MultiLineString"MultiLineString` - `"MultiPolygon"MultiPolygon` - `required Properties Properties` Route metadata - `required Double DistanceM` Total route distance in meters - `required Double DurationS` Estimated travel duration in seconds - `IReadOnlyDictionary? Annotations` Per-edge annotations (present when `annotations: true` in request) - `IReadOnlyList>? ChargeProfile` Battery charge level at route waypoints as [distance_fraction, charge_pct] pairs (EV routes only) - `IReadOnlyList>? ChargingStops` Recommended charging stops along the route (EV routes only) - `IReadOnlyList>? Edges` Edge-level route details (present when `annotations: true`) - `Double? EnergyUsedWh` Total energy consumed in watt-hours (EV routes only) - `required Type Type` - `"Feature"Feature` ### Example ```csharp RoutingRouteParams parameters = new() { Destination = new() { Lat = 48.8584, Lng = 2.2945, }, Origin = new() { Lat = 48.8566, Lng = 2.3522, }, }; var routeResult = await client.Routing.Route(parameters); Console.WriteLine(routeResult); ``` #### 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(RoutingNearestParamsparameters, CancellationTokencancellationToken = default)` **get** `/api/v1/nearest` Snap a coordinate to the nearest road ### Parameters - `RoutingNearestParams parameters` - `required Double lat` Latitude - `required Double lng` Longitude - `string outputFields` Comma-separated property fields to include - `string outputInclude` Extra computed fields: bbox, distance, center - `Long outputPrecision` Coordinate decimal precision (1-15, default 7) - `Long 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. - `required GeoJsonGeometry Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `required Coordinates Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `IReadOnlyList` - `IReadOnlyList>` - `IReadOnlyList>>` - `IReadOnlyList>>>` - `required Type Type` Geometry type - `"Point"Point` - `"LineString"LineString` - `"Polygon"Polygon` - `"MultiPoint"MultiPoint` - `"MultiLineString"MultiLineString` - `"MultiPolygon"MultiPolygon` - `required Properties Properties` Snap result metadata - `Double DistanceM` Distance from the input coordinate to the snapped point in meters - `Long EdgeID` ID of the road network edge that was snapped to - `Double EdgeLengthM` Length of the matched road edge in meters - `string? Highway` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `Long OsmWayID` OSM way ID of the matched road segment - `string? Surface` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `required Type Type` - `"Feature"Feature` ### Example ```csharp RoutingNearestParams parameters = new() { Lat = 0, Lng = 0, }; var nearestResult = await client.Routing.Nearest(parameters); Console.WriteLine(nearestResult); ``` #### 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(RoutingNearestPostParamsparameters, CancellationTokencancellationToken = default)` **post** `/api/v1/nearest` Snap a coordinate to the nearest road ### Parameters - `RoutingNearestPostParams parameters` - `required Double lat` Latitude - `required Double lng` Longitude - `string outputFields` Comma-separated property fields to include - `string outputInclude` Extra computed fields: bbox, distance, center - `Long outputPrecision` Coordinate decimal precision (1-15, default 7) - `Long 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. - `required GeoJsonGeometry Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `required Coordinates Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `IReadOnlyList` - `IReadOnlyList>` - `IReadOnlyList>>` - `IReadOnlyList>>>` - `required Type Type` Geometry type - `"Point"Point` - `"LineString"LineString` - `"Polygon"Polygon` - `"MultiPoint"MultiPoint` - `"MultiLineString"MultiLineString` - `"MultiPolygon"MultiPolygon` - `required Properties Properties` Snap result metadata - `Double DistanceM` Distance from the input coordinate to the snapped point in meters - `Long EdgeID` ID of the road network edge that was snapped to - `Double EdgeLengthM` Length of the matched road edge in meters - `string? Highway` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `Long OsmWayID` OSM way ID of the matched road segment - `string? Surface` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `required Type Type` - `"Feature"Feature` ### Example ```csharp RoutingNearestPostParams parameters = new() { Lat = 0, Lng = 0, }; var nearestResult = await client.Routing.NearestPost(parameters); Console.WriteLine(nearestResult); ``` #### 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(RoutingIsochroneParamsparameters, CancellationTokencancellationToken = default)` **get** `/api/v1/isochrone` Calculate an isochrone from a point ### Parameters - `RoutingIsochroneParams parameters` - `required Double lat` Latitude - `required Double lng` Longitude - `required Double time` Travel time in seconds (1-7200) - `string mode` Travel mode (auto, foot, bicycle) - `string outputFields` Comma-separated property fields to include - `Boolean outputGeometry` Include geometry (default true) - `string outputInclude` Extra computed fields: bbox, center - `Long outputPrecision` Coordinate decimal precision (1-15, default 7) - `Double 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. - `IReadOnlyList? Features` Array of isochrone polygon Features (multi-contour only) - `required GeoJsonGeometry Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `required Coordinates Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `IReadOnlyList` - `IReadOnlyList>` - `IReadOnlyList>>` - `IReadOnlyList>>>` - `required Type Type` Geometry type - `"Point"Point` - `"LineString"LineString` - `"Polygon"Polygon` - `"MultiPoint"MultiPoint` - `"MultiLineString"MultiLineString` - `"MultiPolygon"MultiPolygon` - `required IReadOnlyDictionary 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. - `required Type Type` Always `Feature` - `"Feature"Feature` - `string ID` Compound identifier in `type/osm_id` format - `GeoJsonGeometry? Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `Properties? Properties` Isochrone metadata - `Double? AreaM2` Area of the isochrone polygon in square meters (multi-contour features only) - `Double? MaxCostS` Maximum actual travel cost in seconds to the isochrone boundary (single contour only) - `Mode Mode` Travel mode used for the isochrone calculation - `"auto"Auto` - `"foot"Foot` - `"bicycle"Bicycle` - `Double TimeSeconds` Travel time budget in seconds - `Long VerticesReached` Number of road network vertices within the isochrone - `Type Type` `Feature` for single contour, `FeatureCollection` for multiple contours - `"Feature"Feature` - `"FeatureCollection"FeatureCollection` ### Example ```csharp RoutingIsochroneParams parameters = new() { Lat = 0, Lng = 0, Time = 0, }; var response = await client.Routing.Isochrone(parameters); Console.WriteLine(response); ``` #### 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(RoutingIsochronePostParamsparameters, CancellationTokencancellationToken = default)` **post** `/api/v1/isochrone` Calculate an isochrone from a point ### Parameters - `RoutingIsochronePostParams parameters` - `required Double lat` Latitude - `required Double lng` Longitude - `required Double time` Travel time in seconds (1-7200) - `string mode` Travel mode (auto, foot, bicycle) - `string outputFields` Comma-separated property fields to include - `Boolean outputGeometry` Include geometry (default true) - `string outputInclude` Extra computed fields: bbox, center - `Long outputPrecision` Coordinate decimal precision (1-15, default 7) - `Double 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. - `IReadOnlyList? Features` Array of isochrone polygon Features (multi-contour only) - `required GeoJsonGeometry Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `required Coordinates Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `IReadOnlyList` - `IReadOnlyList>` - `IReadOnlyList>>` - `IReadOnlyList>>>` - `required Type Type` Geometry type - `"Point"Point` - `"LineString"LineString` - `"Polygon"Polygon` - `"MultiPoint"MultiPoint` - `"MultiLineString"MultiLineString` - `"MultiPolygon"MultiPolygon` - `required IReadOnlyDictionary 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. - `required Type Type` Always `Feature` - `"Feature"Feature` - `string ID` Compound identifier in `type/osm_id` format - `GeoJsonGeometry? Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `Properties? Properties` Isochrone metadata - `Double? AreaM2` Area of the isochrone polygon in square meters (multi-contour features only) - `Double? MaxCostS` Maximum actual travel cost in seconds to the isochrone boundary (single contour only) - `Mode Mode` Travel mode used for the isochrone calculation - `"auto"Auto` - `"foot"Foot` - `"bicycle"Bicycle` - `Double TimeSeconds` Travel time budget in seconds - `Long VerticesReached` Number of road network vertices within the isochrone - `Type Type` `Feature` for single contour, `FeatureCollection` for multiple contours - `"Feature"Feature` - `"FeatureCollection"FeatureCollection` ### Example ```csharp RoutingIsochronePostParams parameters = new() { Lat = 0, Lng = 0, Time = 0, }; var response = await client.Routing.IsochronePost(parameters); Console.WriteLine(response); ``` #### 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 `IReadOnlyDictionary Routing.Matrix(RoutingMatrixParamsparameters, CancellationTokencancellationToken = default)` **post** `/api/v1/matrix` Calculate a distance matrix between points ### Parameters - `RoutingMatrixParams parameters` - `required IReadOnlyList destinations` Array of destination coordinates (max 50) - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `required IReadOnlyList origins` Array of origin coordinates (max 50) - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `string annotations` Comma-separated list of annotations to include: `duration` (always included), `distance`. Example: `duration,distance`. - `Double? fallbackSpeed` Fallback speed in km/h for pairs where no route exists. When set, unreachable pairs get estimated values instead of null. - `Mode mode` Travel mode (default: `auto`) - `"auto"Auto` - `"foot"Foot` - `"bicycle"Bicycle` ### Returns - `IReadOnlyDictionary` ### Example ```csharp RoutingMatrixParams parameters = new() { Destinations = [ new() { Lat = 48.8584, Lng = 2.2945, }, ], Origins = [ new() { Lat = 48.8566, Lng = 2.3522, }, new() { Lat = 48.8606, Lng = 2.3376, }, ], }; var matrixResult = await client.Routing.Matrix(parameters); Console.WriteLine(matrixResult); ``` #### 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. - `required IReadOnlyList Destinations` Array of destination coordinates (max 50) - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `required IReadOnlyList Origins` Array of origin coordinates (max 50) - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `string Annotations` Comma-separated list of annotations to include: `duration` (always included), `distance`. Example: `duration,distance`. - `Double? FallbackSpeed` Fallback speed in km/h for pairs where no route exists. When set, unreachable pairs get estimated values instead of null. - `Mode Mode` Travel mode (default: `auto`) - `"auto"Auto` - `"foot"Foot` - `"bicycle"Bicycle` ### 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. - `required GeoJsonGeometry Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `required Coordinates Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `IReadOnlyList` - `IReadOnlyList>` - `IReadOnlyList>>` - `IReadOnlyList>>>` - `required Type Type` Geometry type - `"Point"Point` - `"LineString"LineString` - `"Polygon"Polygon` - `"MultiPoint"MultiPoint` - `"MultiLineString"MultiLineString` - `"MultiPolygon"MultiPolygon` - `required Properties Properties` Snap result metadata - `Double DistanceM` Distance from the input coordinate to the snapped point in meters - `Long EdgeID` ID of the road network edge that was snapped to - `Double EdgeLengthM` Length of the matched road edge in meters - `string? Highway` OSM highway tag value (e.g. `residential`, `primary`, `motorway`) - `Long OsmWayID` OSM way ID of the matched road segment - `string? Surface` OSM surface tag value (e.g. `asphalt`, `gravel`, `paved`) - `required 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. - `required Destination Destination` Geographic coordinate as a JSON object with `lat` and `lng` fields. - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `required Origin Origin` Geographic coordinate as a JSON object with `lat` and `lng` fields. - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required Double Lng` Longitude in decimal degrees (-180 to 180) - `Long Alternatives` Number of alternative routes to return (0-3, default 0). When > 0, response is a FeatureCollection of route Features. - `Boolean Annotations` Include per-edge annotations (speed, duration) on the route (default: false) - `DateTimeOffset? DepartAt` Departure time for traffic-aware routing (ISO 8601) - `Ev? Ev` Electric vehicle parameters for EV-aware routing - `required Double BatteryCapacityWh` Total battery capacity in watt-hours (required for EV routing) - `IReadOnlyList? ConnectorTypes` Acceptable connector types (e.g. `["ccs", "chademo"]`) - `Double InitialChargePct` Starting charge as a fraction 0-1 (default: 0.8) - `Double MinChargePct` Minimum acceptable charge at destination as a fraction 0-1 (default: 0.10) - `Double? MinPowerKw` Minimum charger power in kilowatts - `string? Exclude` Comma-separated road types to exclude (e.g. `toll,motorway,ferry`) - `Geometries Geometries` Geometry encoding format. Default: `geojson`. - `"geojson"Geojson` - `"polyline"Polyline` - `"polyline6"Polyline6` - `Mode Mode` Travel mode (default: `auto`) - `"auto"Auto` - `"foot"Foot` - `"bicycle"Bicycle` - `Overview Overview` Level of geometry detail: `full` (all points), `simplified` (Douglas-Peucker), `false` (no geometry). Default: `full`. - `"full"Full` - `"simplified"Simplified` - `"false"False` - `Boolean Steps` Include turn-by-turn navigation steps (default: false) - `TrafficModel? TrafficModel` Traffic prediction model (only used when `depart_at` is set) - `"best_guess"BestGuess` - `"optimistic"Optimistic` - `"pessimistic"Pessimistic` - `IReadOnlyList? Waypoints` Intermediate waypoints to visit in order (maximum 25) - `required Double Lat` Latitude in decimal degrees (-90 to 90) - `required 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. - `required GeoJsonGeometry Geometry` GeoJSON Geometry object per RFC 7946. Coordinates use [longitude, latitude] order. 3D coordinates [lng, lat, elevation] are used for elevation endpoints. - `required Coordinates Coordinates` Coordinates array. Nesting depth varies by geometry type: Point = [lng, lat], LineString = [[lng, lat], ...], Polygon = [[[lng, lat], ...], ...], etc. - `IReadOnlyList` - `IReadOnlyList>` - `IReadOnlyList>>` - `IReadOnlyList>>>` - `required Type Type` Geometry type - `"Point"Point` - `"LineString"LineString` - `"Polygon"Polygon` - `"MultiPoint"MultiPoint` - `"MultiLineString"MultiLineString` - `"MultiPolygon"MultiPolygon` - `required Properties Properties` Route metadata - `required Double DistanceM` Total route distance in meters - `required Double DurationS` Estimated travel duration in seconds - `IReadOnlyDictionary? Annotations` Per-edge annotations (present when `annotations: true` in request) - `IReadOnlyList>? ChargeProfile` Battery charge level at route waypoints as [distance_fraction, charge_pct] pairs (EV routes only) - `IReadOnlyList>? ChargingStops` Recommended charging stops along the route (EV routes only) - `IReadOnlyList>? Edges` Edge-level route details (present when `annotations: true`) - `Double? EnergyUsedWh` Total energy consumed in watt-hours (EV routes only) - `required Type Type` - `"Feature"Feature`