该接口为查询IPv4地理位置信息(DescribeIpv4Location),用于查询IPv4地理位置信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeIpv4Location

系统规定参数。取值:DescribeIpv4Location。

Ip String 221.206.131.10

要查询的 IPv4 地址。

Lang String en

语言。

返回数据

名称 类型 示例值 描述
Country String 中国

国家(或地区)中文

CountryCode String CN

国家(或地区)两位字母

CountryEn String China

国家(或地区)英文

Province String 黑龙江省

省(二级)中文

ProvinceEn String Heilongjiang

省(二级)英文/拼音

City String 牡丹江市

市(三级)中文

CityEn String Mudanjiang

市(三级)英文/拼音

County String 阳明区

区(四级)中文

Isp String 联通

运营商

Longitude String 129.618605

经度

Latitude String 44.582963

纬度

Ip String 221.206.131.10

提交的 Ipv4 地址。

RequestId String 643598D5-48B5-4C57-896A-4B0AE306439B

唯一请求识别码

注意:并不是所有字段都会有返回值,如果定位不到某字段时会返回空值,具体原因可参考官方文档

示例

请求示例

http://geoip.aliyuncs.com/?Action=DescribeIpv4Location
&Ip=221.206.131.10
&<公共请求参数>

正常返回示例

XML格式

<ProvinceEn>Heilongjiang</ProvinceEn>
<RequestId>66B13BF1-8998-41D7-AA69-98BEAA32988F</RequestId>
<CityEn>Mudanjiang</CityEn>
<Ip>221.206.131.10</Ip>
<Isp>联通</Isp>
<Latitude>44.582963</Latitude>
<City>牡丹江市</City>
<County>阳明区</County>
<Longitude>129.618605</Longitude>
<Province>黑龙江省</Province>
<CountryEn>China</CountryEn>
<Country>中国</Country>
<CountryCode>CN</CountryCode>

JSON格式

{
  "ProvinceEn": "Heilongjiang",
  "RequestId": "66B13BF1-8998-41D7-AA69-98BEAA32988F",
  "CityEn": "Mudanjiang",
  "Ip": "221.206.131.10",
  "Isp": "联通",
  "Latitude": "44.582963",
  "City": "牡丹江市",
  "County": "阳明区",
  "Longitude": "129.618605",
  "Province": "黑龙江省",
  "CountryEn": "China",
  "Country": "中国",
  "CountryCode": "CN"
}

错误码

访问错误中心查看更多错误码。