![Geolocation API 總覽](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=7&hl=zh-tw)
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 下載這些範例,也可以在其中找到安裝操作說明和程式碼範例。