地理编码API是通过HTTP协议访问远程服务的接口,提供将结构化地址转化为经纬度的服务。
地址结构化API是通过HTTP协议访问远程服务的接口,提供将地址拆分为各级别地理实体的服务。
地理编码:将详细的结构化地址转换为美团经纬度坐标,且支持名胜景区、标志性建筑物名称解析为美团经纬度坐标。例如:天安门→116.397499,39.908722
地址结构化:将地址拆分为各级别地理实体。
URL | https://lbsapi.meituan.com/v1/location/geo?parameters |
---|---|
请求方式 | GET |
参数名 | 数据类型 | 含义 | 规则说明 | 是否必填 | 缺省值 |
---|---|---|---|---|---|
key | string | 请求服务权限标识 | 用户申请到的Web服务API Key | 是 | 无 |
address | string | 结构化地址信息 | 省+市+区+街道+门牌号 | 是 | 无 |
city | string | 查询所在的城市 | city=北京市,只支持city汉字/编码的形式 | 否 | 无 |
名称 | 类型 | 含义 | 规则说明 | ||
---|---|---|---|---|---|
status | int | 返回结果状态值 | 200为成功;其它为失败,失败原因请参阅状态码说明 。 | ||
msg | string | 状态描述 | 对状态码的简单描述。 | ||
count | int | 返回结果数目 | |||
geocodes | array<geocode> | 结果列表 | 该接口返回一或多个地理编码结果 | ||
geocode | |||||
formatted_address | string | 结构化地址信息 | 省份+城市+区县+乡镇+街道+门牌号码 | ||
province | string | 地址所在的省份名 | 例如:北京市。此处需要注意的是,中国的四大直辖市、特别行政区也算作省级单位。 | ||
pcode | string | 省份行政编码 | |||
city | string | 地址所在的城市名 | 例如:北京市 | ||
citycode | string | 城市行政编码 | 例如:110100 | ||
areacode | string | 城市区号 | 例如:010 | ||
district | string | 地址所在的区 | 例如:朝阳区 | ||
adcode | string | 区域编码 | 例如:110101 | ||
street | string | 街道 | 例如:望京东路 | ||
number | string | 门牌号 | 例如:1号 | ||
location | string | 坐标点 | 经纬度 | ||
level | string | 最小匹配级别 | 取值范围: 省、市、区县、开发区、乡镇、村庄、门、建筑物、门牌号、单元号、道路、交叉路口、兴趣点 |
level | 含义 | 示例说明 |
---|---|---|
国家 | 国家级行政区划 | 中国 |
省 | 省级行政区划/直辖市/特别行政区 | 北京市 |
市 | 地级市/省直辖县/直辖市/特别行政区 | 北京市 |
区县 | 区县级行政区划 | 朝阳区 |
开发区 | 经济技术开发区等 | 林河经济开发区 |
乡镇 | 乡镇 | 望京街道 |
村庄 | 村庄 | 三元村 |
道路 | 道路 | 阜通东大街 |
交叉路口 | 交叉路口 | 机场东路/顺平路 |
门牌号 | 门牌号 | 阜通东大街6号 |
楼栋 | 楼栋 | 花家地南里1栋 |
单元号 | 单元号 | 花家地南里1号楼1单元 |
兴趣点 | 兴趣点 | 居然大厦 |
门 | 门 | 花家地南里东门 |
https://lbsapi.meituan.com/v1/location/geo?key=<用户的key>&address=北京市朝阳区望京东路4号&city=北京
参数名 | 值 | 规则说明 | 是否必填 |
---|---|---|---|
address | 结构化地址信息 | 是 | |
city | 查询所在的城市 | 否 |
URL | https://lbsapi.meituan.com/v1/format?parameters |
---|---|
请求方式 | GET |
参数名 | 数据类型 | 含义 | 规则说明 | 是否必填 | 缺省值 |
---|---|---|---|---|---|
key | string | 请求服务权限标识 | 用户申请到的Web服务API Key | 是 | 无 |
address | string | 地址信息 | 省+市+区县+街道+门牌号 | 是 | 无 |
city | string | 查询城市 | 完整的城市名、区县名(如北京市),或其ID(如北京市对应的110100) | 否 | 无 |
model | string | 返回结果的表达形式 | 取值:composite(复合)/simple(简单) | 否 | composite |
stander | bool | 返回结果是否标准化 | true(标准化):对部分实体进行标准化操作 | 否 | true |
名称 | 类型 | 含义 | 规则说明 | |||
---|---|---|---|---|---|---|
status | int | 返回结果状态值 | 200为成功;其它为失败,失败原因请参阅状态码说明 。 | |||
msg | string | 状态描述 | 当status不是200时,msg会返回具体错误原因,否则返回“成功”。详情参阅状态码说明 。 | |||
components | array<component> | 结构化地址列表 | 结果对象列表,包括下述字段: | |||
component | ||||||
name | string | 名称 | 例如:望京东路1号 | |||
level | string | 层级 | 例如:street_num | |||
additional | string | 附加信息 | 例如:1号 | |||
primary | array<PrimaryComponent> | |||||
name | string | |||||
level | string | |||||
additional | string | |||||
primary | array<SubComponent> |
level | 含义 | 数据类型 | 示例 | 对应primary示例 | 对应primary说明 | |
---|---|---|---|---|---|---|
province | 省 | string | 辽宁省 | |||
city | 市 | string | 北京市 | |||
district | 区县 | string | 朝阳区 | |||
region | 行政管理区、开发区 | string | 北京经济技术开发区 | |||
township | 乡/镇/街道 | string | 望京街道 | |||
village | 村/庄/社区 | string | 三元村 | |||
village_group | 村组 | string | 三元村1组 | 三元村 | 对应village类型实体 | |
village_num | 村门牌 | string | 三元村1号 | 三元村 | 对应village类型实体 | |
road | 路 | string | 望京东路西段 | 望京东路 | 子路的情况下,如"望京东路西段"存在 对应road类型实体 | |
street_num | 门牌号 | string | 望京东路1号 | 望京东路 | 对应road类型实体 | |
func_street | 功能街/内部路 | string | 王府井商业街 | 山厦新村一区 | 实体类型和前面的实体有关 | |
road_inter | 交叉路口 | string | 望京东路/望京西路 | 望京东路 望京西路 | 对应多个road类型实体 | |
road_gap | 路口 | string | 望京东路北口 | |||
poi | 兴趣点 | string | 居然大厦 | |||
apart | 楼栋 | string | 1号楼 | |||
apart_unit | 单元 | string | 1单元 | |||
gate | 门 | string | 花家地南里东门 | 花家地南里 | 实体类型与门前面的实体有关 | |
floor | 楼层 | string | 1层 | |||
room | 房间号 | string | 101室 | |||
offset | 偏移 | string | 花家地南里东100米 | 花家地南里 | 实体类型与偏移前面的实体有关 |
https://lbsapi.meituan.com/v1/format?key=<用户的key>&address=北京市朝阳区望京东路4号&city=北京&model=simple&stander=false
参数名 | 值 | 规则说明 | 是否必填 |
---|---|---|---|
address | 地址信息 | 是 | |
city | 查询城市 | 否 | |
model | 返回结果的表达形式 | 否 | |
stander | 返回结果是否标准化 | 否 |
URL | https://lbsapi.meituan.com/v2/format?parameters |
---|---|
请求方式 | GET |
参数名 | 数据类型 | 含义 | 规则说明 | 是否必填 | 缺省值 |
---|---|---|---|---|---|
key | string | 请求服务权限标识 | 用户申请到的Web服务API Key | 是 | 无 |
address | string | 地址信息 | 省+市+区县+街道+门牌号 | 是 | 无 |
city | string | 查询城市 | 完整的城市名、区县名(如北京市),或其ID(如北京市对应的110100) | 否 | 无 |
model | string | 返回结果的表达形式 | 取值:composite(复合)/simple(简单) | 否 | composite |
stander | bool | 返回结果是否标准化 | true(标准化):对部分实体进行标准化操作 | 否 | true |
remove_duplication | bool | 是否对原始地址去重 | true:去重 false:不去重 | 否 | true |
名称 | 类型 | 含义 | 规则说明 | |||
---|---|---|---|---|---|---|
status | int | 返回结果状态值 | 200为成功;其它为失败,失败原因请参阅状态码说明 。 | |||
msg | string | 状态描述 | 当status不是200时,msg会返回具体错误原因,否则返回“成功”。详情参阅状态码说明 。 | |||
components | array<component> | 结构化地址列表 | 结果对象列表,包括下述字段: | |||
component | ||||||
name | string | 名称 | 例如:望京东路1号 | |||
level | string | 层级 | 例如:street_num | |||
additional | string | 附加信息 | 例如:1号 | |||
primary | array | |||||
name | string | |||||
level | string | |||||
additional | string | |||||
primary | array |
level | 含义 | 数据类型 | 示例 | 对应primary示例 | 对应primary说明 | |
---|---|---|---|---|---|---|
province | 省 | string | 辽宁省 | |||
city | 市 | string | 北京市 | |||
district | 区县 | string | 朝阳区 | |||
region | 行政管理区、开发区 | string | 北京经济技术开发区 | |||
township | 乡/镇/街道 | string | 望京街道 | |||
village | 村/庄/社区 | string | 三元村 | |||
village_group | 村组 | string | 三元村1组 | 三元村 | 对应village类型实体 | |
village_num | 村门牌 | string | 三元村1号 | 三元村 | 对应village类型实体 | |
road | 路 | string | 望京东路西段 | 望京东路 | 子路的情况下,如"望京东路西段"存在 对应road类型实体 | |
street_num | 门牌号 | string | 望京东路1号 | 望京东路 | 对应road类型实体 | |
func_street | 功能街/内部路 | string | 王府井商业街 | 山厦新村一区 | 实体类型和前面的实体有关 | |
road_inter | 交叉路口 | string | 望京东路/望京西路 | 望京东路 望京西路 | 对应多个road类型实体 | |
road_gap | 路口 | string | 望京东路北口 | |||
aoi | 兴趣面(学校、小区、医院、广场等面积较大的poi) | string | 花家地南里 | |||
sub_aoi | 子兴趣面(大的aoi的子区域) | string | 花家地南里二期 | 花家地南里 | 对应aoi实体类型 | |
poi | 兴趣点 | string | 居然大厦 | |||
sub_poi | 子兴趣点(空间上包含在poi部) | string | 居然大厦(poi)1层肯德基(sub_poi) | |||
fac_poi | 设施类兴趣点(文本无独立意义,且空间无独立意义或极小,一般为附属设施,实现某种功能,如电梯、办公室、医院的科室,保安亭,门卫) | string | 办公室、快递柜、 | |||
apart | 楼栋 | string | 1号楼 | |||
apart_unit | 单元 | string | 1单元 | |||
gate | 门 | string | 花家地南里东门 | 花家地南里 | 实体类型与门前面的实体有关 | |
floor | 楼层 | string | 1层 | |||
room | 房间号 | string | 101室 | |||
offset | 偏移 | string | 花家地南里东100米 | 花家地南里 | 实体类型与偏移前面的实体有关 | |
person | 人名 | string | 李雷 | |||
tel | 电话 | string | 18902345678 |
字段名 | 含义 | 数据类型 | 示例 | |
---|---|---|---|---|
province | 省 | string | 辽宁省 | |
city | 市 | string | 北京市 | |
district | 区县 | string | 朝阳区 | |
region | 行政管理区、开发区 | string | 北京经济技术开发区 | |
township | 乡/镇/街道 | string | 望京街道 | |
village | 村/庄/社区 | string | 三元村 | |
village_group | 村组 | string | 1组 | |
village_num | 村门牌 | string | 1号 | |
road | 路 | string | 望京东路 | |
sub_road | 子路/路段 | string | 西段 | |
street_num | 门牌号 | string | 1号 | |
func_street | 功能街/内部路 | string | 王府井商业街 | |
road_gap | 路口 | string | 望京东路北口 | |
aoi | 兴趣面(学校、小区、医院、广场等面积较大的poi) | string | 花家地南里 | |
sub_aoi | 子兴趣面(大的aoi的子区域) | string | 一期 | |
poi | 兴趣点 | string | 居然大厦 | |
sub_poi | 子兴趣点(空间上包含在poi部) | string | 居然大厦(poi)1层肯德基(sub_poi) | |
fac_poi | 设施类兴趣点(文本无独立意义,且空间无独立意义或极小,一般为附属设施,实现某种功能,如电梯、办公室、医院的科室,保安亭,门卫) | string | 办公室、快递柜、 | |
apart | 楼栋 | string | 1号楼 | |
apart_unit | 单元 | string | 1单元 | |
gate | 门 | string | 东门 | |
floor | 楼层 | string | 1层 | |
room | 房间号 | string | 101室 | |
offset | 偏移 | string | 东100米 | |
person | 人名 | string | 李雷 | |
tel | 电话 | string | 18902345678 |
https://lbsapi.meituan.com/v2/format?key=<用户的key>&address=北京市朝阳区望京东路4号&city=北京&model=simple&stander=false&remove_duplication=false
参数名 | 值 | 规则说明 | 是否必填 |
---|---|---|---|
address | 地址信息 | 是 | |
city | 查询城市 | 否 | |
model | 返回结果的表达形式 | 否 | |
stander | 返回结果是否标准化 | 否 | |
remove_duplication | 是否对原始地址去重 | 否 |