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

H3_LATLNG_TO_CELL¶

特定の緯度、経度、解像度の H3 セル ID の INTEGER 値を返します。

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

構文¶

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

Copy

引数¶

latitude

緯度を表す FLOAT。

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

longitude

経度を表す FLOAT。

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

target_resolution

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

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

戻り値¶

特定の位置と解像度のH3セル ID に対応する INTEGER 値を返します。

使用上の注意¶

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

例¶

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

SELECT H3_LATLNG_TO_CELL(52.516262, 13.377704, 8);

Copy

+--------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 13.377704, 8) |
|--------------------------------------------|
|                         613036919424548863 |
+--------------------------------------------+

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

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 8);

Copy

+---------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 373.377704, 8) |
|---------------------------------------------|
|                          613036919424548863 |
+---------------------------------------------+

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

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 18);

Copy

100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).