Kategorien:

Geodatenfunktionen

H3_GRID_DISK

Gibt ein ARRAY der IDs der H3-Zellen zurück, die innerhalb der k-Distanz von der angegebenen Zelle liegen. Die IDs in dem zurückgegebenen ARRAY sind INTEGER-Werte (wenn ein INTEGER-Wert als Eingabe-ID angegeben wurde) oder VARCHAR-Werte, die die hexadezimalen IDs enthalten (wenn eine hexadezimale ID als Eingabe-ID angegeben wurde).

Syntax

H3_GRID_DISK( <cell_id> , <k_value> )
Copy

Argumente

cell_id

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.

k_value

Ein INTEGER-Wert, der den Gitterabstand repräsentiert. Sie müssen einen nicht-negativen Wert angeben.

Rückgabewerte

Gibt ein ARRAY der IDs von H3-Zellen zurück, die innerhalb der Distanz k_value von der durch cell_id angegebenen Zelle liegen. Die IDs haben eines der folgenden Formate:

  • Wenn cell_id ein INTEGER-Wert ist, gibt die Funktion die IDs als INTEGER-Werte zurück.

  • Wenn cell_id ein VARCHAR-Wert ist, der die hexadezimale ID enthält, gibt die Funktion die hexadezimalen IDs als VARCHAR-Werte zurück.

Beispiele

Im folgenden Beispiel wird ein ARRAY der IDs von H3-Zellen innerhalb des Gitterabstands von 1 von der Zelle mit der ID 617540519050084351 (angegeben als INTEGER-Wert) zurückgegeben.

SELECT H3_GRID_DISK(617540519050084351, 1);
Copy
+-------------------------------------+
| H3_GRID_DISK(617540519050084351, 1) |
|-------------------------------------|
| [                                   |
|   617540519050084351,               |
|   617540519051657215,               |
|   617540519050608639,               |
|   617540519050870783,               |
|   617540519050346495,               |
|   617540519051395071,               |
|   617540519051132927                |
| ]                                   |
+-------------------------------------+

Im folgenden Beispiel wird ein ARRAY der IDs von H3-Zellen innerhalb des Gitterabstands von 1 von der Zelle mit der ID 891f1d48863ffff (angegeben als VARCHAR-Wert) zurückgegeben.

SELECT H3_GRID_DISK('891f1d48863ffff', 1);
Copy
+------------------------------------+
| H3_GRID_DISK('891F1D48863FFFF', 1) |
|------------------------------------|
| [                                  |
|   "891f1d48863ffff",               |
|   "891f1d4887bffff",               |
|   "891f1d4886bffff",               |
|   "891f1d4886fffff",               |
|   "891f1d48867ffff",               |
|   "891f1d48877ffff",               |
|   "891f1d48873ffff"                |
| ]                                  |
+------------------------------------+