示例中心
功能在线体验
控制台
您现在的位置: 开发 > 地图 JS API > 参考手册 > 坐标与地址 >

高德 开发 地图 JS API 参考手册 坐标与地址

更新时间:2018年01月30日

方法

说明

是否插件

AMap.Geocoder

地理编码与逆地理编码服务,用于地址描述与坐标间的相互转换

AMap.convertFrom

坐标转换接口,支持将坐标点从其他坐标系转换为高德坐标系

AMap.Geocoder

AMap.Geocoder地理编码与逆地理编码类,用于地址描述与坐标之间的转换。用户可以通过自定义回调函数取回并显示查询结果。若服务请求失败,系统将返回错误信息

相关示例

构造函数

说明

AMap.Geocoder(opts:GeocoderOptions )

构造函数,提供地理编码或逆地理编码功能

GeocoderOptions

类型

说明

city

String

城市,地理编码时,设置地址描述所在城市

可选值:城市名(中文或中文全拼)、citycode、adcode;

默认值:“全国”

radius

Number

逆地理编码时,以给定坐标为中心点,单位:米

取值范围:0-3000

默认值:1000

lang

String

设置语言类型

batch

Boolean

是否批量查询

batch=true为批量查询,batch=false为单点查询,

batch=false时即使传入多个点也只返回第一个点结果

extensions

String

逆地理编码时,返回信息的详略

默认值:base,返回基本地址信息;

取值为:all,返回地址信息及附近poi、道路、道路交叉口等信息

方法

返回值

说明

getLocation(address:String,

callback:function(status:String,result:info/GeocodeResult))


根据给定的地址描述进行解析,支持中文、拼音

当status为complete时,result为GeocodeResult;

当status为error时,result为错误信息info;

当status为no_data时,代表检索返回0结果  相关示例

setCity(city:String)


地理编码时,设置地址描述所在城市

getAddress(location:LngLat|Array.<LngLat>,

callback:function(status:String,result:info/ReGeocodeResult))


根据给定坐标进行解析

当status为complete时,result为ReGeocodeResult;

当status为error时,result为错误信息info;

当status为no_data时,代表检索返回0结果

批量逆地理编码时,最多支持20个坐标点,超过20个坐标点,按20处理  相关示例

事件

参数

说明

complete

GeocoderResult

当编码执行成功时触发此事件

error

ErrorStatus

当编码执行失败时触发此事件

GeocodeResult 对象

属性

类型

说明

info

String

成功状态说明

geocodes

Array.<Geocode>

地理编码结果,仅地理编码返回

resultNum

Number

地理编码结果数目,仅地理编码返回

ReGeocodeResult 对象

属性

类型

说明

info

String

成功状态说明

regeocode

ReGeocode

逆地理编码结果,仅逆地理编码返回

GeocoderResult 对象

属性

类型

说明

info

String

成功状态说明

geocodes

Array.<Geocode>

地理编码结果,仅地理编码返回

resultNum

Number

地理编码结果数目,仅地理编码返回

regeocode

ReGeocode

逆地理编码结果,仅逆地理编码返回

Geocode 对象

属性

类型

说明

addressComponent

AddressComponent

地址组成元素

formattedAddress

String

格式化地址

规则:地址信息=基本行政区信息+具体信息;

基本行政信息=省+市+区+乡镇

location

LngLat

坐标

adcode

String

区域编码

level

String

给定地址匹配级别,返回匹配最详细级别

如:“北京市海淀区苏州街”匹配级别为“道路”

详见匹配级别列表

ReGeocode 对象

属性

类型

说明

addressComponent

AddressComponent

地址组成元素

formattedAddress

String

格式化地址

规则:地址信息=基本行政区信息+具体信息;

基本行政信息=省+市+区+乡镇

当给定坐标为poi时直接返回;非poi时,取离给定坐标最近poi返回

roads

Array.<Road>

道路信息列表

crosses

Array.<Cross>

道路路口列表

pois

Array.<ReGeocodePoi>

兴趣点列表,包含兴趣点基本信息

AddressComponent 对象

属性

类型

说明

province

String

所在省(省编码在城市编码表中可查询到)

city

String

所在城市

citycode

String

所在城市编码

district

String

所在区

adcode

String

所在区域编码

township

String

所在乡镇

street

String

所在街道

streetNumber

String

门牌号




neighborhood

String

所在社区

neighborhoodType

String

社区类型

building

String

所在楼/大厦

buildingType

String

楼类型

businessAreas

Array.<BusinessArea>

仅逆地理编码时返回,所属商圈信息

ReGeocodePoi 对象

属性

类型

说明

id

String

Poi的唯一标识id

name

String

Poi名称

type

String

Poi类型

tel

String

Poi电话

distance

Number

该Poi到请求坐标的距离,单位:米

direction

String

该Poi相对于请求坐标的方向

address

String

Poi地址信息

location

LngLat

Poi坐标

businessArea

String

Poi所在商圈名称

BusinessArea 对象

属性

类型

说明

id

String

商圈id

name

String

商圈名称

location

String

商圈中心点经纬度

Road 对象

属性

类型

说明

id

String

道路id

name

String

道路名称

distance

Number

道路离查询点最近距离

location

LngLat

道路上离查询点最近的点坐标

direction

String

与查询点的相对方位

Cross 对象

属性

类型

说明

distance

Number

道路离查询点最近距离

direction

String

与查询点的相对方位

location

LngLat

路口经纬度

first_id

String

第一条道路id

first_name

String

第一条道路名称

second_id

String

第二条道路id

second_name

String

第二条道路名称

匹配级别列表

级别

示例

国家

中国

河北、重庆市

宁波

区县

上海市黄浦区

热点商圈

上海市黄浦区老西门

乡镇

回龙观镇

小区

陆家浜路1332号南开大厦21层D

村庄

三元村

道路

苏州街

道路交叉口

北四环西路辅路/善缘街

门牌号

上海市黄浦区外马路1588号

公交站台、地铁站

海淀黄庄站A1西北口

兴趣点

人民大道221号迪美购物中心

未知

北京市海淀区北三环西路,联想桥东侧路北,太阳园小区南侧

道路类型列表

序号

道路等级描述

1

高速公路

2

国道

3

城市环路/城市快速路

4

省道

5

主要道路(城市主干道)

6

次要道路(城市次干道)

7

县道

8

乡村道路

9

区县内部道路

10

一般道路

11

非导航道路

错误信息列表

错误信息

说明

INVALID_UESR_KEY

用户key非法或过期

SERVICE_UNAVAILABLE

请求服务不可用

INSUFFICIENT_PRIVILEGES

无权限访问此服务

INVALID_PARAMS

请求参数非法

UNKNOWN_ERROR

未知错误

AMap.convertFrom

为坐标转换类,支持将其他坐标系的坐标点转换为高德坐标系。

坐标转换方法

方法

返回值

说明

AMap.convertFrom(lnglat:LngLat|Array.<LngLat>, type:String,

function(status:String,result:info/ConvertorResult))


将其他地图服务商的坐标批量转换成高德地图经纬度坐标。最多支持40对坐标。

type用于说明是哪个服务商的坐标,可选值有:

gps:GPS原始坐标;

baidu:百度经纬度;

mapbar:图吧经纬度;

ConvertorResult 对象

属性

类型

说明

info

String

成功状态文字描述

locations

Array.<LngLat>

返回高德坐标集合

示例中心 功能
在线体验
常见问题