Kategorien:

Geodatenfunktionen

H3_TRY_GRID_DISTANCE

Eine spezielle Version von H3_GRID_DISTANCE, die NULL zurückgibt, wenn ein Fehler bei dem Versuch auftritt, die Distanz zwischen zwei H3-Zellen zurückzugeben.

Syntax

H3_TRY_GRID_DISTANCE( <cell_id_1> , <cell_id_2> )
Copy

Argumente

cell_id_1

Ein INTEGER-Wert, der die ID der H3-Zelle (Index) repräsentiert, oder ein VARCHAR-Wert, der die ID der Zelle im Hexadezimalformat repräsentiert.

cell_id_2

Ein INTEGER-Wert, der die ID der H3-Zelle (Index) repräsentiert, oder ein VARCHAR-Wert, der die ID der Zelle im Hexadezimalformat repräsentiert.

Rückgabewerte

Gibt einen INTEGER-Wert oder NULL zurück.

  • Wenn die Funktion eine erfolgreiche Berechnung durchführen kann, gibt sie den INTEGER-Wert zurück, der den Abstand in Gitterzellen zwischen den beiden H3-Zellen darstellt.

  • Wenn der Gitterabstand nicht berechnet werden kann (z. B. wenn zwei Zellen zu nicht benachbarten Basiszellen gehören), wird NULL zurückgegeben, ohne einen Fehler zu melden.

Nutzungshinweise

Nutzungshinweise finden Sie unter H3_GRID_DISTANCE.

Beispiele

Im folgenden Beispiel wird versucht, den Abstand zwischen zwei Zellen zu berechnen. Da die Zellen zu nicht benachbarten Basiszellen gehören, kann die Funktion den Abstand nicht berechnen und gibt NULL zurück.

SELECT H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719);
Copy
+--------------------------------------------------------------+
| H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719) |
|--------------------------------------------------------------|
|                                                         NULL |
+--------------------------------------------------------------+

Beispiele für die erfolgreiche Berechnung des Abstands zwischen zwei H3-Zellen finden Sie unter H3_GRID_DISTANCE.

Sprache: Deutsch