The CalculateRoutes API helps you to find the best routes between origin and destination, as well as the best opportunities for driver resting. It supports travel modes such as car, truck, pedestrian and scooter. It also supports up to 25 waypoints (stopovers) including the origin and destination, with only a few constraints.
Potential use cases
-
Audit speed limit compliance: Stays aware of speed limits and compliance to them.
-
Inform the driver of the speed limit: Notifies the driver of the speed limit when it might not be clear otherwise.
Examples
- Sample request
-
{ "Origin": [ 13.055211, 52.704802 ], "Destination": [ 13.551910, 52.282705 ], "TravelMode": "Car", "SpanAdditionalFeatures": ["SpeedLimit"] } - Sample response
-
{ "LegGeometryFormat": "FlexiblePolyline", "Notices": [], "Routes": [ { "Legs": [ { "Geometry": { "Polyline": "Redacted" }, "TravelMode": "Car", "Type": "Vehicle", "VehicleLegDetails": { "AfterTravelSteps": [], "Arrival": { "Place": { "ChargingStation": false, "OriginalPosition": [ 13.55191, 52.282705 ], "Position": [ 13.5507836, 52.2859121 ] } }, "Departure": { "Place": { "ChargingStation": false, "OriginalPosition": [ 13.055211, 52.704802 ], "Position": [ 13.0555036, 52.7056073 ] } }, "Incidents": [], "Notices": [], "PassThroughWaypoints": [], "Spans": [ { "GeometryOffset": 0, "SpeedLimit": { "Unlimited": true } }, { "GeometryOffset": 151, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 167, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 195, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 220, "SpeedLimit": { "Unlimited": true } }, { "GeometryOffset": 356, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 358, "SpeedLimit": { "MaxSpeed": 100 } }, { "GeometryOffset": 368, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 384, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 639, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 701, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 726, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 805, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 839, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 1384, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 1393, "SpeedLimit": { "MaxSpeed": 50 } }, { "GeometryOffset": 1443, "SpeedLimit": { "MaxSpeed": 30.000001907348633 } }, { "GeometryOffset": 1454, "SpeedLimit": { "MaxSpeed": 50 } }, { "GeometryOffset": 1504, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 1513, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 1516, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 1555, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 1748, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 1904, "SpeedLimit": { "MaxSpeed": 100 } }, { "GeometryOffset": 1945, "SpeedLimit": { "Unlimited": true } }, { "GeometryOffset": 2006, "SpeedLimit": { "MaxSpeed": 70 } }, { "GeometryOffset": 2017, "SpeedLimit": { "MaxSpeed": 50 } }, { "GeometryOffset": 2033, "SpeedLimit": { "MaxSpeed": 30.000001907348633 } } ], "Tolls": [], "TollSystems": [], "TravelSteps": [ { "Distance": 9099, "Duration": 262, "ExitNumber": [], "GeometryOffset": 0, "Type": "Depart" }, { "Distance": 18849, "Duration": 800, "ExitNumber": [], "GeometryOffset": 162, "KeepStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "Type": "Keep" }, { "Distance": 4290, "Duration": 212, "ExitNumber": [], "ExitStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "GeometryOffset": 701, "Type": "Exit" }, { "Distance": 14418, "Duration": 651, "ExitNumber": [], "GeometryOffset": 828, "Type": "Continue" }, { "Distance": 1255, "Duration": 62, "ExitNumber": [], "ExitStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "GeometryOffset": 1359, "Type": "Exit" }, { "Distance": 1607, "Duration": 139, "ExitNumber": [], "GeometryOffset": 1393, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Left", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 934, "Duration": 92, "ExitNumber": [], "GeometryOffset": 1442, "Type": "Continue" }, { "Distance": 320, "Duration": 27, "ExitNumber": [], "GeometryOffset": 1473, "Type": "Continue" }, { "Distance": 320, "Duration": 33, "ExitNumber": [], "GeometryOffset": 1491, "Type": "Continue" }, { "Distance": 17863, "Duration": 680, "ExitNumber": [], "GeometryOffset": 1504, "RampStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "Type": "Ramp" }, { "Distance": 2888, "Duration": 95, "ExitNumber": [], "GeometryOffset": 1917, "Type": "Continue" }, { "Distance": 321, "Duration": 28, "ExitNumber": [], "ExitStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "GeometryOffset": 1977, "Type": "Exit" }, { "Distance": 549, "Duration": 41, "ExitNumber": [], "GeometryOffset": 2006, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Right", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 386, "Duration": 51, "ExitNumber": [], "GeometryOffset": 2023, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Left", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 98, "Duration": 15, "ExitNumber": [], "GeometryOffset": 2033, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Right", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 0, "Duration": 0, "ExitNumber": [], "GeometryOffset": 2036, "Type": "Arrive" } ], "TruckRoadTypes": [], "Zones": [] } } ], "MajorRoadLabels": [ { "RouteNumber": { "Language": "de", "Value": "A111" } }, { "RouteNumber": { "Language": "de", "Value": "A113" } } ] } ] } - cURL
-
curl --request POST \ --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \ --header 'Content-Type: application/json' \ --data '{ "Origin": [ 13.055211, 52.704802 ], "Destination": [ 13.551910, 52.282705 ], "TravelMode": "Car", "SpanAdditionalFeatures": ["SpeedLimit"] }' - AWS CLI
-
aws geo-routes calculate-routes --key ${YourKey} \ --origin 13.055211 52.704802 \ --destination 13.551910 52.282705 \ --travel-mode "Car" \ --span-additional-features "SpeedLimit"
Find speed limits in Car TravelMode
- Sample request
-
{ "Origin": [ 13.055211, 52.704802 ], "Destination": [ 13.551910, 52.282705 ], "TravelMode": "Car", "SpanAdditionalFeatures": ["SpeedLimit"] } - Sample response
-
{ "LegGeometryFormat": "FlexiblePolyline", "Notices": [], "Routes": [ { "Legs": [ { "Geometry": { "Polyline": "Redacted" }, "TravelMode": "Car", "Type": "Vehicle", "VehicleLegDetails": { "AfterTravelSteps": [], "Arrival": { "Place": { "ChargingStation": false, "OriginalPosition": [ 13.55191, 52.282705 ], "Position": [ 13.5507836, 52.2859121 ] } }, "Departure": { "Place": { "ChargingStation": false, "OriginalPosition": [ 13.055211, 52.704802 ], "Position": [ 13.0555036, 52.7056073 ] } }, "Incidents": [], "Notices": [], "PassThroughWaypoints": [], "Spans": [ { "GeometryOffset": 0, "SpeedLimit": { "Unlimited": true } }, { "GeometryOffset": 151, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 167, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 195, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 220, "SpeedLimit": { "Unlimited": true } }, { "GeometryOffset": 356, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 358, "SpeedLimit": { "MaxSpeed": 100 } }, { "GeometryOffset": 368, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 384, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 639, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 701, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 726, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 805, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 839, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 1384, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 1393, "SpeedLimit": { "MaxSpeed": 50 } }, { "GeometryOffset": 1443, "SpeedLimit": { "MaxSpeed": 30.000001907348633 } }, { "GeometryOffset": 1454, "SpeedLimit": { "MaxSpeed": 50 } }, { "GeometryOffset": 1504, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 1513, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 1516, "SpeedLimit": { "MaxSpeed": 60.000003814697266 } }, { "GeometryOffset": 1555, "SpeedLimit": { "MaxSpeed": 80 } }, { "GeometryOffset": 1748, "SpeedLimit": { "MaxSpeed": 120.00000762939453 } }, { "GeometryOffset": 1904, "SpeedLimit": { "MaxSpeed": 100 } }, { "GeometryOffset": 1945, "SpeedLimit": { "Unlimited": true } }, { "GeometryOffset": 2006, "SpeedLimit": { "MaxSpeed": 70 } }, { "GeometryOffset": 2017, "SpeedLimit": { "MaxSpeed": 50 } }, { "GeometryOffset": 2033, "SpeedLimit": { "MaxSpeed": 30.000001907348633 } } ], "Tolls": [], "TollSystems": [], "TravelSteps": [ { "Distance": 9099, "Duration": 262, "ExitNumber": [], "GeometryOffset": 0, "Type": "Depart" }, { "Distance": 18849, "Duration": 800, "ExitNumber": [], "GeometryOffset": 162, "KeepStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "Type": "Keep" }, { "Distance": 4290, "Duration": 212, "ExitNumber": [], "ExitStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "GeometryOffset": 701, "Type": "Exit" }, { "Distance": 14418, "Duration": 651, "ExitNumber": [], "GeometryOffset": 828, "Type": "Continue" }, { "Distance": 1255, "Duration": 62, "ExitNumber": [], "ExitStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "GeometryOffset": 1359, "Type": "Exit" }, { "Distance": 1607, "Duration": 139, "ExitNumber": [], "GeometryOffset": 1393, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Left", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 934, "Duration": 92, "ExitNumber": [], "GeometryOffset": 1442, "Type": "Continue" }, { "Distance": 320, "Duration": 27, "ExitNumber": [], "GeometryOffset": 1473, "Type": "Continue" }, { "Distance": 320, "Duration": 33, "ExitNumber": [], "GeometryOffset": 1491, "Type": "Continue" }, { "Distance": 17863, "Duration": 680, "ExitNumber": [], "GeometryOffset": 1504, "RampStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "Type": "Ramp" }, { "Distance": 2888, "Duration": 95, "ExitNumber": [], "GeometryOffset": 1917, "Type": "Continue" }, { "Distance": 321, "Duration": 28, "ExitNumber": [], "ExitStepDetails": { "Intersection": [], "SteeringDirection": "Right" }, "GeometryOffset": 1977, "Type": "Exit" }, { "Distance": 549, "Duration": 41, "ExitNumber": [], "GeometryOffset": 2006, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Right", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 386, "Duration": 51, "ExitNumber": [], "GeometryOffset": 2023, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Left", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 98, "Duration": 15, "ExitNumber": [], "GeometryOffset": 2033, "TurnStepDetails": { "Intersection": [], "SteeringDirection": "Right", "TurnIntensity": "Typical" }, "Type": "Turn" }, { "Distance": 0, "Duration": 0, "ExitNumber": [], "GeometryOffset": 2036, "Type": "Arrive" } ], "TruckRoadTypes": [], "Zones": [] } } ], "MajorRoadLabels": [ { "RouteNumber": { "Language": "de", "Value": "A111" } }, { "RouteNumber": { "Language": "de", "Value": "A113" } } ] } ] } - cURL
-
curl --request POST \ --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \ --header 'Content-Type: application/json' \ --data '{ "Origin": [ 13.055211, 52.704802 ], "Destination": [ 13.551910, 52.282705 ], "TravelMode": "Car", "SpanAdditionalFeatures": ["SpeedLimit"] }' - AWS CLI
-
aws geo-routes calculate-routes --key ${YourKey} \ --origin 13.055211 52.704802 \ --destination 13.551910 52.282705 \ --travel-mode "Car" \ --span-additional-features "SpeedLimit"
{
"Origin": [
13.055211,
52.704802
],
"Destination": [
13.551910,
52.282705
],
"TravelMode": "Car",
"SpanAdditionalFeatures": ["SpeedLimit"]
}
Find routes with turn-by-turn directions
Find an alternate route