35.49 SDO_UTIL.H3_PARENT

書式

SDO_UTIL.H3_PARENT(
  h3_key     IN RAW,
  resolution IN NUMBER DEFAULT NULL
) RETURN RAW;

説明

H3階層に基づいて、指定されたセルを含んでいるH3セル(64ビット(8バイトRAW) )を計算します。

パラメータ

h3_key

問い合せるH3セル。

resolution

含んでいるセルに必要なレベルを指定します。

H3_RESOLUTION(h3_key)は数値である必要があります。NULLの場合、直近の親(1レベル粗い)が返されます。

使用上のノート

H3階層内のセルは、常に親セルに厳密に含まれているわけではなく、極端な場合は、3レベル以上粗くても含んでいるセルが接していないこともあります。

特定のセルとほとんど重複する、数段上のレベルの粗い解像度のセルが必要な場合は、別の方法として、中心のH3セルを計算します。たとえば、SDO_UTIL.H3_KEY(SDO_UTIL.H3_CENTER(h3_key), resolution)のようにします。

例

次の例は、レベル7セルの親がレベル6セルであることを示しています。

SELECT SDO_UTIL.H3_RESOLUTION('0877AA5145FFFFFF') FROM DUAL;
7

SELECT SDO_UTIL.H3_PARENT('0877AA5145FFFFFF') FROM DUAL;
0867AA5147FFFFFF

SELECT SDO_UTIL.H3_RESOLUTION('0867AA5147FFFFFF') FROM DUAL;
6