
Geolocation API 是接受 HTTPS 要求 (包含行動用戶端可偵測的行動通信基地台和 Wi-Fi 存取點) 的服務。這個方法會傳回經緯度座標,以及表示每個有效輸入內容結果準確率的半徑。
使用 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 }'這個 API 會傳回多個常見的行動數據欄位資料,如下所示。
資源
下表摘要說明地理位置端點呼叫要求主體中的欄位,以及這類查詢所提供的資料類型。
資料資源 | 傳回的資料 | 傳回格式 |
---|---|---|
手機裝置資料欄位,例如電信業者、裝置和網路資訊。 | 經緯度座標和精確度半徑 | JSON |
行動通信基地台資料: 例如地點區碼和行動裝置國家/地區代碼。 | ||
WiFi 存取點資料,例如 MAC 位址和訊號強度。 |
如何使用 Geolocation API
1 | 做好準備 | 請先設定 Google Cloud 專案,然後按照指示完成設定。 |
2 | 提出地理位置要求 | 取得 API 金鑰後,即可開始使用 cURL 或 Postman 測試 Geolocation API。詳情請參閱「地理位置要求和回應」指南中的要求範例。 |
3 | 從不同無線電基地台取得 CellID | 請參閱「計算 CellID」 和 計算新的 RadioCellID,以分別存取舊版與較新的塔樓。 |
4 | 瞭解回應基本知識 | 探索地理位置資料回應,為您的應用程式使用海拔高度資料。詳情請參閱「地理位置回應」一文。 |
可用的用戶端程式庫
請透過下列其中一種用戶端程式庫,以您選擇的語言呼叫這個 API:
Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載,您也可以在此找到安裝指示和程式碼範例。