Geolocation API 總覽

Geolocation API 服務可接受 HTTPS 要求,其中包含行動用戶端可偵測到的行動通信基地台和 Wi-Fi 存取點。它會傳回緯度/經度座標及半徑,指出每個有效輸入的結果。

使用 Geolocation API 的理由

使用 Geolocation API 找出不提供原生地理位置功能的行動裝置。

Geolocation API 的用途

有了 Geolocation API,您就能利用行動通信基地台和 Wi-Fi 節點中的地理空間資料取得沒有原生地理位置或 GPS 的裝置所在位置。

Geolocation API 的運作方式

Geolocation API 使用行動數據裝置欄位、行動通信基地台數據和 WiFi 存取點陣列資料,藉此傳回經緯度座標和精確度半徑。該平台接受內含端點的 HTTPS POST 要求以及 JSON 結構化要求主體。以下範例顯示要求網址和要求主體範例:

    https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

    {
      "homeMobileCountryCode": 310,
      "homeMobileNetworkCode": 410,
      "radioType": "gsm",
      "carrier": "Vodafone",
      "considerIp": true,
      "cellTowers": [
        // See the Cell Tower Objects section below.
      ],
      "wifiAccessPoints": [
        // See the WiFi Access Point Objects section below.
      ]
    }
  
API 可以傳回許多常見行動數據欄位的資料,如下所示。

資源

下表概略說明地理位置端點呼叫要求主體的欄位,以及透過這類查詢提供的資料類型。

資料資源 傳回的資料 退貨格式
行動數據裝置欄位,例如電信業者、裝置和網路資訊。 緯度/經度座標和精確度半徑 JSON
行動通信基地台資料,例如地點區碼和行動國家/地區代碼。
WiFi 存取點資料,例如 MAC 位址和訊號強度等。

如何使用 Geolocation API

1 做好準備 先從設定您的 Google Cloud 專案並完成後續的設定操作說明。
2 提出地理位置要求 取得 API 金鑰後,您就可以透過 cURL 或 Postman 開始測試 Geolocation API。詳情請參閱地理位置要求和回應指南中的要求範例
3 從不同的無線電塔取得基地台 ID 請參閱「計算 cellID 」和「 計算 newRadioCellID」,以便分別存取舊版和較新的塔。
4 瞭解回應的基本概念 探索地理位置資料回應,準備讓您的應用程式使用海拔高度資料。詳情請參閱地理位置回應

可用的用戶端程式庫

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

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

後續步驟