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 下載，您也可以在此找到安裝指示和程式碼範例。