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
行動通信基地台資料,例如位置區域代碼和行動國家/地區代碼。
Wi-Fi 存取點資料, 例如 MAC 位址和訊號強度。

如何使用 Geolocation API

1 做好準備 請先設定 Google Cloud 專案,然後按照後續設定指示操作。
2 嘗試發出地理位置要求 取得 API 金鑰後,您可以使用 cURL 或 Postman 開始測試 Geolocation API。詳情請參閱「地理位置要求和回應」指南中的「要求範例」。
3 從不同無線電塔取得 cellID 請參閱計算 cellID計算 newRadioCellID ,分別存取舊型和新型基地台。
4 瞭解回覆的基本概念 請先瞭解地理位置資料的回應,再準備在應用程式中使用海拔資料。詳情請參閱「地理位置回應」。

可用的用戶端程式庫

透過下列任一用戶端程式庫,以您選擇的語言呼叫這項 API:

Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些用戶端,並查看安裝操作說明和程式碼範例。

後續步驟