使用 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 取得的資源,以及該 API 傳回的資料。
資料資源 | 傳回的資料 | 傳回格式 |
---|---|---|
路線
以地點 ID、地址或經緯度座標的形式,提供起點和目的地。詳情請參閱必要參數。 |
詳細路線,細分為路線、路段和步驟。詳情請參閱路線回應。 |
|
如何使用 Directions API
1 | 做好準備: | 請先設定 Google Cloud 專案,然後完成後續設定說明。 |
2 | 體驗功能 | 取得 API 金鑰和雲端專案後,您就可以免費試用路線示範。請參閱 Directions API 示範。 |
3 | 建立要求 | 請參閱要求範例,瞭解您可以提供的選項,例如交通方式、路線控點和路線限制。請參閱「路線範例」。 |
4 | 瞭解回覆的基本概念 | 瀏覽資料回應,準備使用應用程式的路線資料。詳情請參閱「路線規劃回應」一節。 |
5 | 將路線資料加入自己的應用程式! | 您可以運用這項資料計算移動距離和時間。 |
可用的用戶端程式庫
透過下列其中一個用戶端程式庫,以您選擇的語言呼叫這個 API:
Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。從 GitHub 下載這些檔案,您也可以在其中找到安裝操作說明和程式碼範例。