title: GeoCircleQuery

进行范围查询的实例。

方法

center

定义

center()

说明

获取 CircleQuery的中心点。

返回值

Position


radius

定义

radius()

说明

获取 CircleQuery 的半径。

返回值

Float


updateCriteria

定义

updateCriteria(newCircleQueryCriteria)

说明

更新 CircleQuery 的查询条件，动态修改，不影响现有监听的使用。

参数
参数名 说明
CircleQueryCriteria object 类型，范围查询的条件 Map。


on

定义

on(eventType, callback)

说明

为查询附加某事件类型触发的回调。可用的事件包括： "ready", "key_entered", "key_exited", 和 "key_moved"。 "ready"事件回调不传递参数。其他的回调将传递三个参数：(1)位置的key， (2) 地理位置，Position ，(3)位置到查询圆心的距离，单位是米 。 返回 CallbackRegistration 用于取消回调。

参数
参数名 说明
eventType String 类型(non-null)
事件类型参见 EventType。
onEvent onEvent(non-null)类型
事件发生时的回调函数 。
返回值

CallbackRegistration

EventType

GeoCircleQuery on 方法所支持的事件列表。

名称 说明
key_entered 设备进入了查询范围内时触发 key_entered 事件。初始化时所有范围内的设备都会触发一次 key_entered 事件。
key_exited 设备从查询范围内离开查询范围时，会触发 key_exited 事件。如果这个 key 在云端被删除的话，被传递给回调函数的位置信息和距离信息将为null。
key_moved 设备已经在查询范围内部，当它在内部发生移动的时候，会触发 key_moved 事件。
ready 当初始化或者更新范围条件后，数据都将会重新加载。加载完毕的时候将会触发 ready事件。

onEvent

定义

function(key, position, distance)

说明

事件发生时所触发的回调函数。

参数
参数名 说明
key String(non-null)类型
地理位置单位的唯一标识。
position Position(non-null) 类型
key 的最新地理位置。
distance Float(non-null) 类型
当前位置到查询圆心的距离。
返回值

Void

cancel

定义

cancel()

说明

终止这个查询，所有通过on()附加的回调都会被取消，这个查询在未来都不会再被使用了。