カテゴリ：: 地理空間関数

H3_LATLNG_TO_CELL_STRING¶

特定の緯度、経度、解像度の H3 セル ID を16進数形式で返します（ VARCHAR 値として）。

こちらもご参照ください。: H3_LATLNG_TO_CELL

構文¶

H3_LATLNG_TO_CELL_STRING( <latitude> , <longitude> , <target_resolution> )

Copy

引数¶

latitude

緯度を表す FLOAT。

標準緯度の範囲外の値は、範囲 [-90, 90] に折り返されます。

longitude

経度を表す FLOAT。

標準経度範囲外の値は、範囲 [-180, 180] に折り返されます。

target_resolution

0と15（0と15を含む）の間の INTEGER は、返されるH3セルに使用するH3 解像度を指定します。

それ以外の INTEGER 値を指定するとエラーになります。

戻り値¶

特定の場所と解像度の16進数H3セル ID に対応する VARCHAR 値を返します。

使用上の注意¶

入力引数に NaN またはInf値を指定するとエラーになります。

例¶

次の例は、ブランデンブルク門の解像度8の16進数H3セル ID を返します。

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8);

Copy

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

次の例では、従来の経度範囲（-180～180）から外れた longitude 値（373.377704）を指定しています。この関数はこの値を 13.377704 （373.377704モジュロ180）と解釈します。

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 373.377704, 8);

Copy

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

次の例は、0から15の範囲外に解像度を指定できないことを示しています。

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).