Geolocation API 總覽

Geolocation API 服務接受含有 行動用戶端可偵測到的行動通信基地台和 Wi-Fi 存取點。並傳回 經緯度座標和半徑,指出 每個有效輸入內容的結果

使用 Geolocation API 的好處

使用 Geolocation API 找出不提供原生地理位置的行動裝置 接著介紹網際網路通訊層 包括兩項主要的安全防護功能

Geolocation API 的功能

有了 Geolocation API,您可以使用行動通信基地台中的地理空間資料 和 WiFi 節點,取得沒有原生地理位置或 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。請參閱要求範例 ,請參閱地理位置要求與回應指南。
3 取得不同無線電塔的 Cell ID 請參閱計算 CellID。 並 計算新的 RadioCellID 才能分別存取先前和更新過的基地台
4 瞭解回覆的基本概念 探索地理位置資料回應,準備為應用程式使用海拔高度資料。詳情請見 地理位置回應

可用的用戶端程式庫

如要呼叫這個 API,請使用 從以下用戶端程式庫中擇一:

Google 地圖適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端 服務是社群支援的用戶端程式庫,並採用 Apache 2.0 授權。 您可以從 GitHub 下載這些範例,也可以在其中找到安裝操作說明和程式碼範例。

後續步驟