地理位置操作

添加地理位置

为地理位置（geojson）类型字段添加数据和为普通字段添加数据的操作方式是一致的，可参考以下示例。

参数说明

参数 类型 必填 说明
key String 是 在数据表中的类型必须是 geojson
value GeoPoint 或 GeoPolygon 是 -

geojson 类型字段支持使用 GeoPoint 或 GeoPolygon 类型数据进行赋值：

  • GeoPoint 表示坐标点，通过 new GeoPoint(longitude, latitude) 创建一个点，其中经度（longitude）在前，纬度（latitude）在后

  • GeoPolygon 表示地理形状，可以通过以下两种方法创建一个地理形状

  1. // 1. 直接使用数字
  2. GeoPolygon polygon = new GeoPolygon(coordinates: [[10, 10], [20, 10], [30, 20], [10, 10]]);
  4. // 2. 借助 GeoPoint
  5. GeoPoint point1 = new GeoPoint(10, 10);
  6. ...
  7. GeoPolygon polygon = new GeoPolygon(points: [point1, point2, point3, point1]);

请求示例

  1. TableObject tableObject = new TableObject(tableName);
  2. TableRecord record = tableObject.create();
  4. // 保存一个点
  5. GeoPoint point = new GeoPoint(10, 10);
  6. record.set('geo_point', point);
  7. record.save();
  9. // 保存一个多边形
  10. GeoPolygon polygon = new GeoPolygon(coordinates: [[10, 10], [20, 10], [30, 20], [10, 10]]); // 前后两点相同，即需构成一个闭环
  12. // or
  13. GeoPoint point1 = new GeoPoint(10, 10);
  14. //...
  16. polygon = new GeoPolygon(points: [point1, point2, point3, point1]);
  18. record.set('geo_polygon', polygon);
  19. record.save();

地理位置查询

include 在指定多边形集合中找出包含某一点的多边形

  1. // 查找当前用户所属小区
  2. TableObject neighborhood = new TableObject(neighborhoodTable);
  4. Query query = new Query();
  6. // geoField 为 neighborhood 表中定义地理位置的字段名，point 为用户所在位置，为 GeoPoint 类型
  7. query.where(Where.include('geo_polygon', point));
  9. neighborhood.find(query: query);

withinCircle 在指定点集合中，查找包含在指定圆心和指定半径所构成的圆形区域中的点 (返回结果随机排序)

info radius 参数单位为 km。

  1. // 查找在距离用户 radius 千米范围内的饭店
  2. TableObject restaurant = new TableObject(restaurantTableName);
  4. // geoField 为 restaurant 表中定义地理位置的字段名
  5. query.where(Where.withinCircle('geoField', point, radius));
  7. restaurant.find(query: query);

withinRegion 在指定点集合中，查找包含在以指定点为圆点，以最大和最小距离为半径，所构成的圆环区域中的点（返回结果按从近到远排序）

info maxDistance 与 minDistance 参数单位为 m。

  1. // 查找距离用户 minDistance 米外，maxDistance 米内的所有饭店
  2. TableObject restaurant = new TableObject(restaurantTableName);
  4. // geoField 为 restaurant 表中定义地理位置的字段名，point 为圆点，minDistance 不指定默认为 0
  5. query.where(Where.withinRegion('geoField', point, maxDistance, minDistance));
  7. restaurant.find(query: query);

within 在指定点集合中，查找包含于指定的多边形区域的点

  1. // 查找某个小区内的所有饭店
  2. TableObject neighborhood = new TableObject(neighborhoodTable);
  4. TableRecord record = await neighborhood.get(recordId);
  5. GeoPolygon neighborhoodPolygon = new GeoPolygon(coordinates: record.recordInfo['geo_polygon']['coordinates'][0]);
  7. Query query = new Query();
  8. query.where(Where.within('restaurantGeoField', neighborhoodPolygon));
  10. TableObject restaurant = new TableObject(restaurantTableID);
  11. await restaurant.find(query: query);