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 结构化请求正文。以下示例展示了请求网址和请求正文示例： 

    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
手机基站数据，例如位置区号和移动设备国家/地区代码。
Wi-Fi 接入点数据，例如 MAC 地址和信号强度。

如何使用 Geolocation API

1 开始设置 从设置 Google Cloud 项目开始，完成后面的设置说明即可。
2 尝试地理定位请求 拥有 API 密钥后，您就可以开始使用 c网址 或 Postman 来测试 Geolocation API。如需了解详情，请参阅地理位置请求和响应指南中的示例请求。
3 从不同的无线电发射塔获取小区 ID 请参阅计算 cellID 和 Calculation newRadioCellID 分别了解对新旧基站的访问权限。
4 了解回复基础知识 探索地理定位数据响应，以准备为应用使用海拔数据。如需了解详情，请参阅地理定位响应。

可用的客户端库

通过以下客户端库之一，以您选择的语言调用此 API：

适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库，并且根据 Apache 2.0 许可开放源代码。您可以从 GitHub 下载这些文件，也可以在其中找到安装说明和示例代码。

后续步骤