IP定位

GET

/v3/ip

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://restapi.amap.com/v3/ip?Key='

响应示例

{
  "status": "1",
  "info": "OK",
  "infocode": "10000",
  "province": "北京市",
  "city": "北京市",
  "adcode": "110000",
  "rectangle": "116.0119343,39.66127144;116.7829835,40.2164962"
}

请求参数

Query 参数

string

可选

ip地址需要搜索的IP地址（仅支持国内）若用户不填写IP，则取客户http之中的请求来进行定位

示例值:

114.247.50.2

sig

string

可选

签名选择数字签名认证的付费用户必填

Key

string

必需

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

默认值:

返回响应

🟢200成功

application/json

Body

status

string

可选

返回结果状态值值为0或1,0表示失败；1表示成功

info

string

可选

返回状态说明返回状态说明，status为0时，info返回错误原因，否则返回“OK”。

infocode

string

可选

状态码返回状态说明,10000代表正确,详情参阅info状态表

province

string

可选

省份名称若为直辖市则显示直辖市名称；如果在局域网 IP网段内，则返回“局域网”；非法IP以及国外IP则返回空

city

string

可选

城市名称若为直辖市则显示直辖市名称；如果为局域网网段内IP或者非法IP或国外IP，则返回空

adcode

string

可选

城市的adcode编码

rectangle

string

可选

所在城市矩形区域范围所在城市范围的左下右上对标对

概述