Função geo_point_to_s2cell()

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

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

Leia mais sobre a hierarquia de células S2. A célula S2 pode ser uma ferramenta útil de agrupamento geoespacial. Uma célula S2 é uma célula em uma superfície esférica e tem bordas geodésicas. As células S2 fazem parte de uma hierarquia que divide a superfície da Terra. Eles têm um máximo de 31 níveis, variando de zero a 30, que definem o número de vezes que uma célula é subdividida. Os níveis variam desde a maior cobertura no nível zero, com cobertura de área de 85.011.012,19 km², até a menor cobertura de 0,44 cm² no nível 30. Como as células S2 são subdivididas em níveis mais elevados, o centro celular é bem preservado. Duas localizações geográficas podem estar muito próximas uma da outra, mas têm tokens de célula S2 diferentes.

Leia mais sobre a hierarquia de células S2.

Sintaxe

geo_point_to_s2cell( , longitude, latitude [ nível ])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Devoluções

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

Cobertura aproximada da área da célula S2 por valor de nível

Para cada nível, o tamanho da célula S2 é semelhante, mas não exatamente igual. Os tamanhos das células próximas tendem a ser mais iguais.

A fonte da tabela pode ser encontrada neste recurso estatístico da célula S2.

Para comparação com outros sistemas de grade disponíveis, consulte agrupamento geoespacial com Kusto Query Language.

Exemplos

O exemplo a seguir localiza eventos de tempestade dos EUA agregados por células S2.

StormEvents
| project BeginLon, BeginLat
| summarize by hash=geo_point_to_s2cell(BeginLon, BeginLat, 5)
| project geo_s2cell_to_central_point(hash)
| render scatterchart with (kind=map)

Realização

O exemplo a seguir calcula o ID da célula S2.

print s2cell = geo_point_to_s2cell(-80.195829, 25.802215, 8)

Realização

O exemplo a seguir localiza grupos de coordenadas. Cada par de coordenadas no grupo reside na célula S2 com uma área máxima de 1632,45 km².

datatable(location_id:string, longitude:real, latitude:real)
[
  "A", 10.1234, 53,
  "B", 10.3579, 53,
  "C", 10.6842, 53,
]
| summarize count = count(),                                        // items per group count
            locations = make_list(location_id)                      // items in the group
            by s2cell = geo_point_to_s2cell(longitude, latitude, 8) // s2 cell of the group

Realização

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

print s2cell = geo_point_to_s2cell(300,1,8)

Realização

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

print s2cell = geo_point_to_s2cell(1,1,35)

Realização

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

print s2cell = geo_point_to_s2cell(1,1,int(null))

Realização

Conteúdo relacionado

• geo_point_to_geohash()
• geo_point_to_h3cell()