35.47 SDO_UTIL.H3_KEY

書式

SDO_UTIL.H3_KEY(
 longitude  IN NUMBER,
 latitude   IN NUMBER,
 resolution IN NUMBER DEFAULT 15) RETURN RAW;

SDO_UTIL.H3_KEY(
 geometry   IN mdsys.sdo_geometry,
 resolution IN NUMBER DEFAULT 15) RETURN RAW;

説明

指定された測地点と解像度のH3セルを返します。

パラメータ

longitude

入力点の経度。

latitude

入力点の緯度。

geometry

測地座標系内の単一点で構成されるジオメトリ。SRIDはNULL以外である必要があります。SRID 4326でない場合、点はSRID 4326に変換されます。

resolution

返すH3セルの解像度。解像度はゼロ(最も粗い)から15 (最も細い)です。

使用上のノート

SDO_UTIL.H3_KEYファンクションは、点の位置をUber社が設計した六角形の階層空間索引付けシステムに変換します。この索引付けシステムでは、世界が122の解像度0セルに分割され、それぞれ最上位レベル(レベル0)で4.4百万km²のセルになります。セルは二十面体(正二十面のポリゴン)にマッピングされます。解像度が上がるたびに、レベル15までさらに小さいセルに分割されます。レベル15には、それぞれ約1 m²のセルが569,707,381,193,162個あります。セルは、各レベルの12個の五角形以外は六角形です(球は六角形のみではタイル処理できません)。六角形は、さらに小さな六角形に正確に分割することはできません。その結果、親セルの境界付近のセルは、親セルに完全には含まれません。

H3は、常にSRID 4326座標系で計算されます。

例

次の例は、パリのH3セルを示しています。

SELECT SDO_UTIL.H3_KEY(48.85755957774311, 2.344920508484808, 7) FROM DUAL;
0877AA5145FFFFFF

次の例は、北極を含む最小のH3セル(レベル15)を示しています。

SELECT SDO_UTIL.H3_KEY(SDO_GEOMETRY(2001, 4326, SDO_POINT_TYPE(0, 90, NULL), NULL, NULL), 15);
08F0326233AB0399