Kategorien:

Geodatenfunktionen

H3_LATLNG_TO_CELL

Gibt den INTEGER-Wert der ID einer H3-Zelle für einen bestimmten Längen- und Breitengrad und eine bestimmte Auflösung zurück.

Siehe auch:

H3_LATLNG_TO_CELL_STRING

Syntax

H3_LATLNG_TO_CELL( <latitude> , <longitude> , <target_resolution> )
Copy

Argumente

latitude

Ein FLOAT-Wert, der den Breitengrad darstellt.

Werte außerhalb des Standardbereichs für den Breitengrad werden in den Bereich [-90, 90] eingeordnet.

longitude

Ein FLOAT-Wert, der den Längengrad darstellt.

Werte außerhalb des Standardlängenbereichs werden in den Bereich [-180, 180] eingeordnet.

target_resolution

Ein INTEGER-Wert zwischen 0 und 15 (einschließlich), der die H3-Auflösung angibt, die Sie für die zurückgegebene H3-Zelle verwenden möchten.

Die Angabe eines beliebigen anderen INTEGER-Werts führt zu einem Fehler.

Rückgabewerte

Gibt einen INTEGER-Wert zurück, der der ID der H3-Zelle für den angegebenen Standort und die angegebene Auflösung entspricht.

Nutzungshinweise

  • Die Angabe von NaN- oder Inf-Werten für ein beliebiges Eingabeargument führt zu einem Fehler.

Beispiele

Im folgenden Beispiel wird die ID der H3-Zelle für das Brandenburger Tor bei Auflösung 8 zurückgegeben.

SELECT H3_LATLNG_TO_CELL(52.516262, 13.377704, 8);
Copy
+--------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 13.377704, 8) |
|--------------------------------------------|
|                         613036919424548863 |
+--------------------------------------------+

Im folgenden Beispiel wird ein longitude-Wert (373.377704) angegeben, der außerhalb des traditionellen Längengradbereichs (-180 bis 180) liegt. Die Funktion interpretiert diesen Wert als 13.377704 (373,377704 modulo 180).

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 8);
Copy
+---------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 373.377704, 8) |
|---------------------------------------------|
|                          613036919424548863 |
+---------------------------------------------+

Das folgende Beispiel zeigt, dass Sie für die Auflösung keinen Wert außerhalb von 0 bis 15 angeben können.

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 18);
Copy
100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).