Directions API 總覽

Directions API 服務可接受 HTTP 要求,並傳回不同地點之間的 JSON 或 XML 格式路線。

使用 Directions API 的好處

透過 Directions API,您可以規劃多種交通方式的路線,例如大眾運輸、開車、步行或單車。

Directions API 的用途為何?

透過 Directions API,您可以計算不同地點之間的路線,包括下列詳細資料:

  • 多種交通方式的路線,包括大眾運輸、開車、步行或單車。
  • 使用一系列路線控點的多重部分路線。
  • 以多種方式指定起點、目的地和路線控點,包括文字字串 (例如「Chicago, IL」或「Darwin, NT, Australia」)、地點 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 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。從 GitHub 下載這些資料,您也可以在這裡找到安裝說明和程式碼範例。

後續步驟