Todos os produtos
Search
Central de documentação

Tablestore:GroupByGeoDistance

Última atualização: Jul 03, 2026

O GroupByGeoDistance agrupa resultados de consulta por localização geográfica. Você pode agrupar os resultados com base em uma área geográfica circular definida por um ponto central e um raio. Valores de campo no mesmo intervalo pertencem ao mesmo grupo. A resposta retorna o intervalo de valores e a quantidade de itens de cada grupo.

Parâmetros da solicitação

message GroupByGeoDistance {
    optional string field_name = 1;
    optional GeoPoint origin = 2;
    repeated Range ranges = 3;
    optional Aggregations sub_aggs = 4;
    optional GroupBys sub_group_bys = 5;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Campo usado para agregação.

origin

GeoPoint

Sim

Longitude e latitude do ponto central.

ranges

repeated Range

Sim

Configurações de intervalo para agrupamento. O intervalo é fechado à esquerda e aberto à direita. Unidade: metro.

sub_aggs

Aggregations

Não

Operação de subagregação. Execute essa operação nos resultados do agrupamento.

sub_group_bys

GroupBys

Não

Operação de sub-GroupBy. Aplique essa operação nos resultados do agrupamento.

Parâmetros da resposta

message GroupByGeoDistanceResult {
    repeated GroupByGeoDistanceResultItem group_by_geo_distance_result_items = 1;
}

Parâmetro

Tipo

Obrigatório

Descrição

group_by_geo_distance_result_items

repeated GroupByGeoDistanceResultItem

Sim

Informações dos grupos retornados.