Todos os produtos
Search
Central de documentação

Tablestore:GeoPolygonQuery

Última atualização: Jul 03, 2026

A GeoPolygonQuery filtra linhas com base em uma área geográfica poligonal. O Tablestore retorna as linhas cujo valor na coluna GeoPoint especificada esteja dentro do polígono definido. Use esse tipo de consulta para filtrar dados conforme limites geográficos complexos, como zonas de entrega, distritos administrativos ou áreas de cobertura de serviço.

Estrutura de dados

message GeoPolygonQuery {
    optional string field_name = 1;
    repeated string points = 2;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Nome da coluna de atributo a consultar. A coluna deve ser do tipo GeoPoint.

points

string

Sim

Pares de coordenadas dos vértices que definem o polígono. Cada valor deve seguir o formato latitude,longitude. Valores válidos de latitude: [-90,+90]. Valores válidos de longitude: [-180,+180]. Exemplo: 35.8,-45.91.

Importante: O formato das coordenadas é latitude,longitude — a latitude vem primeiro. Essa ordem é oposta à do GeoJSON, que utiliza longitude,latitude . Inverter essa sequência é uma das causas mais frequentes de resultados incorretos em consultas de geopolígono.