
Geolocation API 是一項服務,可接受含有行動用戶端可偵測到的行動通信基地台和 Wi-Fi 存取點的 HTTPS 要求。並傳回經緯度座標和半徑,指出每個有效輸入結果的準確度。
使用 Geolocation API 的理由
使用 Geolocation API 找出未提供原生地理位置功能的行動裝置。
Geolocation API 的用途
Geolocation API 可根據行動通信基地台和 Wi-Fi 節點的地理空間資料,取得沒有原生地理位置或 GPS 的裝置位置。
Geolocation API 的運作方式
Geolocation API 會使用行動裝置資料欄位、行動通信基地台資料和 Wi-Fi 存取點陣列資料,傳回緯度/經度座標和精確度半徑。它會接受傳送至端點的 HTTPS POST 要求,以及 JSON 結構化要求主體。以下範例顯示要求網址和要求主體:
curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d \ '{ "homeMobileCountryCode":310, "homeMobileNetworkCode":410, "radioType":"gsm", "carrier":"Vodafone", "considerIp":true }'
資源
下表列出地理位置端點呼叫要求主體中的欄位,以及這類查詢提供的資料類型。
資料資源 | 傳回的資料 | 傳回格式 |
---|---|---|
行動裝置資料欄位 ,例如電信業者、裝置和網路資訊。 | 經緯度座標和精確度半徑 | JSON |
行動通信基地台資料,例如位置區域代碼和行動國家/地區代碼。 | ||
Wi-Fi 存取點資料, 例如 MAC 位址和訊號強度。 |
如何使用 Geolocation API
1 | 做好準備 | 請先設定 Google Cloud 專案,然後按照後續設定指示操作。 |
2 | 嘗試發出地理位置要求 | 取得 API 金鑰後,您可以使用 cURL 或 Postman 開始測試 Geolocation API。詳情請參閱「地理位置要求和回應」指南中的「要求範例」。 |
3 | 從不同無線電塔取得 cellID | 請參閱計算 cellID 和 計算 newRadioCellID ,分別存取舊型和新型基地台。 |
4 | 瞭解回覆的基本概念 | 請先瞭解地理位置資料的回應,再準備在應用程式中使用海拔資料。詳情請參閱「地理位置回應」。 |
可用的用戶端程式庫
透過下列任一用戶端程式庫,以您選擇的語言呼叫這項 API:
Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些用戶端,並查看安裝操作說明和程式碼範例。
後續步驟
- 開始使用範例要求和回應:請參閱「 地理位置要求和回應」
- 遵循最佳做法:請參閱「Web Service Best Practices」(網路服務最佳做法)。
- 瞭解帳單:前往「用量與帳單」。