123 lines
4.1 KiB
Markdown
123 lines
4.1 KiB
Markdown
## 地理编码
|
|
|
|
用于经纬度与地址之间的相互查询
|
|
|
|
|
|
## Geocoder
|
|
|
|
**Extends AMap.Event**
|
|
|
|
AMap.Geocoder 地理编码与逆地理编码类，用于地址描述与经纬度坐标之间的转换。用户可以通过回调函数获取查询结果。
|
|
[相关示例][103]
|
|
|
|
### Parameters
|
|
|
|
- `opts` **GeocoderOptions**
|
|
- `opts.city` **string** <div>
|
|
<div>城市，地理编码时，设置地址描述所在城市</div>
|
|
<div>可选值：城市名（中文或中文全拼）、citycode、adcode</div>
|
|
<div>默认值：“全国”</div>
|
|
</div>
|
|
- `opts.radius` **number** <div>
|
|
<div>逆地理编码时，以给定坐标为中心点，单位：米</div>
|
|
<div>取值范围：0 - 3000</div>
|
|
<div>默认值：1000</div>
|
|
</div>
|
|
- `opts.lang` **string** <div>设置语言类型</div>
|
|
<div>可选值：zh_cn（中文）、en(英文)</div>
|
|
<div>默认值：zh_cn（中文</div>
|
|
- `opts.batch` **boolean** 是否批量查询<div>batch 设置为 false 时，只返回第一条记录</div>
|
|
- `opts.extensions` **string** 逆地理编码时，返回信息的详略<div>默认值：base，返回基本地址信息 </div>
|
|
<div>取值为：all，返回地址信息及附近poi、道路、道路交叉口等信息 </div>
|
|
|
|
### Examples
|
|
|
|
```javascript
|
|
var geocoder;
|
|
//加载地理编码插件
|
|
mapObj.plugin(["AMap.Geocoder"], function() { //加载地理编码插件
|
|
geocoder = new AMap.Geocoder({
|
|
radius: 1000, //以已知坐标为中心点，radius为半径，返回范围内兴趣点和道路信息
|
|
extensions: "all" //返回地址描述以及附近兴趣点和道路信息，默认“base”
|
|
});
|
|
//返回地理编码结果
|
|
geocoder.on("complete", geocoder_CallBack);
|
|
//逆地理编码
|
|
geocoder.getAddress(new AMap.LngLat(116.359119, 39.972121));
|
|
});
|
|
```
|
|
|
|
### getLocation
|
|
|
|
将地址信息转化为高德经纬度坐标信息
|
|
|
|
#### Parameters
|
|
|
|
- `keyword` **String** 关键字
|
|
- `cbk` **GeocoderCallback** 回调函数
|
|
|
|
### setCity
|
|
|
|
地理编码时，设置地址描述所在城市
|
|
|
|
#### Parameters
|
|
|
|
- `city` **String** 所在城市
|
|
|
|
### getAddress
|
|
|
|
将高德经纬度坐标信息转化为结构化的地址信息
|
|
|
|
#### Parameters
|
|
|
|
- `location` **(LngLat \| Array<LngLat>)** 给定坐标
|
|
- `cbk` **ReGeocoderCallback** 回调函数
|
|
|
|
## GeocoderCallback
|
|
|
|
Geocoder getLocation 回调函数
|
|
|
|
Type: Function
|
|
|
|
### Parameters
|
|
|
|
- `status` **string** 当status为complete时，result为GeocodeResult；当status为error时，result为错误信息info；当status为no_data时，代表检索返回0结果
|
|
- `result` **(info | GeocodeResult)** 地理编码 [详查rest文档][106]
|
|
|
|
## ReGeocoderCallback
|
|
|
|
Geocoder getAddress 回调函数
|
|
|
|
Type: Function
|
|
|
|
### Parameters
|
|
|
|
- `status` **string** 当status为complete时，result为GeocodeResult；当status为error时，result为错误信息info；当status为no_data时，代表检索返回0结果
|
|
- `result` **(info | ReGeocodeResult)** 逆地理编码 [详查rest文档][107]
|
|
|
|
## convertFrom
|
|
|
|
地球上同一个地理位置的经纬度，在不同的坐标系中，会有少于偏移，国内目前常见的坐标系主要分为三种： </br>
|
|
1\. 地球坐标系——WGS84：常见于 GPS 设备，Google 地图等国际标准的坐标体系。 </br>
|
|
2\. 火星坐标系——GCJ-02：中国国内使用的被强制加密后的坐标体系，高德坐标就属于该种坐标体系。 </br>
|
|
3\. 百度坐标系——BD-09：百度地图所使用的坐标体系，是在火星坐标系的基础上又进行了一次加密处理。 </br>
|
|
因此在使用不同坐标系前，我们需要使用 AMap.convertFrom() 方法将这些非高德坐标系进行转换。 </br>
|
|
[相关示例][108]
|
|
|
|
### Parameters
|
|
|
|
- `lnglat` **LngLat** 需要转换的坐标或者坐标组
|
|
- `type` **String** 坐标类型 (optional, default `'gps'`)
|
|
- `cbk` **Function?** 转换成功后的回调函数
|
|
|
|
### Examples
|
|
|
|
```javascript
|
|
var gps = [116.3, 39.9];
|
|
AMap.convertFrom(gps, 'gps', function (status, result) {
|
|
if (result.info === 'ok') {
|
|
var lnglats = result.locations; // Array.<LngLat>
|
|
}
|
|
});
|
|
```
|