概述
通过终端设备IP地址获取其当前所在地理位置,精确到市级,常用于显示当地城市天气预报、初始化用户城市等非精确定位场景。
请求URL
https://apis.map.qq.com/ws/location/v1/ip
该请求为GET请求
请求参数
参数 | 必填 | 说明 | 示例 |
---|---|---|---|
ip | 否 | IP地址,缺省时会使用请求端的IP | ip=202.106.0.20 |
key | 是 | 开发密钥(Key) | key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77 |
output | 否 | 返回格式:支持JSON/JSONP,默认JSON | output=json |
callback | 否 | JSONP方式回调函数 | callback=function1 |
响应结果
名称 | 类型 | 必填 | 说明 | ||
---|---|---|---|---|---|
status | number | 是 | 状态码,0为正常, 310请求参数信息有误, 311Key格式错误, 306请求有护持信息请检查字符串, 110请求来源未被授权 | ||
message | string | 是 | 对status的描述 | ||
result | object | 是 | IP定位结果 | ||
ip | string | 是 | 用于定位的IP地址 | ||
location | object | 是 | 定位坐标 | ||
lat | number | 是 | 纬度 | ||
lng | number | 是 | 经度 | ||
ad_info | object | 是 | 定位行政区划信息 | ||
nation | string | 是 | 国家 | ||
province | string | 是 | 省 | ||
city | string | 否 | 市 | ||
district | string | 否 | 区 | ||
adcode | number | 是 | 行政区划代码 |
调用示例
// GET请求,注意参数值要进行URL编码
https://apis.map.qq.com/ws/location/v1/ip?ip=61.135.17.68&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77
//响应示例:
{
"status": 0,
"message": "query ok",
"result": {
"ip": "202.106.0.30",
"location": {
"lng": 116.407526,
"lat": 39.90403
},
"ad_info": {
"nation": "中国",
"province": "",
"city": "",
"adcode": 110000
}
}
}
https://apis.map.qq.com/ws/location/v1/ip?ip=124.200.178.101&key=3333WZBZ-QIAP250-IDK3D-3Q4EE-4FLFS-QIAP