本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
计算路由
您可以使用 Amazon Location Service 计算起点和目的地之间的路线,沿途有多达 23 个航点,适用于不同的交通方式、避开路径和交通状况。
您必须首先创建路径计算器资源,并为向亚马逊位置提出的请求设置身份验证。有关更多信息,请参阅先决条件:
开始计算路线
使用CalculateRoute
操作提交简单请求。一个简单的请求包含以下必填字段:
-
DeparturePosition
— 计算路线的起始位置。定义为[longitude, latitude]
-
DestinationPosition
— 计算路径的终点位置。定义为[longitude, latitude]
。
如果您指定的出发地或目的地位置不在道路上,Amazon Location 会将该位置移至最近的道路。
您可以使用AWS CLI或亚马逊位置 API。
默认情况下,响应以千米为Distance
单位返回。您可以使用以下可选参数将测量单位更改为英里:
-
DistanceUnit
— 指定用于距离结果的单位制。
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "DistanceUnit": "
Miles
" }
设置航点
计算路径时,您可以使用航点位置在出发位置和目的地位置之间指定最多 23 个中间中途停留点。
-
WaypointPositions
— 指定要在出发位置和目的地位置之间的路线上包含的中间位置的有序列表。注意 如果您指定的航点位置不在道路上,Amazon Location 会将该位置移至最近的道路。
以下CalculateRoute
请求计算一条包含 2 个航点的路线:
-
出发位置是 [-122.7565,49.0021],目的地位置是 [-122.3394,47.6159]。
-
对于请求参数
WaypointPositions
:-
头寸上的第一个止损点是 [
-122.1884,48.0936
]。 -
第二个止损位是 [
-122.3493,47.6205
]。
-
-
要包括这两个航点之间的腿部线串几何形状,请将以下可选参数设置为
true
:-
IncludeLegGeometry
— 包括响应中一对位置之间每条路径的几何形状。
-
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "WaypointPositions":[ [
-122.1884,48.0936
], [-122.3493,47.6205
] ], "IncludeLegGeometry":true
}
响应示例
以下是一个示例请求,其中包含从 Amazon Location Routes API 调用CalculateRoute
操作并将IncludeLegGeometry
设置为 true
时的相应响应,其中包括响应中一对位置之间每条路径的线串几何形状。