您现在的位置: 开发 > 地图 JS API > 参考手册 > 云图 >

高德 开发 地图 JS API 参考手册 云图

更新时间:2017年06月22日

云图

类名

说明

是否插件

AMap.CloudDataLayer

云数据图层

AMap.CloudDataSearch

云数据检索服务

CloudDataLayer

AMap.CloudDataLayer云数据图层,允许开发者将存储在LBS云数据管理平台中的数据作为一个图层叠加到地图上。也可以将经过一定筛选条件筛选出来的数据作为一个图层加载到地图上。

注:使用AMap.CloudDataLayer插件之前,请在云图数据管理后台建立存储表格。具体创建和管理云数据存储表格的方法可以进入云图开发指南查看。

相关示例

构造函数

说明

AMap.CloudDataLayer(tableId:String,Opts:CloudDataLayerOptions)

构造函数,构造云数据图层

tableId:在云数据管理平台新建地图时,随机生成的数据表id,

一个tableId可以对应属于同一个开发者名下的多个key值

CloudDataLayerOptions

类型

说明

map

Map

要叠加该图层的Map对象

query

CloudDataQuery

要显示云数据的筛选条件

clickable

Boolean

该图层是否响应鼠标点击,默认是:true

方法

返回值

说明

setMap(map:Map


设置添加该图层的地图对象

getMap( )

Map

获取显示图层的地图对象

setOptions(options:CloudDataLayerOptions)


设置云数据图层属性

事件

参数

说明

click

{type,data}

点击图层要素触发事件,data代表了被点击要素的一行记录的信息,类型为CloudData

mouseover

{type,data}

鼠标移进图层要素时触发事件,data类型为Content

mouseout

{type,data}

鼠标移出图层要素时触发事件,data类型为Content

CloudDataQuery 对象

属性

类型

说明

keywords

String

搜索关键字,仅对云数据中建立文本索引的字段有效(请在云数据管理平台中管理文本索引)

云数据管理平台默认为_name和_address建立文本索引

filter

String

云数据筛选条件,仅支持对建立了排序筛选索引的字段进行筛选(请在云数据管理平台中管理排序筛选索引);

支持多个筛选条件,支持对文本字段的精确匹配和对数值字段的区间筛选。

筛选条件之间使用“+”代表与关系,如:

filter:"_name:颐和园+star:[1,2]"             (等同于SQL语句的:              WHERE_name="颐和园"AND star BETWEEN 1 AND 2)

Content 对象

属性

类型

说明

_id

String

云数据图层要素id

_name

String

云数据图层要素名称

_location

LngLat

云数据图层要素坐标

CloudData 对象

属性

类型

说明

_id

String

数据id,id为数据唯一标识

_name

String

名称

_location

LngLat

坐标

_address

String

地址

_address

String

地址

_image

Array.<Image>

图片信息

_updatetime

String

数据更新时间

_distance

Number

距离中心点距离(仅周边查询时返回)

custom_field1


用户自定义字段1

custom_field...


用户自定义字段...

Image 对象

属性

类型

说明

_id

String

图片的id标识

_preurl

String

经过压缩处理的图片地址

尺寸为400*400,若期望获取体积较小的图片文件,建议使用此地址

_url

String

最大限制获取1024*1024,若您的原始图片小于该尺寸,将返回原图。

CloudDataSearch

AMap.CloudDataSearch云数据检索服务,为开发者提供对业务数据的空间检索服务。云数据检索服务包括周边检索、多边形检索以及根据数据id检索。

注:使用AMap.CloudDataSearch插件之前,请在云图数据管理后台建立存储表格。具体创建和管理云数据存储表格的方法可以进入云图开发指南查看。

构造函数

说明

AMap.CloudDataSearch(tableId:String,Opts:CloudDataSearchOptions)

构造函数,构造云数据检索示例

CloudDataSearchOptions

类型

说明

keywords

String

云检索关键字,仅支持对建立了文本索引的字段进行模糊检索(请在云数据管理平台中管理文本索引)

云数据管理平台默认为_name和_address建立文本索引

filter

String

云检索的筛选条件

仅支持对建立了排序筛选索引的字段进行筛选(请在云数据管理平台中管理排序筛选索引);

支持多个筛选条件,支持对文本字段的精确匹配和对数值字段的区间筛选。

筛选条件之间使用“+”代表“与”关系,如:

filter:"_name:酒店+star:[3,5]"(等同于SOL语句的:WHERE_name="酒店" AND star BETWEEN 3 AND 5)

orderBy

String

返回数据的排序规则

1.支持系统预设排序规则:

_distance:坐标与中心点距离升序排序(仅对周边检索有效)

_weight:权重降序排序:

默认值:

1)当设置了keywords时,默认按"_weight"权重排序;

2)当未设置keywords时,默认按"_distance"距离排序

如:orderBy:"_weight"

2.支持对建立了排序筛选索引的整数或小数字段进行排序(请在云数据管理平台中管理排序筛选索引),

升降序分别为"ASC"、"DESC",若仅填字段不填升降序则默认按升序排列

如:orderBy:"age:ASC"

pageSize

Number

单页显示结果数,取值范围[0-100],超过取值范围取默认值

默认:20

pageIndex

Number

当前页码,取值>=1,默认1

map

Map

AMap.Map对象, 展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上。可选值

panel

String|HTMLElement

结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。可选值

autoFitView

Boolean

用于控制在搜索结束后,是否自动调整地图视野使绘制的Marker点都处于视口的可见范围

方法

返回值

说明

searchNearBy(center:LngLat,radius:number,

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


周边检索,根据指定的中心点和半径检索位置数据

radius取值范围[0-50000],超过取值范围按3000,单位:米

当status为complete时,result为CloudDataSearchResult

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

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

相关示例

searchInPolygon(paths:Array.<LngLat>,

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


多边形检索,根据给定的多边形节点坐标数组,检索位置数据

如果数组只有两个坐标元素,则认为多边形为矩形,这两个点为矩形的左下、右上点

多边形坐标数组的起、终点必须保证多边形闭合(起、终点坐标相同)

当status为complete时,result为CloudDataSearchResult

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

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

相关示例

searchByDistrict(district:String,

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


根据行政区划(包括全国/省/市/区县)名称,检索行政区划内位置数据

district为“全国”,则对全表搜索

当district非法或不正确时,按照district为“全国”返回

当status为complete时,result为CloudDataSearchResult

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

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

相关示例

SearchById(id:string,

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


根据数据id检索位置数据,id检索时不需要设置CloudDataSearchOptions

当status为complete时,result为CloudDataSearchResult

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

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

相关示例

setOptions(options:CloudDataSearchOptions)


设置云数据检索属性

clear()


清除搜索结果

事件

参数

说明

complete

CloudDataSearchResult

云检索成功时触发事件

error

CloudDataSearchError

云数据检索失败时触发事件

CloudDataSearchResult 对象

属性

类型

说明

info

String

成功状态文字描述

count

Number

查询结果总数

datas

Array.<CloudData>

云数据数组,当根据数据id检索时,数据仅包含一个CloudData

CloudDataSearchError 对象

属性

类型

说明

info

String

错误信息,参考错误信息列表

错误信息列表

服务正在维护中

参数缺失或格式非法

账号未激活或已被冻结

tableid不存在

_id不存在

UNKOWN_ERROR

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