Kategorien:

Geodatenfunktionen

H3_TRY_GRID_PATH

Eine spezielle Version von H3_GRID_PATH, die NULL zurückgibt, wenn ein Fehler bei dem Versuch auftritt, ein Array von VARIANT-Werten zurückzugeben, die die IDs der H3-Zellen enthalten, die die Linie zwischen zwei Zellen darstellen.

Syntax

H3_TRY_GRID_PATH( <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 Wert vom Datentyp ARRAY oder NULL zurück.

  • Wenn die Funktion eine erfolgreiche Berechnung durchführt, wird ein Array von VARIANT-Werten zurückgegeben, das die IDs der H3-Zellen enthält, die die Linie zwischen den durch cell_id_1 und cell_id_2 angegebenen Zellen repräsentieren. Weitere Informationen zum Format der IDs finden Sie unter H3_GRID_PATH.

  • Wenn die Linie 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_PATH.

Beispiele

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

SELECT H3_TRY_GRID_PATH('813d7ffffffffff', '81343ffffffffff');
Copy
+--------------------------------------------------------+
| H3_TRY_GRID_PATH('813D7FFFFFFFFFF', '81343FFFFFFFFFF') |
|--------------------------------------------------------|
| NULL                                                   |
+--------------------------------------------------------+

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

Sprache: Deutsch