产品介绍
IP定位是一套简单的HTTP接口,根据用户输入的IP地址,能够快速的帮用户定位IP的所在位置。
IP定位 2.0(推荐):支持IPV4和IPV6两种地址,还支持部分国外国家或地区的IP解析;
IP定位:仅支持IPV4,不支持国外IP解析。
适用场景
希望能够将IP信息转换为地理位置信息。
使用限制
服务调用量的限制请点击这里查阅。
使用说明
第一步,申请”web服务 API”密钥(Key);
第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;
第三步,接收HTTP请求返回的数据(JSON或XML格式),解析数据。
如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。
IP定位 2.0
IP定位 2.0 API服务地址:
URLhttps://restapi.amap.com/v5/ip?parameters
请求方式GET
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。请求参数
参数名含义规则是否必填
key高德Key是
typeIP类型可选值
4:ipv4
6:ipv6是
ip要查询的ip地址如:221.206.131.10是
sig数字签名数字签名认证用户必填否返回参数
名称含义规则
status状态码返回结果状态值,值为0或1,0表示失败;1表示成功
info返回状态说明status为0时,info返回错误原因;否则返回“OK”。详情参阅info状态
infocode状态码返回状态说明,10000代表正确,详情参阅info状态表
country国家国家(或地区),中文
province省份省(二级),中文
city城市市(三级),中文
district区县区(四级),中文
isp运营商如电信、联通、移动
location经纬度精度在前,纬度在后,格式:X,Y
IpIP地址提交的 Ipv4/ Ipv6地址。
IP定位
IP定位API服务地址:
URLhttps://restapi.amap.com/v3/ip?parameters
请求方式GET
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。请求参数
参数名含义规则说明是否必须缺省值
key请求服务权限标识必填无
ipip地址需要搜索的IP地址(仅支持国内)
若用户不填写IP,则取客户http之中的请求来进行定位可选无
sig签名选择数字签名认证的付费用户必填可选无返回结果参数说明
IP定位查询的响应结果的格式由请求参数output指定。
名称含义规则说明
status返回结果状态值值为0或1,0表示失败;1表示成功
info返回状态说明返回状态说明,status为0时,info返回错误原因,否则返回“OK”。
infocode状态码返回状态说明,10000代表正确,详情参阅info状态表
province省份名称若为直辖市则显示直辖市名称;
如果在局域网 IP网段内,则返回“局域网”;
非法IP以及国外IP则返回空
city城市名称若为直辖市则显示直辖市名称;
如果为局域网网段内IP或者非法IP或国外IP,则返回空
adcode城市的adcode编码
rectangle所在城市矩形区域范围所在城市范围的左下右上对标对服务示例https://restapi.amap.com/v3/ip?ip=114.247.50.2&output=xml&key=
参数 值 备注 必选 ip 需要搜索的IP地址(仅支持国内)
若用户不填写IP,则取客户HTTP之中的请求来进行定位 否