开发 Web服务 API 开发指南 基础 API 文档 IP定位

IP定位 最后更新时间: 2024年08月06日

产品介绍

IP 定位是一套简单的 HTTP 接口,根据用户输入的 IP 地址,能够快速的帮用户定位 IP 的所在位置。

IP 定位:仅支持 IPV4,不支持国外 IP 解析。

适用场景

希望能够将 IP 信息转换为地理位置信息。

使用限制

服务调用量的限制请点击 这里 查阅。  

使用说明

1
第一步
申请 【Web服务API】密钥(Key)
2
第二步
拼接 HTTP 请求 URL,第一步申请的 Key 需作为必填参数一同发送
3
第三步
接收 HTTP 请求返回的数据(JSON 或 XML 格式),解析数据
如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8
成为开发者并创建 Key 

为了正常调用 Web 服务 API ,请先注册成为高德开放平台开发者,并申请 Web 服务的 key ,点击具体操作

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 编码

adcode 信息可参考 城市编码表 获取

rectangle

所在城市矩形区域范围

所在城市范围的左下右上对标对

服务示例

https://restapi.amap.com/v3/ip?ip=114.247.50.2&output=xml&key=<用户的key>

参数

备注

必选

ip

需要搜索的 IP 地址(仅支持国内)
若用户不填写 IP,则取客户 HTTP 之中的请求来进行定位

返回顶部 示例中心 常见问题 智能客服 公众号
二维码