地理位置查询包括地理距离查询(GeoDistanceQuery)、地理长方形范围查询(GeoBoundingBoxQuery)和地理多边形范围查询(GeoPolygonQuery)三种方式。

前提条件

  • 已初始化Client。具体操作,请参见初始化
  • 已创建数据表并写入数据。
  • 已在数据表上创建多元索引。具体操作,请参见创建多元索引

地理距离查询(GeoDistanceQuery)

GeoDistanceQuery根据一个中心点和距离条件查询表中的数据,当一个地理位置点到指定的中心点的距离不超过指定的值时,满足查询条件。

  • 参数
    参数 说明
    tableName 数据表名称。
    indexName 多元索引名称。
    query 多元索引的查询语句。设置查询类型为TableStore.QueryType.GEO_DISTANCE_QUERY。
    fieldName 列名,类型为Geopoint。
    centerPoint 中心地理坐标点,是一个经纬度值。

    格式为“纬度,经度”,纬度在前,经度在后,且纬度范围为-90~+90,经度范围-180~+180。例如“35.8,-45.91”。

    distance 距离中心点的距离,类型为Double。单位为米。
  • 示例

    查询表中Col_GeoPoint列的值距离中心点不超过一定距离的数据。

    client.search({
        tableName: TABLE_NAME,
        indexName: INDEX_NAME,
        searchQuery: {
            offset: 0,
            limit: 10, //如果只为了获取行数,无需获取具体数据,可以设置limit=0,即不返回任意一行数据。
            query: { //设置查询类型为TableStore.QueryType.GEO_DISTANCE_QUERY。
                queryType: TableStore.QueryType.GEO_DISTANCE_QUERY,
                query: {
                    fieldName: "Col_GeoPoint",
                    centerPoint: "1,1", //设置中心点。
                    distance: 10000 //设置条件为到中心点的距离不超过10000米。
                }
            },
            getTotalCount: true //结果中的TotalCount可以表示表中数据的总行数,默认为false,表示不返回。
        },
        columnToGet: { //返回列设置,可设置为RETURN_SPECIFIED(自定义返回列)、RETURN_ALL(返回所有列)、RETURN_ALL_FROM_INDEX(返回多元索引中的所有列)、RETURN_NONE(不返回)。
            returnType: TableStore.ColumnReturnType.RETURN_ALL
        }
    }, function (err, data) {
        if (err) {
            console.log('error:', err);
            return;
        }
        console.log('success:', JSON.stringify(data, null, 2));
    });

地理长方形范围查询(GeoBoundingBoxQuery)

GeoBoundingBoxQuery根据一个长方形范围的地理位置边界条件查询表中的数据,当一个地理位置点落在给出的长方形范围内时满足查询条件。

  • 参数
    参数 说明
    tableName 数据表名称。
    indexName 多元索引名称。
    query 多元索引的查询语句。设置查询类型为TableStore.QueryType.GEO_BOUNDING_BOX_QUERY。
    fieldName 列名,类型为Geopoint。
    topLeft 长方形框的左上角的坐标。
    bottomRight 长方形框的右下角的坐标,通过左上角和右下角就可以确定一个唯一的长方形。

    格式为“纬度,经度”,纬度在前,经度在后,且纬度范围为-90~+90,经度范围-180~+180。例如“35.8,-45.91”。

  • 示例

    Col_GeoPoint是Geopoint类型,查询表中Col_GeoPoint列的值在左上角为"10,0",右下角为"0,10"的长方形范围内的数据。

    client.search({
        tableName: TABLE_NAME,
        indexName: INDEX_NAME,
        searchQuery: {
            offset: 0,
            limit: 10, //如果只为了获取行数,无需获取具体数据,可以设置limit=0,即不返回任意一行数据。
            query: { //设置查询类型为TableStore.QueryType.GEO_BOUNDING_BOX_QUERY。
                queryType: TableStore.QueryType.GEO_BOUNDING_BOX_QUERY,
                query: {
                    fieldName: "Col_GeoPoint", //设置列名。
                    topLeft: "10,0", //设置长方形左上角。
                    bottomRight: "0,10" //设置长方形右下角。
                }
            },
            getTotalCount: true //结果中的TotalCount可以表示表中数据的总行数,默认为false,表示不返回。
        },
        columnToGet: { //返回列设置,可设置为RETURN_SPECIFIED(自定义返回列)、RETURN_ALL(返回所有列)、RETURN_ALL_FROM_INDEX(返回多元索引中的所有列)、RETURN_NONE(不返回)。
            returnType: TableStore.ColumnReturnType.RETURN_ALL
        }
    }, function (err, data) {
        if (err) {
            console.log('error:', err);
            return;
        }
        console.log('success:', JSON.stringify(data, null, 2));
    });

地理多边形范围查询(GeoPolygonQuery)

GeoPolygonQuery根据一个多边形范围条件查询表中的数据,当一个地理位置点落在指定的多边形范围内时满足查询条件。

  • 参数
    参数 说明
    tableName 数据表名称。
    indexName 多元索引名称。
    query 多元索引的查询语句。设置查询类型为TableStore.QueryType.GEO_POLYGON_QUERY。
    fieldName 列名,类型为Geopoint。
    points 组成多边形的距离坐标点。

    格式为“纬度,经度”,纬度在前,经度在后,且纬度范围为-90~+90,经度范围-180~+180。例如“35.8,-45.91”。

  • 示例

    查询表中Col_GeoPoint列的值在一个给定多边形范围内的数据。

    client.search({
        tableName: TABLE_NAME,
        indexName: INDEX_NAME,
        searchQuery: {
            offset: 0,
            limit: 10, //如果只为了获取行数,无需获取具体数据,可以设置limit=0,即不返回任意一行数据。
            query: { //设置查询类型为TableStore.QueryType.GEO_POLYGON_QUERY。
                queryType: TableStore.QueryType.GEO_POLYGON_QUERY,
                query: {
                    fieldName: "Col_GeoPoint",
                    points: ["0,0","5,5","5,0"] //设置多边形的顶点。
                }
            },
            getTotalCount: true //结果中的TotalCount可以表示表中数据的总行数,默认为false,表示不返回。
        },
        columnToGet: { //返回列设置,可设置为RETURN_SPECIFIED(自定义返回列)、RETURN_ALL(返回所有列)、RETURN_ALL_FROM_INDEX(返回多元索引中的所有列)、RETURN_NONE(不返回)。
            returnType: TableStore.ColumnReturnType.RETURN_ALL
        }
    }, function (err, data) {
        if (err) {
            console.log('error:', err);
            return;
        }
        console.log('success:', JSON.stringify(data, null, 2));
    });