POI选点 最后更新时间: 2021年01月22日
PoiPicker(POI选点)在给定的输入框上集成输入提示和关键字搜索功能,方便用户选取特定地点(即POI)。
如何使用
1、引入UI组件库
2、PoiPicker依赖jQuery,请参见这里确定是否需要进行DomLibrary设置。
3、加载PoiPicker(模块名:ui/misc/PoiPicker
):
//设置DomLibrary,jQuery或者Zepto
AMapUI.setDomLibrary($);
//加载PoiPicker,loadUI的路径参数为模块名中 'ui/' 之后的部分
AMapUI.loadUI(['misc/PoiPicker'], function(PoiPicker) {
var poiPicker = new PoiPicker({
input: 'pickerInput' //输入框id
});
//监听poi选中信息
poiPicker.on('poiPicked', function(poiResult) {
//用户选中的poi点信息
});
});
接口文档
构造参数
参数名称 | 类型 | 说明 |
---|---|---|
|
| 必填,输入框dom对象或者ID |
|
| 可以为城市名(中文或中文全拼)、citycode、adcode, 默认'auto', 即自动设定为用户ip所在城市(这个过程是异步的,参见方法中的 |
|
| 搜索结果的容器对象或者容器ID,示例 |
|
| 输入提示的容器对象或者容器ID |
|
| 输入提示服务的构造参数,参见AutocompleteOptions |
|
| 可选,地点搜索服务的构造参数 参见PlaceSearchOptions |
方法
方法名称 | 返回值 | 说明 |
---|---|---|
| 修改当前搜索和输入提示的城市设定 | |
| 显示keyword的搜索结果 | |
| 清除搜索结果列表 | |
| 显示keyword的输入提示 | |
| 清除输入提示列表 | |
| city信息就绪后触发传入的回调函数;通常用于构造参数包含 |
事件
事件名称 | 参数 | 说明 |
---|---|---|
|
| 某个POI点被选中, poiInfo结构示例: { source: 'search', //信息来源,search代表搜索服务,suggest代表输入提示 item: { "id": "B000A8WXY0", //poi点的id "name": "***", //名称 "location": lnglat, //经纬度,AMap.LngLat实例, "address": "***" //地址信息 } } |