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 |
Importante: O formato das coordenadas élatitude,longitude— a latitude vem primeiro. Essa ordem é oposta à do GeoJSON, que utilizalongitude,latitude. Inverter essa sequência é uma das causas mais frequentes de resultados incorretos em consultas de geopolígono.