Calculating routes with Routes (V1)
Important
This page documents the previous Routes API (V1). Use it only for existing applications. The Routes V2 API is the latest version. Use it for all new applications; see the latest Amazon Location Service Routes developer guide.
The latest API is CalculateRoutes (plural). This operation is under
the geo-routes namespace. It is exposed as
@aws-sdk/client-geo-routes for JavaScript and
boto3.client('geo-routes') for Python.
The CalculateRoute, CalculateRouteMatrix, and
RouteCalculator resources described below are previous-generation. Use
them only for existing applications.
Amazon Location lets you select a data provider for calculating a route by creating and configuring a route calculator resource.
You can use the route calculator resource to calculate a route given specific parameters using the AWS SDK, or the REST API endpoints. Use this route calculator resource to calculate routes between an origin, a destination and up to 23 waypoints for different modes of transportation, avoidances, and traffic conditions.
You can also use the route calculator resource to create inputs for your route planning algorithms or products by calculating a route matrix. Calculate the travel time and travel distance between a set of departure positions and a set of destination positions. Route planning software can use that time and distance data to optimize a route or a set of routes; for example, if you are planning multiple delivery routes, and want to find the best route and time for each stop. You can calculate a matrix of routes for different modes of transportation, avoidances, and traffic conditions.
Note
For an overview of routing concepts, see Routes (V1) concepts.