Directions API 總覽

Directions API 服務接受 HTTP 要求，並傳回 不同位置之間的 JSON 或 XML 格式路線。

使用 Directions API 的好處

您可以使用 Directions API 規劃多種模式的路線 交通運輸、開車、步行或單車等交通運輸方式。

Directions API 有哪些用途？

透過 Directions API，您可以計算不同位置之間的路線 包括下列詳細資料：

  • 多種交通方式的路線，包括大眾運輸、開車、 以及步行或騎單車。
  • 使用一系列路線控點進行多個部分的路線。
  • 您可以透過多種方式指定起點、目的地和路線控點，包括： 文字字串 (例如 "Chicago, IL" 或 "Darwin, NT, Australia")，地點 或經緯度座標

Directions API 的運作方式

當 Directions API 傳回最有效率的路線時， 以及計算方向產品會將下列旅遊元素納入考量 決定最有效率的路線時：

  • 交通時間 (主要)
  • 距離
  • 轉彎次數

以下範例要求會以 JSON 格式，傳回從安大略多倫多 (安大略省) 到魁北克蒙特婁的行車路線：

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

資源

下表摘要列出透過 Directions API 和其傳回的資料。

資料資源 傳回的資料 退貨格式
路線

以地點 ID、地址、 或經緯度座標詳情請參閱必要參數 。

詳細路線，細分為路線、路段和步驟。詳情請見 路線回應。
  • JSON
  • XML

如何使用 Directions API

1 做好準備： 首先，請設定您的 Google Cloud 專案 然後完成設定 並按照指示操作
2 體驗功能 取得 API 金鑰和雲端專案之後 免付費的導航示範。請參閱 Directions API 示範。
3 建立要求 查看請求範例並瞭解可用的 您可以提供的選項，例如交通方式、路線控點和 。請參閱路線範例。
4 瞭解回覆的基本概念 瀏覽資料回應，準備好為應用程式使用路線資料。詳情請見 路線規劃回應 。
5 將路線資料加入自己的應用程式！ 您可以運用這些資料計算移動距離和時間。

可用的用戶端程式庫

如要呼叫這個 API，請使用 從以下用戶端程式庫中擇一：

Google 地圖適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端 服務是社群支援的用戶端程式庫，並採用 Apache 2.0 授權。 您可以從 GitHub 下載這些範例，也可以在其中找到安裝操作說明和程式碼範例。

後續步驟