
Geolocation API 服務可接受 HTTPS 要求,其中包含行動用戶端可偵測到的行動通信基地台和 Wi-Fi 存取點。它會傳回緯度/經度座標及半徑,指出每個有效輸入的結果。
使用 Geolocation API 的理由
使用 Geolocation API 找出不提供原生地理位置功能的行動裝置。
Geolocation API 的用途
有了 Geolocation API,您就能利用行動通信基地台和 Wi-Fi 節點中的地理空間資料取得沒有原生地理位置或 GPS 的裝置所在位置。
Geolocation API 的運作方式
Geolocation API 使用行動數據裝置欄位、行動通信基地台數據和 WiFi 存取點陣列資料,藉此傳回經緯度座標和精確度半徑。該平台接受內含端點的 HTTPS POST 要求以及 JSON 結構化要求主體。以下範例顯示要求網址和要求主體範例:
https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY { "homeMobileCountryCode": 310, "homeMobileNetworkCode": 410, "radioType": "gsm", "carrier": "Vodafone", "considerIp": true, "cellTowers": [ // See the Cell Tower Objects section below. ], "wifiAccessPoints": [ // See the WiFi Access Point Objects section below. ] }API 可以傳回許多常見行動數據欄位的資料,如下所示。
資源
下表概略說明地理位置端點呼叫要求主體的欄位,以及透過這類查詢提供的資料類型。
資料資源 | 傳回的資料 | 退貨格式 |
---|---|---|
行動數據裝置欄位,例如電信業者、裝置和網路資訊。 | 緯度/經度座標和精確度半徑 | JSON |
行動通信基地台資料,例如地點區碼和行動國家/地區代碼。 | ||
WiFi 存取點資料,例如 MAC 位址和訊號強度等。 |
如何使用 Geolocation API
1 | 做好準備 | 先從設定您的 Google Cloud 專案並完成後續的設定操作說明。 |
2 | 提出地理位置要求 | 取得 API 金鑰後,您就可以透過 cURL 或 Postman 開始測試 Geolocation API。詳情請參閱地理位置要求和回應指南中的要求範例。 |
3 | 從不同的無線電塔取得基地台 ID | 請參閱「計算 cellID 」和「 計算 newRadioCellID」,以便分別存取舊版和較新的塔。 |
4 | 瞭解回應的基本概念 | 探索地理位置資料回應,準備讓您的應用程式使用海拔高度資料。詳情請參閱地理位置回應。 |
可用的用戶端程式庫
您可以透過下列任一用戶端程式庫,用您選擇的語言呼叫這個 API:
Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。 您可以從 GitHub 下載,或參考安裝指示和程式碼範例。