
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 }'
资源
下表总结了地理定位端点调用的请求正文中的字段,以及此类查询提供的数据类型。
数据资源 | 返回的数据 | 返回格式 |
---|---|---|
移动设备数据字段,例如运营商、设备和网络信息。 | 经纬度坐标和精度半径 | JSON |
手机基站数据,例如位置区代码和移动设备国家/地区代码。 | ||
Wi-Fi 接入点数据,例如 MAC 地址和信号强度。 |
如何使用 Geolocation API
1 | 开始设置 | 首先,请设置您的 Google Cloud 项目,然后按照后续的设置说明完成操作。 |
2 | 尝试地理定位请求 | 获得 API 密钥后,您就可以开始使用 c网址 或 Postman 测试 Geolocation API 了。如需了解详情,请参阅地理定位请求和响应指南中的请求示例。 |
3 | 从不同的无线电塔获取 cellID | 请参阅计算 cellID 和 计算 newRadioCellID,分别获取对旧基站和新基站的访问权限。 |
4 | 了解响应基础知识 | 探索地理位置数据响应,为在应用中使用海拔数据做好准备。如需了解详情,请参阅地理位置响应。 |
可用的客户端库
通过以下客户端库之一,以您选择的语言调用此 API:
- 适用于 Google 地图服务的 Java 客户端
- 适用于 Google 地图服务的 Python 客户端
- 适用于 Google 地图服务的 Go 客户端
- 适用于 Google 地图服务的 Node.js 客户端
适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开放源代码。您可以从 GitHub 下载这些客户端库,还可以在其中找到安装说明和示例代码。
后续步骤
- 开始使用示例请求和响应:前往地理定位请求和响应
- 遵循最佳实践:请参阅Web 服务最佳实践。
- 了解结算:前往用量和结算。