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

map开发

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

administrator 2021年3月21日 2021年3月21日 itemprop="discussionURL"Leave a comment

方法	说明	是否插件
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>`	返回高德坐标集合

0 0 投票数

文章评分

订阅评论

0 评论

内联反馈

查看所有评论

0

希望看到您的想法，请您发表评论x

()