地理编码

GET

https://restapi.amap.com/v3/geocode/geo

产品介绍

地理编码/逆地理编码 API 是通过 HTTP/HTTPS 协议访问远程服务的接口，提供结构化地址与经纬度之间的相互转化的能力。

结构化地址的定义：首先，地址肯定是一串字符，内含国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦等建筑物名称。按照由大区域名称到小区域名称组合在一起的字符。一个有效的地址应该是独一无二的。注意：针对大陆、港、澳地区的地理编码转换时可以将国家信息选择性的忽略，但省、市、城镇等级别的地址构成是不能忽略的。暂时不支持返回台湾省的详细地址信息。

使用 API 前请您先注册高德账号申请Key。

适用场景

地理编码：将详细的结构化地址转换为高德经纬度坐标。且支持对地标性名胜景区、建筑物名称解析为高德经纬度坐标。
结构化地址举例：北京市朝阳区阜通东大街6号转换后经纬度：116.480881,39.989410
地标性建筑举例：天安门转换后经纬度：116.397499,39.908722

逆地理编码：将经纬度转换为详细结构化的地址，且返回附近周边的POI、AOI信息。
例如：116.480881,39.989410 转换地址描述后：北京市朝阳区阜通东大街6号

使用限制

详细的服务调用量限制可点我查阅。

使用说明

第一步，申请Web服务API类型Key；

第二步，参考接口参数文档发起HTTP/HTTPS请求，第一步申请的 Key 需作为必填参数一同发送；

第三步，接收请求返回的数据（JSON或XML格式），参考返回参数文档解析数据。

如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。

返回结果参数说明
响应结果的格式可以通过请求参数 output 指定，默认为 JSON 形式。

服务示例

https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区阜通东大街6号&output=XML&key=<用户的key>

参数	值	备注	必选
address		填写结构化地址信息:省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码	是
city		查询城市，可选：城市中文、中文全拼、citycode、adcode	否

示例说明：address 是需要获取坐标的结构化地址，output（XML）用于指定返回数据的格式，Key是用户请求数据的身份标识，详细可以参考上方的请求参数说明。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区阜通东大街6号&Key='

响应示例

{
    "status": "1",
    "info": "OK",
    "infocode": "10000",
    "count": "1",
    "geocodes": [
        {
            "formatted_address": "北京市朝阳区阜通东大街6号",
            "country": "中国",
            "province": "北京市",
            "citycode": "010",
            "city": "北京市",
            "district": "朝阳区",
            "township": [],
            "neighborhood": {
                "name": [],
                "type": []
            },
            "building": {
                "name": [],
                "type": []
            },
            "adcode": "110105",
            "street": "阜通东大街",
            "number": "6号",
            "location": "116.482086,39.990496",
            "level": "门牌号"
        }
    ]
}

请求参数

Query 参数

address

string

必需

结构化地址信息规则遵循：国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦，如：北京市朝阳区阜通东大街6号。如果需要解析多个地址的话，请用"|"进行间隔，并且将 batch 参数设置为 true，最多支持 10 个地址进进行"|"分割形式的请求。

示例值:

北京市朝阳区阜通东大街6号

city

string

可选

指定查询的城市可选输入内容包括：指定城市的中文（如北京）、指定城市的中文全拼（beijing）、citycode（010）、adcode（110000），不支持县级市。当指定城市查询内容为空时，会进行全国范围内的地址转换检索。 adcode信息可参考城市编码表获取

示例值:

北京

batch

string

可选

批量查询控制 batch 参数设置为 true 时进行批量查询操作，最多支持 10 个地址进行批量查询。 batch 参数设置为 false 时进行单点查询，此时即使传入多个地址也只返回第一个地址的解析查询结果。

sig

string

可选

数字签名请参考数字签名获取和使用方法

output

string

可选

返回数据格式类型可选输入内容包括：JSON，XML。设置 JSON 返回结果数据将会以JSON结构构成；如果设置 XML 返回结果数据将以 XML 结构构成。

示例值:

JSON

callback

string

可选

回调函数 callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。

Key

string

必需

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

默认值:

返回响应

🟢200成功

application/json

Body

status

string

可选

返回结果状态值返回值为 0 或 1，0 表示请求失败；1 表示请求成功。

count

string

可选

返回结果数目返回结果的个数。

info

string

可选

返回状态说明,当 status 为 0 时，info 会返回具体错误原因，否则返回“OK”。详情可以参阅info状态表

geocodes

object

可选

地理编码信息列表结果对象列表，包括下述字段：

formatted_address

string

可选

结构化地址信息省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码

country

string

可选

国家国内地址默认返回中国

province

string

可选

地址所在的省份名例如：北京市。此处需要注意的是，中国的四大直辖市也算作省级单位。

city

string

可选

地址所在的城市名例如：北京市

citycode

string

可选

城市编码例如：010

district

string

可选

地址所在的区例如：朝阳区

street

string

可选

街道例如：阜通东大街

number

string

门牌例如：6号

可选

adcode

string

可选

区域编码例如：110101

location

string

可选

坐标点经度，纬度

level

string

可选

匹配级别参见下方的地理编码匹配级别列表

修改于 2022-12-13 06:32:46

行政区域查询

逆地理编码

地理编码

产品介绍#

适用场景#

使用限制#

使用说明#

请求参数

返回响应

产品介绍

适用场景

使用限制

使用说明