Amazon Location Service Routes V2

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-145615375.2 KB

Calculates areas that can be reached within specified time or distance thresholds from a given point. For example, you can use this operation to determine the area within a 30-minute drive of a store location, find neighborhoods within walking distance of a school, or identify delivery zones based on drive time.

Isolines (also known as isochrones for time-based calculations) are useful for various applications including:

Service area visualization - Show customers the area you can serve within promised delivery times
Site selection - Analyze potential business locations based on population within travel distance
Site selection - Determine areas that can be reached within specified response times

Route preferences such as avoiding toll roads or ferries are treated as preferences rather than absolute restrictions. If a viable route cannot be calculated while honoring all preferences, some may be ignored.

For more information, see Calculate isolines in the Amazon Location Service Developer Guide.

post/v2/isolines

Query parameters

keystring password

An Amazon Location Service API Key with access to this action. If omitted, the request must be signed using Signature Version 4.

Request body

ArrivalTimestring password

Determine areas from which <code>Destination</code> can be reached by this time, taking into account predicted traffic conditions and working backward to account for congestion patterns. This attribute cannot be used together with <code>DepartureTime</code> or <code>DepartNow</code>. Specified as an ISO-8601 timestamp with timezone offset. Time format: <code>YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm</code> Examples: <code>2020-04-22T17:57:24Z</code> <code>2020-04-22T17:57:24+02:00</code>

DepartNowboolean

When true, uses the current time as the departure time and takes current traffic conditions into account. This attribute cannot be used together with <code>DepartureTime</code> or <code>ArrivalTime</code>.

DepartureTimestring password

Determine areas that can be reached when departing at this time, taking into account predicted traffic conditions. This attribute cannot be used together with <code>ArrivalTime</code> or <code>DepartNow</code>. Specified as an ISO-8601 timestamp with timezone offset. Time format:<code>YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm</code> Examples: <code>2020-04-22T17:57:24Z</code> <code>2020-04-22T17:57:24+02:00</code>

DestinationDouble[]

An optional destination point, specified as <code>[longitude, latitude]</code> coordinates. When provided, the service calculates areas from which this destination can be reached within the specified thresholds. This reverses the usual isoline calculation to show areas that could reach your location, rather than areas you could reach from your location. Either <code>Origin</code> or <code>Destination</code> must be provided.

IsolineGeometryFormat'FlexiblePolyline' | 'Simple'

The format of the returned IsolineGeometry. Default value:<code>FlexiblePolyline</code>

OptimizeIsolineFor'AccurateCalculation' | 'BalancedCalculation' | 'FastCalculation'

Controls the trade-off between calculation speed and isoline precision. Choose <code> FastCalculation</code> for quicker results with less detail, <code>AccurateCalculation</code> for more precise results, or <code>BalancedCalculation</code> for a middle ground. Default value: <code>BalancedCalculation</code>

OptimizeRoutingFor'FastestRoute' | 'ShortestRoute'

Determines whether routes prioritize shortest travel time (<code>FastestRoute</code>) or shortest physical distance (<code>ShortestRoute</code>) when calculating reachable areas. Default value: <code>FastestRoute</code>

OriginDouble[]

The starting point for isoline calculations, specified as <code>[longitude, latitude]</code> coordinates. For example, this could be a store location, service center, or any point from which you want to calculate reachable areas. Either <code>Origin</code> or <code>Destination</code> must be provided.

TravelMode'Car' | 'Pedestrian' | 'Scooter' | 'Truck'

The mode of transportation to use for calculations. This affects which road types or features can be used, estimated speed, and the traffic levels that are applied. <ul> <li> <code>Car</code>—Standard passenger vehicle routing using roads accessible to cars </li> <li> <code>Pedestrian</code>—Walking routes using pedestrian paths, sidewalks, and crossings </li> <li> <code>Scooter</code>—Light two-wheeled vehicle routing using roads and paths accessible to scooters </li> <li> <code>Truck</code>—Commercial truck routing considering vehicle dimensions, weight restrictions, and hazardous material regulations </li> </ul> <note> The mode <code>Scooter</code> also applies to motorcycles; set this to <code>Scooter</code> when calculating isolines for motorcycles. </note> Default value: <code>Car</code>

Response

Success

ArrivalTimestring password

Time of arrival at the destination, used for traffic calculations. This attribute is returned only if the <code>Destination</code> and <code>ArrivalTime</code> attributes were provided in the request. Time format: <code>YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm</code> Examples: <code>2020-04-22T17:57:24Z</code> <code>2020-04-22T17:57:24+02:00</code>

DepartureTimestring password

Time of departure from the origin, used for traffic calculations. This attribute is returned when <code>Origin</code> was provided in the request and either a specific departure time was requested (<code>DepartureTime</code>) or <code>DepartNow</code> was set to true. Time format: <code>YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm</code> Examples: <code>2020-04-22T17:57:24Z</code> <code>2020-04-22T17:57:24+02:00</code>

IsolineGeometryFormat'FlexiblePolyline' | 'Simple' required

The format of the returned geometries, matching the format specified in the request. Either <code> FlexiblePolyline</code> for compact encoding or <code>Simple</code> for GeoJSON-compatible coordinates. Default value:<code>FlexiblePolyline</code>

SnappedDestinationDouble[]

The actual point on the road network used for calculations, which may differ from the requested destination if <code>Destination</code> was not directly on a road.

SnappedOriginDouble[]

The actual point on the road network used for calculations, which may differ from the requested origin if <code>Origin</code> was not directly on a road.

All 5 operations