title: 范围监听

创建监听范围

getCircleQuery(Position center, double radius) 根据位置与半径创建监听范围，单位为千米。

  1. CircleQuery query = location.getCircleQuery(new Position(39.7, -122.4), 100);

事件

范围监听通过事件的方式实时获取设备的变化信息。

事件包括以下三种:

名称 说明
onKeyEntered 设备进入了查询范围内时触发 onKeyEntered 事件。初始化时所有范围内的设备都会触发一次该事件。
onKeyExited 设备从查询范围内离开查询范围时，会触发 onKeyExited 事件。如果这个 key 在云端被删除的话，被传递给回调函数的位置信息和距离信息将为null。
onKeyMoved 设备已经在查询范围内部，当它在内部发生移动的时候，会触发 onKeyMoved 事件。
onCircleQueryReady 实例初始化完成或者查询被更新时触发，可以在该方法内设置更新UI的操作。
onCircleQueryError 在查询范围内触发了异常错误。

监听范围事件

addCircleQueryEventListener(listener)方法用于与事件配合，监听范围内的设备数据。

  1. query.addCircleQueryEventListener(new CircleQueryListener() {
  2.             @Override
  3.             public void onKeyEntered(String key, Position location) {
  4.                 Log.e(TAG, key+"进入查询范围内" );
  5.             }
  7.             @Override
  8.             public void onKeyExited(String key) {
  9.                 Log.e(TAG, key+"离开查询范围内" );
  10.             }
  12.             @Override
  13.             public void onKeyMoved(String key, Position location) {
  14.                  Log.e(TAG, key+"在查询范围内移动" );
  15.             }
  17.             @Override
  18.             public void onCircleQueryReady() {
  19.                 Log.e(TAG, "初始化完毕" );
  20.             }
  22.             @Override
  23.             public void onCircleQueryError(SyncError error) {
  24.                 Log.e(TAG, "查询范围内发生错误："+ error.getMessage() );
  25.                 System.err.println("There was an error querying locations: " + error.getMessage());
  26.             }
  27.         });

取消监听

removeCircleQueryListener(listener) 用于取消指定的范围监听。

  1. query.removeCircleQueryListener(listener);

removeAllCircleQueryListeners() 用于取消所有的范围监听。

  1. query.removeAllCircleQueryListeners();

实时变更监听范围

只要更改监听位置或者半径，发生在CircleQuery实例上的监听事件就会自动更新，方法如下：

  1. // 更改监听位置
  2. query.setCenter(new Position(39.7, -122.4));
  3. // 更改监听半径
  4. query.setRadius(100);

例如，可以根据设备的实时位置不断更新监听范围。

  1. location.addPositionListener("key", new Location.PositionListener() {
  2.             @Override
  3.             public void onDataChange(String key, Position location) {
  4.                query.setCenter(location);
  5.             }
  7.             @Override
  8.             public void onCancelled(SyncError syncError) {
  10.             }
  11.         });