punto_geo_a_celda_h3()

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula el valor de cadena de token de celda H3 de una ubicación geográfica.

Obtenga más información sobre la celda H3.

Sintaxis

geo_point_to_h3cell( latitud de longitud,, [ resolución ])

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Obligatorio	Descripción
longitud	real	✔️	Coordenada geoespacial, valor de longitud en grados. El valor válido es un número real y en el intervalo [-180, +180].
latitud	real	✔️	Coordenada geoespacial, valor de latitud en grados. El valor válido es un número real y en el intervalo [-90, +90].
resolución	int		Define la resolución de celda solicitada. Los valores admitidos están en el intervalo [0, 15]. Si no se especifica, se usa el valor predeterminado 6.

Devoluciones

Valor de cadena de token de celda H3 de una ubicación geográfica determinada. Si las coordenadas o niveles no son válidas, la consulta generará un resultado vacío.

Nota:

• La celda H3 puede ser una herramienta útil de agrupación en clústeres geoespaciales.
• H3 Cell tiene 16 niveles de jerarquía con cobertura de área que van desde 4.250.547km² en el nivel más alto de 0 a 0,9m² en el nivel más bajo 15.
• La celda H3 tiene una forma hexágona única y esto conduce a algunas propiedades únicas:
• Hexágonos tiene 6 vecinos
• Hexágonos nos permiten aproximarnos fácilmente a los radios y todos los vecinos son equidistantes
• Hexágonos son visualmente agradables
• En algunos casos poco frecuentes, la forma es el pentágono.
• La celda H3 tiene un área rectangular en una superficie plana.
• Invocar la función geo_h3cell_to_central_point() en una cadena de token de celda H3 que se calculó en longitud x y latitud y no devolverá necesariamente x e y.
• Es posible que dos ubicaciones geográficas estén muy cerca entre sí, pero que tengan tokens de celda H3 diferentes.

Cobertura de área aproximada de celda H3 por valor de resolución

Nivel	Longitud media del borde hexágono
0	1108 km
1	419 km
2	158 km
3	60 km
4	23 km
5	8 km
6	3 km
7	1 km
8	460 m
9	174 m
10	66 m
11	25 m
12	9 m
13	3 m
14	1 m
15	0,5 m

El origen de la tabla se puede encontrar en este recurso estadístico de celda H3.

Consulte también geo_point_to_s2cell() geo_point_to_geohash().

Para comparar con otros sistemas de cuadrícula disponibles. consulte agrupación en clústeres geoespaciales con Lenguaje de consulta Kusto.

Ejemplos

En el ejemplo siguiente se calcula el valor de cadena del token de celda H3 de una ubicación geográfica.

Ejecución de la consulta

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

Salida

h3cell
862a1072fffffff

En el ejemplo siguiente se buscan grupos de coordenadas. Cada par de coordenadas del grupo reside en la celda H3 con área hexágona media de 253 km².

Ejecución de la 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

Salida

h3cell	Recuento	ubicaciones
852a100bfffffff	2	[ "A", "B" ]
852a1073fffffff	1	[ "C" ]

En el ejemplo siguiente se genera un resultado vacío debido a la entrada de coordenadas no válida.

Ejecución de la consulta

print h3cell = geo_point_to_h3cell(300,1,8)

Salida

h3cell

En el ejemplo siguiente se genera un resultado vacío debido a la entrada de nivel no válida.

Ejecución de la consulta

print h3cell = geo_point_to_h3cell(1,1,16)

Salida

h3cell

En el ejemplo siguiente se genera un resultado vacío debido a la entrada de nivel no válida.

Ejecución de la consulta

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

Salida

h3cell