地理编码

最后更新时间:2022年01月10日

产品介绍

  • 地理编码API是通过HTTP协议访问远程服务的接口,提供将结构化地址转化为经纬度的服务。

  • 地址结构化API是通过HTTP协议访问远程服务的接口,提供将地址拆分为各级别地理实体的服务。

适用场景

  • 地理编码:将详细的结构化地址转换为美团经纬度坐标,且支持名胜景区、标志性建筑物名称解析为美团经纬度坐标。例如:天安门→116.397499,39.908722

  • 地址结构化:将地址拆分为各级别地理实体。

使用说明

  • 第一步,申请Web服务API类型Key;
  • 第二步,参考接口文档发起HTTP/HTTPS请求;
  • 第三步,接收请求返回的JSON数据。

地理编码

  • 地理编码API服务地址

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

查询所在的城市

地址结构化

  • 地址结构化API服务地址

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(标准化):对部分实体进行标准化操作
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<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

返回结果是否标准化

地址结构化V2

  • 地址结构化V2 API服务地址

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(标准化):对部分实体进行标准化操作
false(不标准化):不进行标准化

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

  • 地址结构化V2 匹配级别列表
  • 复合实体形式说明

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

是否对原始地址去重