概述
通过终端设备IP地址获取其当前所在地理位置,常用于显示当地城市天气预报、初始化用户城市等非精确定位场景。
注:
1、IP定位支持IPv6地址定位。
2、IP定位精度范围不是固定的,最高精确到区/县,最低精确到国家。
3、IP定位目前无法覆盖所有IP,会存在定位失败的情况。
请求URL
该请求为GET请求
请求参数
参数 | 必填 | 说明 | 示例 |
---|---|---|---|
key | 是 | 开发密钥(Key) | key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-***** |
ip | 否 | IP地址,缺省时会使用请求端的IP | ip=111.206.145.41 |
output | 否 | 返回格式:支持JSON/JSONP,默认JSON | output=json |
callback | 否 | JSONP方式回调函数 | callback=function1 |
响应结果
名称 | 类型 | 必有 | 说明 | ||
---|---|---|---|---|---|
status | number | 是 | 状态码,0为正常,其它为异常,详细请参阅状态码说明 | ||
message | string | 是 | 对status的描述 | ||
result | object | 是 | IP定位结果 | ||
ip | string | 是 | 用于定位的IP地址 | ||
location | object | 是 | 定位坐标。注:IP定位服务精确到市级,该位置为IP地址所属的行政区划政府坐标。 | ||
lat | number | 是 | 纬度 | ||
lng | number | 是 | 经度 | ||
ad_info | object | 是 | 定位行政区划信息 | ||
nation | string | 是 | 国家 | ||
nation_code | number | 是 | 国家代码(ISO3166标准3位数字码) | ||
province | string | 是 | 省 | ||
city | string | 否 | 市 | ||
district | string | 否 | 区 | ||
adcode | number | 是 | 行政区划代码 |
调用示例
// GET请求,注意参数值要进行URL编码 https://apis.map.qq.com/ws/location/v1/ip?ip=111.206.145.41&key=[你的key]
这篇文章对您解决问题是否有帮助?
已解决
未解决