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
}'
API 可傳回一些常見的行動數據欄位資料，如下所示。
資源
下表摘要說明地理位置端點呼叫要求主體中的欄位，以及這類查詢所提供的資料類型。
| 資料資源 | 傳回的資料 | 傳回格式 |
|---|---|---|
| 行動裝置資料欄位，例如電信業者、裝置和網路資訊。 | 經緯度座標和精確半徑 | JSON |
| 行動通信基地台資料，例如地點區碼和行動裝置國家/地區代碼。 | ||
| WiFi 存取點資料，例如 MAC 位址和訊號強度。 |
如何使用 Geolocation API
| 1 | 做好準備 | 請先設定 Google Cloud 專案，然後完成畫面上的設定操作說明。 |
| 2 | 嘗試提出地理位置要求 | 取得 API 金鑰後，您就能開始使用 cURL 或 Postman 測試 Geolocation API。詳情請參閱「地理位置要求和回應」指南中的「要求範例」。 |
| 3 | 從其他無線電基地台取得基地台 ID | 請參閱「計算 CelID」 和 「計算新的 RadioCellID」，分別存取舊版和新版塔。 |
| 4 | 瞭解回應基本知識 | 查看地理位置資料回應，準備為應用程式使用海拔高度資料。詳情請參閱「地理位置回應」一節。 |
可用的用戶端程式庫
透過下列任一用戶端程式庫，以您選擇的語言呼叫這個 API：
Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫，並依據阿帕契 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些套件，也可以找到安裝操作說明和程式碼範例。