地理编码和逆地理编码-高德地图

一 地理编码

1.1 简介

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

1.2 地理编码 API 服务地址

1.2.1 请求的URL

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

1.2.2 请求的方式

GET

1.2.3 请求的参数

参数名	含义	规则说明	是否必须	缺省值
key	高德Key	用户在高德地图官网申请Web服务API类型Key	必填	无
address	结构化地址信息	规则遵循：国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦，如：北京市朝阳区阜通东大街6号。	必填	无
city	指定查询的城市	可选输入内容包括：指定城市的中文（如北京）、指定城市的中文全拼（beijing）、citycode（010）、adcode（110000），不支持县级市。当指定城市查询内容为空时，会进行全国范围内的地址转换检索。	可选	无，会进行全国范围内搜索
sig	数字签名	请参考:数字签名获取和使用方法	可选	无
output	返回数据格式类型	可选输入内容包括：JSON，XML。设置 JSON 返回结果数据将会以JSON结构构成；如果设置 XML 返回结果数据将以 XML 结构构成。	可选	JSON
callback	回调函数	callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。	可选	无

1.3 响应的结果

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

1.3.1 响应字段说明

名称	含义	说明
status	返回结果状态值	返回值为 0 或 1，0 表示请求失败；1 表示请求成功。
count	返回结果数目	返回结果的个数。
info	返回状态说明	当 status 为 0 时，info 会返回具体错误原因，否则返回“OK”。
geocodes	地理编码信息列表	结果对象列表

1.3.2 URL实例

https://restapi.amap.com/v3/geocode/geo?address=陕西省西安市雁塔区&city=西安市&output=JSON&key=<您的key>

1.3.3 响应URL结果

{
        "status" : "1",
        "info" : "OK",
        "infocode" : "10000",
        "count" : "1",
        "geocodes" :
        [
            "0" :
            {
                "formatted_address" : "陕西省西安市雁塔区",
                "country" : "中国",
                "province" : "陕西省",
                "citycode" : "029",
                "city" : "西安市",
                "district" : "雁塔区",
                "township" :
                [ ]
                ,
                "neighborhood" :
                {
                    "name" :
                    [ ]
                    ,
                    "type" :
                    [ ]
                }
                ,
                "building" :
                {
                    "name" :
                    [ ]
                    ,
                    "type" :
                    [ ]
                }
                ,
                "adcode" : "610113",
                "street" :
                [ ]
                ,
                "number" :
                [ ]
                ,
                "location" : "108.926593,34.213389",
                "level" : "区县"
            }
        ]
    }

二 逆地理编码

2.1 简介

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

2.2 地理编码 API 服务地址

2.2.1 请求的URL

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

2.2.2 请求的方式

GET

2.2.3 请求的参数

参数名	含义	规则说明	是否必须	缺省值
key	高德Key	用户在高德地图官网申请Web服务API类型Key	必填	无
location	经纬度坐标	传入内容规则：经度在前，纬度在后，经纬度间以“,”分割，经纬度小数点后不要超过 6 位。	必填	无
poitype	返回附近POI类型	以下内容需要 extensions 参数为 all 时才生效。逆地理编码在进行坐标解析之后不仅可以返回地址描述，也可以返回经纬度附近符合限定要求的POI内容（在 extensions 字段值为 all 时才会返回POI内容）。设置 POI 类型参数相当于为上述操作限定要求。参数仅支持传入POI TYPECODE，可以传入多个POI TYPECODE，相互之间用“|”分隔。	可选	无
radius	搜索半径	radius取值范围在0~3000，默认是1000。单位：米	可选	1000
extensions	返回结果控制	extensions 参数默认取值是 base，也就是返回基本地址信息；extensions 参数取值为 all 时会返回基本地址信息、附近 POI 内容、道路信息以及道路交叉口信息。	可选	base
roadlevel	道路等级	以下内容需要 extensions 参数为 all 时才生效。可选值：0，1 当roadlevel=0时，显示所有道路 当roadlevel=1时，过滤非主干道路，仅输出主干道路数据	可选	无
sig	数字签名	请参考数字签名获取和使用方法	可选	无
output	返回数据格式类型	可选输入内容包括：JSON，XML。设置 JSON 返回结果数据将会以JSON结构构成；如果设置 XML 返回结果数据将以 XML 结构构成。	可选	JSON
callback	回调函数	callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。	可选	无
homeorcorp	是否优化POI返回顺序	以下内容需要 extensions 参数为 all 时才生效。homeorcorp 参数的设置可以影响召回 POI 内容的排序策略，目前提供三个可选参数：0：不对召回的排序策略进行干扰。1：综合大数据分析将居家相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。2：综合大数据分析将公司相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。	可选	0

2.3 响应的结果

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

2.3.1 响应字段说明

