Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據Apache 2.0 授權的條款提供開放原始碼。您可以在 GitHub 下載及貢獻程式庫,也可以在 GitHub 找到安裝操作說明和程式碼範例:
使用用戶端程式庫的好處
Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端,都可讓您在自家伺服器上使用 Google 地圖網路服務。這些用戶端內含下列 API 的功能:
- Address Validation API
- Directions API (舊版)
- Distance Matrix API (舊版)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API
除了這些 API 提供的功能外,用戶端程式庫還能簡化常見工作:
- 自動頻率限制:根據預設,系統會以各項網路服務的預期頻率限制傳送要求。您可以使用
new GeoApiContext().setQueryRateLimit(qpm)提供自訂的每分鐘查詢次數 (QPM) 限制。 - 失敗時重試:API 傳送 500 級錯誤時,系統會自動重試任何要求,並使用指數輪詢來處理間歇性失敗。
- 驗證方式簡單:可使用 API 金鑰驗證,或使用 用戶端 ID 和密鑰 (適用於 Google Maps Platform 付費方案客戶)。
- 一般 Java 物件 (POJO):針對 Java 程式庫中的每個 API 回應,傳回有類型的 Java 物件,而 Python 程式庫則直接從 API 傳回回應結構。
- 非同步或同步呼叫:支援所有要求的同步和非同步呼叫樣式。
條款及細則
Google 地圖網路服務的用戶端程式庫已取得阿帕契 2.0 授權。
用戶端程式庫是 Google 地圖網路服務的包裝函式,受《Google 地圖平台服務條款》規範。
API 金鑰和用戶端 ID
每項 Google 地圖網路服務都需要 API 金鑰或用戶端 ID。如想瞭解 API 金鑰和用戶端 ID 的使用時機和取得方式,請參閱您目前採用的 API 適用的驗證指南:
- Address Validation API
- Directions API (舊版)
- Distance Matrix API (舊版)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API