关于腾讯位置服务不再支持HTTP方式调用的公告
为保证数据传输安全,提高安全性,腾讯位置服务WebServiceAPI将不再支持HTTP方式调用。
请开发者尽快调整,将现有通过HTTP方式调用的切换成 HTTPS 调用,以避免受到影响。 平台将于 2018年9月30日 停止对HTTP方式调用的支持。

概述

通过终端设备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 行政区划代码

调用示例