Kategorien:

Geodatenfunktionen

H3_LATLNG_TO_CELL_STRING

Snowflake logo in black (no text) Vorschau-Feature – Offen

Verfügbar bei allen Konten.

Gibt die ID der H3-Zelle im hexadezimalen Format (als VARCHAR-Wert) für einen bestimmten Längen- und Breitengrad und eine bestimmte Auflösung zurück.

Siehe auch:

H3_LATLNG_TO_CELL

Syntax

H3_LATLNG_TO_CELL_STRING( <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 VARCHAR-Wert zurück, der der hexadezimalen 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 hexadezimale ID der H3-Zelle für das Brandenburger Tor bei Auflösung 8 zurückgegeben.

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8);
Copy
+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

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_STRING(52.516262, 373.377704, 8);
Copy
+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

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_STRING(52.516262, 373.377704, 18);
Copy
100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).
Sprache: Deutsch