Directions API (舊版) 總覽

歐洲經濟區 (EEA) 開發人員

Directions API (舊版) 服務可接受 HTTP 要求，並傳回 JSON 或 XML 格式的地點間路線。

使用 Directions API (舊版) 的好處

透過 Directions API (舊版)，您可以取得多種交通方式的路線，例如大眾運輸、開車、步行或騎自行車。

Directions API (舊版) 的用途

您可以使用 Directions API (舊版) 計算地點之間的路線，包括下列詳細資料：

  • 多種交通方式的路線，包括大眾運輸、開車、步行或單車。
  • 使用一系列路線控點的多部分路線。
  • 您可以透過多種方式指定起點、目的地和路線控點，包括文字字串 (例如「伊利諾州芝加哥」或「澳洲北領地達爾文」)、地點 ID 或經緯度座標。

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 下載，該處也提供安裝操作說明和程式碼範例。

後續步驟