您现在的位置: 开发 > Web服务 API > 开发指南 > API文档 > IP定位

IP定位 最后更新时间: 2021年04月30日

产品介绍

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服务地址:

URL

https://restapi.amap.com/v5/ip?parameters

请求方式

GET

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。 

  • 请求参数

参数名

含义

规则

是否必填

key

高德Key

用户在高德地图官网申请Web服务API类型KEY

type

IP类型

可选值

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

Ip

IP地址

提交的 Ipv4/ Ipv6地址。


IP定位

IP定位API服务地址:

URL

https://restapi.amap.com/v3/ip?parameters

请求方式

GET

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。 

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

ip

ip地址

需要搜索的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=<用户的key>
参数 备注 必选
ip 需要搜索的IP地址(仅支持国内)
若用户不填写IP,则取客户HTTP之中的请求来进行定位
新用户
福利
示例
中心
常见
问题