本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 計算路由
<a name="calculate-routes"></a>

Routes API 會計算兩個或多個位置之間的路由，無論是否具有車輛、卡車、摩托車和行人等不同旅行模式的迴避。使用此 API，您可以自訂路由選項並請求其他路由相關資訊，以滿足特定需求。此 API turn-by-turn導覽，並透過套用參數來自訂路由計算，例如避開收費道路、高速公路或鐵道。API 也會傳回速限和過路費。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [CalculateRoutes](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)。

如需此 API 的請求、回應、cURL 和 CLI 命令範例，請參閱[如何使用計算路由](https://docs.aws.amazon.com/location/latest/developerguide/calculate-routes-how-to.html)。

![\[Amazon Location Service Routes 概觀。\]](http://docs.aws.amazon.com/zh_tw/location/latest/developerguide/images/routesV2/P2P-Turn-by-turn-navigation.gif)


## 使用案例
<a name="use-cases"></a>
+ 在**路由圖上顯示地理詳細資訊：**使用進階映射功能，透過豐富的地理資訊視覺化詳細的路由，包括地標、地形和城市基礎設施。透過允許使用者檢視從起點到目的地的明確路由，增強決策能力。此功能可以支援導航、規劃和各種物流案例，並顯示交通模式的路線，例如汽車、卡車、機車和行人。透過新增躲避或過路費計算等元素來自訂路由。
+ **turn-by-turn導覽：**在 Web 和行動裝置上提供無縫導覽支援。使用者可以turn-by-turn方向，確保有效率的旅程。兩個平台都可以利用導覽指示來提供個人或商務旅遊的路由，包括速度限制。
+ **沿著路線計算過路費：**將過路費計算納入路線規劃，為包含過路費、橋樑或通道的路線提供準確的定價預估。預先顯示過路費，以協助駕駛和規劃人員做出符合成本效益的決策，並在必要時避免過路費。
+ **確保符合速限：**整合速限資料，以協助駕駛人保持在法律限制內，降低罰款風險並提升更安全、省油的駕駛。物流和機群管理也可以透過即時監控速度合規來受益。
+ **協助貨運和車輛路由解決方案：**將路由、導航和追蹤功能整合到物流入口網站，簡化貨運和車輛路由操作。有效率地規劃多個交付的路由、即時追蹤貨物，以及透過更好的路由管理燃料成本。

## 了解請求
<a name="understanding-request"></a>

**注意**  
 對於 `ap-southeast-1`和 中的客戶`ap-southeast-5`，支援的請求和回應欄位可能會有所不同。如需詳細資訊，請參閱 [CalculateRoutes API 參考](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)。

請求需要 `Origin`和 `Destination` 參數，而 `Allow`、 `Avoid`和 等選用參數可`Traffic`自訂路由以滿足特定需求和限制。

**來源**  
路由的開始位置，以經度和緯度表示。

**目的地**  
路由的結束位置。

**航點**  
要沿著開始和結束位置之間的路由包含的中繼位置。

**OptimizeRoutingFor**  
路由的最佳化條件，例如最快或最短。

**LegGeometryFormat**  
每個路由分支傳回的幾何格式。

**避免**  
在路由計算期間要避免的功能，如果找不到替代路由則忽略。

**流量**  
影響路由計算的流量相關選項。

**過路費**  
影響路由計算和過路費的過路費相關選項。

**LegAdditionalFeatures**  
可在旅程中每個區段的回應中啟用的功能。

**SpanAdditionalFeatures**  
可在旅程中每個區段的回應內啟用的跨度功能。

## 了解回應
<a name="understanding-response"></a>

回應提供路由詳細資訊，例如旅程的腿部、關於路由計算的通知，以及包含距離和持續時間的摘要資訊。

**路由**  
包含腿部和相關聯屬性的路由陣列。

**注意**  
有關路由的警告或資訊訊息。

**LegGeometryFormat**  
指定路由幾何的格式。

### 腿部詳細資訊
<a name="leg-details"></a>

視傳輸模式而定，旅程的每個區段可以是 Ferry、Pedestrian 或 Vehicle 類型。雖然每個腿都包含與傳輸模式無關的屬性，但您可以在以下位置找到特定屬性：

**FerryLegDetails**  
腿部的 Ferry 特定屬性。

**VehicleLegDetails**  
腿部的車輛特定屬性。

**PedestrianLegDetails**  
腿部的行人特定屬性。

### 步驟
<a name="steps"></a>

旅程的每個部分都分為步驟，說明路由部分的動作。步驟可以是預設，適用於基本應用程式，也可以是 TurnByTurn，適用於turn-by-turn導覽。每個步驟都包含與步驟類型無關的屬性，例如持續時間和距離，以及 ExitStepDetails 等其他特定屬性，這些屬性僅適用於結束步驟。

**BeforeTravelSteps**  
開始旅程之前要執行的步驟。

**TravelSteps**  
在旅程中執行的步驟。

**AfterTravelSteps**  
完成旅程後要執行的步驟。

### 範圍
<a name="spans"></a>

旅程的每個區段都可以分割為跨度。跨度是腿部的一部分，對於一組請求的 具有相同的值`SpanAdditionalFeatures`。範圍除以道路屬性，例如 `SpeedLimit`、道路名稱或區域。傳回的跨度可用來視覺化道路屬性和存取相關資訊。

# 計算過路費
<a name="calculate-toll-cost"></a>

本主題提供與計算過路費相關的欄位和定義的概觀。使用這些欄位，您可以指定付款方式、貨幣和車輛特性等參數，以自訂過路費計算。


| 欄位名稱 | 路由 | 
| --- | --- | 
| 轉換器 | 是，具有 選項 | 
| Vignette | 是，具有 選項 | 
| 貨幣 | 是，具有 選項 | 
| EmissionType | 是，具有 選項 | 
| VehicleCategory | 是，具有 選項 | 

## 定義
<a name="definitions"></a>

本節提供用於過路費計算的每個欄位的簡短定義。

****轉換器****  
收發器是過路費的付款方式，與其他付款方式相比，可能產生不同的價格。

****Vignette****  
短片是一種道路定價形式。當使用者擁有必要的短片時，不需要額外的過路費。

****貨幣****  
回報過路費的貨幣。除了本地貨幣之外，還包含轉換後的貨幣，這也會影響回應中過路費摘要中使用的貨幣。

****EmissionType****  
車輛的排放類型，用於根據車輛排放計算過路費。

****VehicleCategory****  
用於過路費計算的車輛子類別。

# 了解路由步驟
<a name="understanding-route-steps"></a>

本節定義完成旅程所需的各種動作和步驟。路由步驟因行程模式而異，並提供概觀應用程式和詳細turn-by-turn導覽的指引。

## 路由步驟概觀
<a name="route-steps-overview"></a>

以下類型的路由步驟定義完成路由分支所需的動作，因行程模式和行程階段而異。


| **Step type (步驟類型)** | **Description** | 
| --- | --- | 
| Default steps | 提供人類可讀指示的基本步驟，通常用於 Web 型應用程式，以提供路由的概觀。 | 
| Turn by turn steps | 建立turn-by-turn導覽應用程式的詳細步驟，提供更精細的方向。 | 
| Before travel steps | 開始行程區段之前需要完成的步驟，例如乘船。 | 
| After travel steps | 行程區段完成後要執行的步驟，例如下船。 | 

## 依行程模式分類的步驟明細
<a name="route-step-types"></a>


| **區段** | **Step (步驟)** | **行前** | **行程** | **旅行後** | 
| --- | --- | --- | --- | --- | 
| 車輛 | 抵達 | 否 | 是 | 否 | 
| 車輛 | Continue | 否 | 是 | 否 | 
| 車輛 | ContinueHighway | 否 | 是 | 否 | 
| 車輛 | 離開 | 否 | 是 | 否 | 
| 車輛 | Exit(退出) | 否 | 是 | 否 | 
| 行人 | 抵達 | 否 | 是 | 否 | 
| 行人 | 費用 | 否 | 是 | 否 | 
| 船舶 | 等候 | 否 | 否 | 是 | 
| 船舶 | 電路板 | 是 | 否 | 否 | 
| 船舶 | 下機 | 否 | 否 | 是 |