從 Directions API 或 Distance Matrix API 遷移

本指南說明如何將使用 Directions API 或 Distance Matrix API 的應用程式遷移至 Routes API。如要進一步瞭解 Routes API,請參閱產品總覽

更新 REST API 端點

更新程式碼,使用新的 Routes API 端點

透過 Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

透過 Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

將網址參數轉換為使用 HTTPS 要求主體

使用 Directions API 和 Distance Matrix API 時,您可以將設定屬性做為網址參數傳遞至 HTTP GET 要求。例如,針對 Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

使用 Routes API 時,您可以在要求主體或標頭中傳遞參數,做為 HTTP POST 要求的一部分。如需範例,請參閱:

將折線編碼的路線點轉換為位置路線點

Directions API 可讓您將中途站指定為已編碼的多邊形,以便在 16384 個字元上限的網址中納入大量中途站。路線 API 不需要這項功能,因為路線控點可透過 REST 或 gRPC 要求主體以經緯度座標傳送。如需範例,請參閱「計算路線矩陣」文件中的「HTTP 範例」,或是「指定中繼路徑點」文件中的「定義中繼路徑點」。

轉換參數

下表列出 Directions API 和 Distance Matrix API 中已重新命名或修改的參數,或 GA 版本不支援的參數。如果您使用任何這些參數,請更新程式碼。

要求參數轉換

路線或距離矩陣參數 Routes API 參數 附註
alternatives computeAlternativeRoutes
arrival_time arrivalTime 僅適用於 TRANSIT 模式,且不能與 departureTime 同時使用。
avoid routeModifiers
departure_time departureTime 無法與 arrivalTime 同時使用。
language languageCode 僅支援 Compute 路由。
mode travelMode

新增對 TWO_WHEELERTRANSIT 的支援。

region regionCode
traffic_model trafficModel 瞭解詳情
transit_mode "travelMode": "TRANSIT" 在 Directions API 的轉乘路線上,每個行程段落如果採用相同的移動模式 (例如步行或大眾運輸),就會視為一個步驟,而該移動模式的個別路線會列在子步驟中。相較之下,在 Routes API 中,步驟一律是所有類型行程的單一導覽指示。因此,每個導覽指示都是一個步驟。 對於同一個行程模式中的多個步驟,Routes API 會提供中繼資料,其中包含該行程模式的步驟摘要,位於 `stepsOverview`。如要要求這項中繼資料,請使用 `routes.legs.stepsOverview` 欄位遮罩。瞭解詳情
transit_routing_preference transitRoutingPreference 瞭解詳情
units units 瞭解詳情
waypoints intermediates 已停止支援編碼多邊形
optimize=true 用於路線控點 "optimizeWaypointOrder": "true" 瞭解詳情

回應參數轉換

路線或距離矩陣參數 Routes API 參數 附註
copyrights

未包含在回應中。向使用者顯示結果時,您必須加入下列聲明:

Powered by Google, ©YEAR Google

例如:

Powered by Google, ©2022 Google

distance distanceMeters 距離只能以公尺為單位。
duration_in_traffic duration 已從 Routes API 中移除,請改用 duration
status 不適用。針對 API 回報的錯誤,使用 HTTP 回應代碼。詳情請參閱「處理要求錯誤」。
geocoded_waypoints geocoding_results 僅支援 Compute 路由。僅包含指定為地址的路線控點的地理編碼回應資訊。
bounds viewport
legs.end_address 不適用。
legs.start_address 不適用。
overview_polyline 折線
summary description
waypoint_order optimizedIntermediateWaypointIndex