geo_point_to_h3cell()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula o valor da cadeia de caracteres de token da célula H3 de uma localização geográfica.

Leia mais sobre o H3 Cell.

Sintaxe

geo_point_to_h3cell(longitude, latitude, [ resolução ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
longitude	real	✔️	Coordenada geoespacial, valor de longitude em graus. O valor válido é um número real e está no intervalo [-180, +180].
latitude	real	✔️	Coordenada geoespacial, valor da latitude em graus. O valor válido é um número real e está no intervalo [-90, +90].
resolução	int		Define a resolução da célula solicitada. Os valores suportados estão no intervalo [0, 15]. Se não for especificado, o valor padrão 6 será usado.

Devoluções

O valor da cadeia de caracteres de token da célula H3 de uma determinada localização geográfica. Se as coordenadas ou níveis forem inválidos, a consulta produzirá um resultado vazio.

Observação

• A célula H3 pode ser uma ferramenta útil de agrupamento geoespacial.
• A Célula H3 possui 16 níveis de hierarquia com cobertura de área que varia de 4.250.547km² no nível mais alto 0 a 0,9m² no nível mais baixo 15.
• A célula H3 tem uma forma hexagonal única e isso leva a algumas propriedades únicas:
• Os hexágonos têm 6 vizinhos
• Os hexágonos nos permitem aproximar os raios facilmente e todos os vizinhos são equidistantes
• Os hexágonos são visualmente agradáveis
• Em alguns casos raros, a forma é pentágono.
• A célula H3 tem uma área retangular em uma superfície plana.
• Invocar a função geo_h3cell_to_central_point() em uma cadeia de caracteres de token de célula H3 que foi calculada na longitude x e na latitude y não retornará necessariamente x e y.
• É possível que duas localizações geográficas estejam muito próximas uma da outra, mas tenham tokens H3 Cell diferentes.

Cobertura aproximada da área da célula H3 por valor de resolução

Nível	Comprimento médio da borda do hexágono
0	1108 km
1	419 km
2	158 km
3	60 km
4	23 quilômetros
5	8 km
6	3 km
7	1 km
8	460 metros acima do nível do mar
9	174 metros acima do nível do mar
10	66 metros acima do nível do mar
11	25 metros acima do nível do mar
12	9 metros acima do nível do mar
13	3 metros acima do nível do mar
14	1min
15	0,5 metros

A fonte da tabela pode ser encontrada neste recurso estatístico H3 Cell.

Veja também geo_point_to_s2cell(), geo_point_to_geohash().

Para comparação com outros sistemas de grade disponíveis. consulte clustering geoespacial com a Linguagem de Consulta Kusto.

Exemplos

Executar a consulta

print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)

Saída

h3cell
862a1072ff

O exemplo a seguir localiza grupos de coordenadas. Cada par de coordenadas do grupo reside na célula H3 com área média de hexágono de 253 km².

Executar a consulta

datatable(location_id:string, longitude:real, latitude:real)
[
    "A", -73.956683, 40.807907,
    "B", -73.916869, 40.818314,
    "C", -73.989148, 40.743273,
]
| summarize count = count(),                                         // Items per group count
            locations = make_list(location_id)                       // Items in the group
            by h3cell = geo_point_to_h3cell(longitude, latitude, 5)  // H3 Cell of the group

Saída

h3cell	count	Locais
852a100bfffffff	2	[ "UMA", "B" ]
852a1073fffffff	1	[ "C" ]

O exemplo a seguir produz um resultado vazio devido à entrada de coordenadas inválida.

Executar a consulta

print h3cell = geo_point_to_h3cell(300,1,8)

Saída

h3cell

O exemplo a seguir produz um resultado vazio devido à entrada de nível inválida.

Executar a consulta

print h3cell = geo_point_to_h3cell(1,1,16)

Saída

h3cell

O exemplo a seguir produz um resultado vazio devido à entrada de nível inválida.

Executar a consulta

print h3cell = geo_point_to_h3cell(1,1,int(null))

Saída

h3cell