![Geolocation API 概览](https://developers.google.cn/static/maps/images/landing/places-api_480.png?authuser=5&hl=uk)
Geolocation API 是一项服务,可接受带有 移动客户端可检测到的手机基站和 Wi-Fi 接入点。它会返回 纬度/经度坐标和半径,用于表示 每个有效输入对应的结果。
为何使用 Geolocation API
使用 Geolocation API 定位不提供原生地理定位的移动设备 功能。
Geolocation API 的用途
借助 Geolocation API,您可以使用来自手机基站的地理空间数据 和 WiFi 节点来获取没有原生地理定位或 GPS 功能的设备的位置。
Geolocation API 的工作原理
Geolocation API 使用蜂窝设备数据字段、手机基站 和 WiFi 接入点数组数据,以返回纬度/经度坐标和 半径。它接受发送至其端点的 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 |
手机基站数据、 例如地理位置区号和移动设备国家/地区代码 | ||
Wi-Fi 接入点数据、 例如 MAC 地址和信号强度。 |
如何使用 Geolocation API
1 | 开始设置 | 起始内容 设置您的 Google Cloud 项目 并完成随后显示的设置说明。 |
2 | 尝试地理定位请求 | 有了 API 密钥后,您就可以开始使用 c网址 或 邮递员。请参阅示例请求 地理定位请求和响应指南。 |
3 | 从不同无线电发射塔获取小区 ID | 请参阅计算 cellID 以及 计算 newRadioCellID 分别进入较旧和较新的塔楼。 |
4 | 了解响应基础知识 | 探索地理定位数据响应,准备好在您的应用中使用海拔数据。请参阅 地理定位响应 了解详情。 |
可用的客户端库
使用以下语言调用此 API: 供您选择。
适用于 Google 地图的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端 服务是社区支持的客户端库,已按照 Apache 2.0 许可。 您可以从 GitHub 下载它们,您还可以在 GitHub 上找到安装说明和示例代码。
后续步骤
- 示例请求和响应使用入门:前往 地理定位请求和响应
- 遵循最佳做法:前往 Web 服务最佳实践。
- 了解结算:前往用量和结算。