Geolocation API 總覽

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

後續步驟