示例中心
功能在线体验
控制台

高德 开发 地图 JS API 参考手册 - UI组件库 其他组件 POI选点

更新时间:2018年07月02日

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点信息
  });
});

示例中心

接口文档

构造参数

参数名称

类型

说明

input

String|HTMLElement

必填,输入框dom对象或者ID

city

String

可以为城市名(中文或中文全拼)、citycode、adcode, 默认'auto', 即自动设定为用户ip所在城市(这个过程是异步的,参见方法中的onCityReady

searchResultsContainer

String|HTMLElement

搜索结果的容器对象或者容器ID,示例

suggestContainer

String|HTMLElement

输入提示的容器对象或者容器ID

autocompleteOptions

Object

输入提示服务的构造参数,参见AutocompleteOptions

placeSearchOptions

Object

可选,地点搜索服务的构造参数 参见PlaceSearchOptions

方法

方法名称

返回值

说明

searchByKeyword(keyword:String)


显示keyword的搜索结果

clearSearchResults()


清除搜索结果列表

suggest(keyword:String)


显示keyword的输入提示

clearSuggest()


清除输入提示列表

onCityReady(callback:Function)


city信息就绪后触发传入的回调函数;通常用于构造参数包含city:'auto'(根据用户ip判断当前城市)时,此时需要异步获取城市

事件

事件名称

参数

说明

poiPicked

Object

某个POI点被选中, poiInfo结构示例:

{
    source: 'search',       //信息来源,search代表搜索服务,suggest代表输入提示
    item: {
        "id": "B000A8WXY0", //poi点的id
        "name": "***",      //名称
        "location": lnglat, //经纬度,AMap.LngLat实例,
        "address": "***"    //地址信息
    }
}
移动端
示例中心
功能
在线体验
常见问题