geo_point_to_h3cell()

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

Obtenga más información sobre H3 Cell.

Syntax

geo_point_to_h3cell(Longitud,Latitud, [ resolution ])

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

Parámetros

Nombre	Tipo	Requerido	Descripción
longitude	real	✔️	Coordenada geoespacial, valor de longitud en grados. El valor válido es un número real y en el intervalo [-180, +180].
latitude	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 los niveles no son válidos, la consulta generará un resultado vacío.

Nota

• H3 Cell puede ser una herramienta de agrupación en clústeres geoespaciales útil.
• H3 Cell tiene 16 niveles de jerarquía con cobertura de área que van desde 4.250.547km² al nivel más alto de 0 a 0,9m² en el nivel más bajo 15.
• H3 Cell tiene una forma hexágona única y esto conduce a algunas propiedades únicas:
• Hexágonos tiene 6 vecinos
• Los hexágonos nos permiten aproximar los radios fácilmente y todos los vecinos son equidistantes
• Hexágonos son visualmente agradables
• En algunos casos raros, la forma es el pentágono.
• H3 Cell tiene un área rectangular en una superficie de plano.
• 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 la celda H3 por valor de resolución

Nivel	Promedio de longitud de 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.5m

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

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 un á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	count	locations
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