概述

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

1、IP定位支持IPv6地址定位。
2、IP定位精度范围不是固定的,最高精确到区/县,最低精确到国家。
3、IP定位目前无法覆盖所有IP,会存在定位失败的情况。

请求URL

该请求为GET请求

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

请求参数

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

前往示例中心 在线体验 ➤

这篇文章对您解决问题是否有帮助?

已解决
未解决