该接口为查询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"
}
错误码
访问错误中心查看更多错误码。