Geolocation API 總覽

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 下載這些套件,也可以找到安裝操作說明和程式碼範例。

後續步驟