名称	含义	规则说明
status	返回结果状态值	返回值为 0 或 1，0 表示请求失败；1 表示请求成功。
info	返回状态说明	当 status 为 0 时，info 会返回具体错误原因，否则返回“OK”。
regeocode	逆地理编码列表	返回 regeocode 对象；regeocode 对象包含的数据如下：
	addressComponent	地址元素列表
		province	坐标点所在省名称	例如：北京市
	city	坐标点所在城市名称	请注意：当城市是省直辖县时返回为空，以及城市为北京、上海、天津、重庆四个直辖市时，该字段返回为空
	citycode	城市编码	例如：010
	district	坐标点所在区	例如：海淀区
	adcode	行政区编码	例如：110108
	township	坐标点所在乡镇/街道（此街道为社区街道，不是道路信息）	例如：燕园街道
	towncode	乡镇街道编码	例如：110101001000
	neighborhood	社区信息列表
		name	社区名称	例如：北京大学
	type	POI类型	例如：科教文化服务;学校;高等院校
	building	楼信息列表
		name	建筑名称	例如：万达广场
	type	类型	例如：科教文化服务;学校;高等院校
	streetNumber	门牌信息列表
		street	街道名称	例如：中关村北二条
	number	门牌号	例如：3号
	location	坐标点	经纬度坐标点：经度，纬度
	direction	方向	坐标点所处街道方位
	distance	门牌地址到请求坐标的距离	单位：米
	seaArea	所属海域信息	例如：渤海
	businessAreas	经纬度所属商圈列表
		businessArea	商圈信息
	location	商圈中心点经纬度
	name	商圈名称	例如：颐和园
	id	商圈所在区域的adcode	例如：朝阳区/海淀区
	roads	道路信息列表	请求参数 extensions 为 all 时返回如下内容
		road	道路信息
		id	道路id
	name	道路名称
	distance	道路到请求坐标的距离	单位：米
	direction	方位	输入点和此路的相对方位
	location	坐标点
	roadinters	道路交叉口列表	请求参数 extensions 为 all 时返回如下内容
		roadinter	道路交叉口
		distance	交叉路口到请求坐标的距离	单位：米
	direction	方位	输入点相对路口的方位
	location	路口经纬度
	first_id	第一条道路id
	first_name	第一条道路名称
	second_id	第二条道路id
	second_name	第二条道路名称
	pois	poi信息列表	请求参数 extensions 为 all 时返回如下内容
		poi	poi信息列表
		id	poi的id
	name	poi点名称
	type	poi类型
	tel	电话
	distance	该POI的中心点到请求坐标的距离	单位：米
	direction	方向	为输入点相对建筑物的方位
	address	poi地址信息
	location	坐标点
	businessarea	poi所在商圈名称
	aois	aoi信息列表	请求参数 extensions 为 all 时返回如下内容
		aoi	aoi信息
		id	所属 aoi的id
	name	所属 aoi 名称
	adcode	所属 aoi 所在区域编码
	location	所属 aoi 中心点坐标
	area	所属aoi点面积	单位：平方米
	distance	输入经纬度是否在aoi面之中	0，代表在aoi内其余整数代表距离AOI的距离
	type	所属 aoi 类型

2.3.2 URL实例

https://restapi.amap.com/v3/geocode/regeo?location=108.481488,36.990464&poitype=商务写字楼&radius=&extensions=all&batch=false&roadlevel=0&key=<您的key>

2.3.3 响应URL实例

    {
        "status" : "1",
        "info" : "OK",
        "infocode" : "10000",
        "regeocode" :
        {
            "formatted_address" : "陕西省延安市吴起县吴起街道",
            "addressComponent" :
            {
                "country" : "中国",
                "province" : "陕西省",
                "city" : "延安市",
                "citycode" : "0911",
                "district" : "吴起县",
                "adcode" : "610626",
                "township" : "吴起街道",
                "towncode" : "610626001000",
                "neighborhood" :
                {
                    "name" :
                    [ ]
                    ,
                    "type" :
                    [ ]
                }
                ,
                "building" :
                {
                    "name" :
                    [ ]
                    ,
                    "type" :
                    [ ]
                }
                ,
                "streetNumber" :
                {
                    "street" :
                    [ ]
                    ,
                    "number" :
                    [ ]
                    ,
                    "direction" :
                    [ ]
                    ,
                    "distance" :
                    [ ]
                }
                ,
                "businessAreas" :
                [
                    "0" :
                    [ ]
                ]
            }
            ,
            "pois" :
            [ ]
            ,
            "roads" :
            [ ]
            ,
            "roadinters" :
            [ ]
            ,
            "aois" :
            [ ]
        }
    }

参考链接:https://lbs.amap.com/api/webservice/guide/api/georegeo#regeo