概述

通过终端设备IP地址获取其当前所在地理位置，精确到市级，常用于显示当地城市天气预报、初始化用户城市等非精确定位场景。

请求URL

该请求为GET请求

https://apis.map.qq.com/ws/location/v1/ip

请求参数

参数 必填 说明 示例
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 是 状态说明
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