H3 인덱스를 다루는 함수 - ClickHouse Documentation

H3 인덱스

H3는 지구 표면을 균일한 육각형 셀의 격자로 나누는 지리 공간 인덱싱 시스템입니다. 이 시스템은 계층 구조를 가지며, 즉 최상위 수준의 각 육각형(“parent”)은 크기가 더 작은 균일한 7개의 육각형(“children”)으로 분할될 수 있고, 이러한 방식이 계속 반복됩니다. 이 계층 구조의 수준을 resolution이라고 하며, 값은 0부터 15까지입니다. 이때 0은 가장 크고 가장 거친 셀을 갖는 base 수준입니다. 위도와 경도의 쌍은 격자 셀을 식별하는 64비트 H3 인덱스로 변환할 수 있습니다. H3 인덱스는 주로 위치를 버킷으로 그룹화하거나 그 밖의 지리 공간 작업을 수행하는 데 사용됩니다. H3 시스템에 대한 전체 설명은 Uber Engineering 사이트에서 확인할 수 있습니다.

h3IsValid

숫자가 유효한 H3 인덱스인지 확인합니다. 구문

h3IsValid(h3index)

매개변수

h3index — 육각형 인덱스 번호입니다. UInt64.

반환 값

1 — 해당 숫자는 유효한 H3 인덱스입니다. UInt8.
0 — 해당 숫자는 유효한 H3 인덱스가 아닙니다. UInt8.

예시

Query

SELECT h3IsValid(630814730351855103) AS h3IsValid;

Response

┌─h3IsValid─┐
│         1 │
└───────────┘

h3GetResolution

지정된 H3 인덱스의 해상도를 반환합니다. 구문

h3GetResolution(h3index)

매개변수

h3index — 육각형 인덱스 번호. UInt64.

반환 값

인덱스 해상도. 범위: [0, 15]. UInt8.
인덱스가 유효하지 않으면 함수는 임의의 값을 반환합니다. 인덱스를 검증하려면 h3IsValid를 사용하십시오. UInt8.

예시

Query

SELECT h3GetResolution(639821929606596015) AS resolution;

Response

┌─resolution─┐
│         14 │
└────────────┘

h3EdgeAngle

H3 육각형 변의 평균 길이를 그라드 단위로 계산합니다. 구문

h3EdgeAngle(resolution)

매개변수

resolution — 인덱스 해상도. UInt8. 범위: [0, 15].

반환 값

그라드 단위의 H3 육각형 변 평균 길이입니다. Float64.

예시

Query

SELECT h3EdgeAngle(10) AS edgeAngle;

Response

┌───────h3EdgeAngle(10)─┐
│ 0.0005927224846720883 │
└───────────────────────┘

h3EdgeLengthM

H3 육각형의 변 길이 평균을 미터 단위로 계산합니다. 구문

h3EdgeLengthM(resolution)

매개변수

resolution — 인덱스 해상도입니다. UInt8. 범위: [0, 15].

반환 값

미터 단위 H3 육각형의 평균 변 길이입니다. Float64.

예시

Query

SELECT h3EdgeLengthM(15) AS edgeLengthM;

Response

┌─edgeLengthM─┐
│ 0.509713273 │
└─────────────┘

h3EdgeLengthKm

H3 육각형의 변 길이 평균을 킬로미터 단위로 계산합니다. 구문

h3EdgeLengthKm(resolution)

매개변수

resolution — 인덱스 해상도. UInt8. 범위: [0, 15].

반환 값

H3 육각형 변의 평균 길이(킬로미터 단위). Float64.

예시

Query

SELECT h3EdgeLengthKm(15) AS edgeLengthKm;

Response

┌─edgeLengthKm─┐
│  0.000509713 │
└──────────────┘

geoToH3

지정된 해상도의 H3 점 인덱스 (lat, lon)를 반환합니다. 구문

geoToH3(lat, lon, resolution)

인수

lat — 위도. Float64.
lon — 경도. Float64.
resolution — 인덱스 해상도. 범위: [0, 15]. UInt8.

반환 값

육각형 인덱스 번호. UInt64.
오류 발생 시 0. UInt64.

참고: ClickHouse v25.4 이하에서는 geoToH3()가 값을 (lon, lat) 순서로 받습니다. ClickHouse v25.5부터는 입력 값의 순서가 (lat, lon)입니다. 이전 동작은 geotoh3_argument_order = 'lon_lat' 설정으로 복원할 수 있습니다. 예시

Query

SELECT geoToH3(55.71290588, 37.79506683, 15) AS h3Index;

Response

┌────────────h3Index─┐
│ 644325524701193974 │
└────────────────────┘

h3ToGeo

주어진 H3 인덱스에 해당하는 중심점의 위도와 경도를 반환합니다. 구문

h3ToGeo(h3Index)

인수

h3Index — H3 인덱스. UInt64.

반환 값

두 개의 값으로 이루어진 튜플입니다: tuple(lat,lon). lat — 위도. Float64. lon — 경도. Float64.

참고: ClickHouse v24.12 이하에서는 h3ToGeo()가 (lon, lat) 순서로 값을 반환합니다. ClickHouse v25.1부터는 반환 값이 (lat, lon) 순서입니다. 이전 동작은 설정 h3togeo_lon_lat_result_order = true를 사용해 복원할 수 있습니다. 예시

Query

SELECT h3ToGeo(644325524701193974) AS coordinates;

Response

┌─coordinates───────────────────────────┐
│ (55.71290243145668,37.79506616830252) │
└───────────────────────────────────────┘

h3ToGeoBoundary

주어진 H3 인덱스의 경계에 해당하는 (lat, lon) 쌍의 배열을 반환합니다. 구문

h3ToGeoBoundary(h3Index)

인수

h3Index — H3 인덱스. UInt64.

반환 값

‘(lat, lon)’ 쌍으로 이루어진 배열. Array(Float64, Float64).

예시

Query

SELECT h3ToGeoBoundary(644325524701193974) AS coordinates;

Response

┌─h3ToGeoBoundary(599686042433355775)────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [(37.2713558667319,-121.91508032705622),(37.353926450852256,-121.8622232890249),(37.42834118609435,-121.92354999630156),(37.42012867767779,-122.03773496427027),(37.33755608435299,-122.090428929044),(37.26319797461824,-122.02910130919001)] │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

h3kRing

주어진 육각형에서 반경 k 이내에 있는 모든 H3 육각형을 무작위 순서로 나열합니다. 구문

h3kRing(h3index, k)

인수

h3index — 육각형 인덱스 번호. UInt64.
k — 반경. integer

반환 값

H3 인덱스 배열. Array(UInt64).

예시

Query

SELECT arrayJoin(h3kRing(644325529233966508, 1)) AS h3index;

Response

┌────────────h3index─┐
│ 644325529233966508 │
│ 644325529233966497 │
│ 644325529233966510 │
│ 644325529233966504 │
│ 644325529233966509 │
│ 644325529233966355 │
│ 644325529233966354 │
└────────────────────┘

h3PolygonToCells

제공된 Geometry(링 또는 (multi-)polygon)에 포함된 지정된 해상도의 육각형을 반환합니다. Geometry가 육각형의 중심을 포함할 때 해당 육각형이 포함된 것으로 간주하며, 이는 h3PolygonToCellsWithContainment의 포함 모드 0입니다. Geometry의 모든 꼭짓점은 구면 위에 있어야 합니다. 경도는 [-180, 180], 위도는 [-90, 90]도 범위여야 합니다. 반환되는 셀의 순서는 보장되지 않으므로 순서가 중요할 때는 배열을 정렬하십시오. 구문

h3PolygonToCells(geometry, resolution)

인수

geometry는 다음 Geo 데이터 타입 또는 그 기반이 되는 기본 타입 중 하나일 수 있습니다:
resolution — 인덱스 해상도입니다. 범위: [0, 15]. UInt8.

반환 값

포함된 H3 인덱스의 배열(UInt64).

예시

Query

SELECT h3PolygonToCells([(-122.4089866999972145,37.813318999983238),(-122.3544736999993603,37.7198061999978478),(-122.4798767000009008,37.8151571999998453)], 7) AS h3index;

Response

┌────────────h3index─┐
│ 608692970585063423 │
│ 608692970719281151 │
│ 608692970752835583 │
│ 608692970769612799 │
│ 608692970819944447 │
│ 608692971927240703 │
│ 608692972027903999 │
└────────────────────┘

h3PolygonToCellsWithContainment

H3 Experimental 포함 모드를 사용하여 제공된 geometry가 차지하는 영역을 지정된 해상도의 육각형으로 덮어 반환합니다. geometry는 링 또는 (multi-)polygon일 수 있습니다. geometry의 모든 꼭짓점은 구면 위에 있어야 합니다. 경도는 [-180, 180], 위도는 [-90, 90]도 범위여야 합니다. 반환되는 셀의 순서는 보장되지 않으므로 순서가 중요할 때는 배열을 정렬하십시오. 이 함수는 flags를 다음 H3 포함 모드에 매핑합니다:

0 — CONTAINMENT_CENTER
1 — CONTAINMENT_FULL
2 — CONTAINMENT_OVERLAPPING
3 — CONTAINMENT_OVERLAPPING_BBOX

구문

h3PolygonToCellsWithContainment(geometry, resolution, flags)

인수

geometry는 다음 Geo 데이터 타입 또는 그 기반이 되는 기본 타입 중 하나일 수 있습니다:
resolution — 인덱스 해상도입니다. 범위: [0, 15]. UInt8.
flags — 포함 모드입니다. 범위: [0, 3]. 0, 1, 2, 3과 같은 정수 리터럴 또는 UInt32 값(예: toUInt32(2))을 사용하십시오. 값은 H3 API에 UInt32로 전달됩니다. 다른 네이티브 정수 타입에는 정확한 형변환이 적용됩니다.

반환 값

선택한 포함 모드에 따른 H3 인덱스 배열입니다. 배열(UInt64).

예시

Query

SELECT
    h3PolygonToCellsWithContainment([(-122.4089866999972145, 37.813318999983238), (-122.3544736999993603, 37.7198061999978478), (-122.4798767000009008, 37.8151571999998453)], 7, 0) AS center_cells,
    h3PolygonToCellsWithContainment([(-122.4089866999972145, 37.813318999983238), (-122.3544736999993603, 37.7198061999978478), (-122.4798767000009008, 37.8151571999998453)], 7, 2) AS overlap_cells;

Response

   ┌─center_cells───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬─overlap_cells──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
1. │ [608692970585063423,608692970719281151,608692970752835583,608692970769612799,608692970819944447,608692971927240703,608692972027903999] │ [608692970249519103,608692970266296319,608692970585063423,608692970601840639,608692970635395071,608692970685726719,608692970719281151,608692970736058367,608692970752835583,608692970769612799,608692970786390015,608692970819944447,608692971927240703,608692971994349567,608692972027903999] │
   └────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

h3GetBaseCell

H3 인덱스의 기본 셀 번호를 반환합니다. 구문

h3GetBaseCell(index)

매개변수

index — 육각형 인덱스 번호입니다. UInt64.

반환 값

육각형의 기본 셀 번호입니다. UInt8.

예시

Query

SELECT h3GetBaseCell(612916788725809151) AS basecell;

Response

┌─basecell─┐
│       12 │
└──────────┘

h3HexAreaM2

주어진 해상도에서 육각형의 평균 면적을 제곱미터(m²) 단위로 반환합니다. 구문

h3HexAreaM2(resolution)

매개변수

resolution — 인덱스 해상도. 범위: [0, 15]. UInt8.

반환 값

제곱미터 단위의 면적. Float64.

예시

Query

SELECT h3HexAreaM2(13) AS area;

Response

┌─area─┐
│ 43.9 │
└──────┘

h3HexAreaKm2

주어진 해상도에서 평균 육각형 면적을 제곱킬로미터 단위로 반환합니다. 구문

h3HexAreaKm2(resolution)

매개변수

resolution — 인덱스 해상도입니다. 범위: [0, 15]. UInt8.

반환 값

제곱킬로미터 단위의 면적입니다. Float64.

예시

Query

SELECT h3HexAreaKm2(13) AS area;

Response

┌──────area─┐
│ 0.0000439 │
└───────────┘

h3IndexesAreNeighbors

주어진 H3 인덱스가 서로 인접해 있는지 반환합니다. 구문

h3IndexesAreNeighbors(index1, index2)

인수

index1 — 육각형 인덱스 번호입니다. UInt64.
index2 — 육각형 인덱스 번호입니다. UInt64.

반환 값

1 — 인덱스가 서로 이웃합니다. UInt8.
0 — 인덱스가 서로 이웃하지 않습니다. UInt8.

예시

Query

SELECT h3IndexesAreNeighbors(617420388351344639, 617420388352655359) AS n;

Response

┌─n─┐
│ 1 │
└───┘

h3ToChildren

주어진 H3 인덱스의 자식 인덱스 배열을 반환합니다. 구문

h3ToChildren(index, resolution)

인수

index — 육각형 인덱스 번호. UInt64.
resolution — 인덱스 해상도. 범위: [0, 15]. UInt8.

반환 값

하위 H3 인덱스의 배열. Array(UInt64).

예시

Query

SELECT h3ToChildren(599405990164561919, 6) AS children;

Response

┌─children───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [603909588852408319,603909588986626047,603909589120843775,603909589255061503,603909589389279231,603909589523496959,603909589657714687] │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

h3ToParent

지정된 H3 인덱스를 포함하는 상위(더 낮은 해상도의) 인덱스를 반환합니다. 구문

h3ToParent(index, resolution)

인수

index — 육각형 인덱스 번호. UInt64.
resolution — 인덱스의 해상도. 범위: [0, 15]. UInt8.

반환 값

상위 H3 인덱스. UInt64.

예시

Query

SELECT h3ToParent(599405990164561919, 3) AS parent;

Response

┌─────────────parent─┐
│ 590398848891879423 │
└────────────────────┘

h3ToString

인덱스의 H3Index 표현을 문자열 형식으로 변환합니다.

h3ToString(index)

매개변수

index — 육각형 인덱스 번호입니다. UInt64.

반환 값

H3 인덱스의 문자열 형식입니다. String.

예시

Query

SELECT h3ToString(617420388352917503) AS h3_string;

Response

┌─h3_string───────┐
│ 89184926cdbffff │
└─────────────────┘

stringToH3

문자열 형식을 H3Index(UInt64) 형식으로 변환합니다. 구문

stringToH3(index_str)

매개변수

index_str — H3 인덱스의 문자열 형식입니다. String.

반환 값

육각형 인덱스 번호입니다. 오류가 발생하면 0을 반환합니다. UInt64.

예시

Query

SELECT stringToH3('89184926cc3ffff') AS index;

Response

┌──────────────index─┐
│ 617420388351344639 │
└────────────────────┘

h3GetResolution

H3 인덱스의 해상도를 반환합니다. 구문

h3GetResolution(index)

매개변수

index — 육각형 인덱스 번호. UInt64.

반환 값

인덱스의 해상도. 범위: [0, 15]. UInt8.

예시

Query

SELECT h3GetResolution(617420388352917503) AS res;

Response

┌─res─┐
│   9 │
└─────┘

h3IsResClassIII

H3 인덱스가 Class III 방향 해상도인지 여부를 반환합니다. 구문

h3IsResClassIII(index)

매개변수

index — 육각형 인덱스 번호. UInt64.

반환 값

1 — 인덱스의 해상도가 Class III 방향입니다. UInt8.
0 — 인덱스의 해상도가 Class III 방향이 아닙니다. UInt8.

예시

Query

SELECT h3IsResClassIII(617420388352917503) AS res;

Response

┌─res─┐
│   1 │
└─────┘

h3IsPentagon

이 H3 인덱스가 오각형 셀을 나타내는지 반환합니다. 구문

h3IsPentagon(index)

매개변수

index — 육각형 인덱스 번호. UInt64.

반환 값

1 — 인덱스가 오각형 셀을 나타냅니다. UInt8.
0 — 인덱스가 오각형 셀을 나타내지 않습니다. UInt8.

예시

Query

SELECT h3IsPentagon(644721767722457330) AS pentagon;

Response

┌─pentagon─┐
│        0 │
└──────────┘

h3GetFaces

지정된 H3 인덱스가 교차하는 정이십면체의 면을 반환합니다. 구문

h3GetFaces(index)

매개변수

index — 육각형 인덱스 번호. UInt64.

반환 값

지정된 H3 인덱스가 교차하는 정이십면체 면을 포함하는 배열. 배열(UInt64).

예시

Query

SELECT h3GetFaces(599686042433355775) AS faces;

Response

┌─faces─┐
│ [7]   │
└───────┘

h3CellAreaM2

주어진 H3 인덱스에 해당하는 특정 셀의 정확한 면적을 제곱미터 단위로 반환합니다. 구문

h3CellAreaM2(index)

매개변수

index — 육각형 인덱스 번호. UInt64.

반환 값

제곱미터 단위의 셀의 면적. Float64.

예시

Query

SELECT h3CellAreaM2(579205133326352383) AS area;

Response

┌───────────────area─┐
│ 4106166334463.9233 │
└────────────────────┘

h3CellAreaRads2

주어진 H3 인덱스에 해당하는 특정 셀의 정확한 면적을 제곱 라디안 단위로 반환합니다. 구문

h3CellAreaRads2(index)

매개변수

index — 육각형 인덱스 번호. UInt64.

반환 값

제곱 라디안 단위의 셀 면적입니다. Float64.

예시

Query

SELECT h3CellAreaRads2(579205133326352383) AS area;

Response

┌────────────────area─┐
│ 0.10116268528089567 │
└─────────────────────┘

h3ToCenterChild

주어진 H3에서 지정된 해상도의 중심 자식(더 세분화된) H3 인덱스를 반환합니다. 구문

h3ToCenterChild(index, resolution)

매개변수

index — 육각형 인덱스 번호. UInt64.
resolution — 인덱스 해상도. 범위: [0, 15]. UInt8.

반환 값

지정된 해상도에서 주어진 H3에 포함되는 중앙 자식의 H3 인덱스입니다. UInt64.

예시

Query

SELECT h3ToCenterChild(577023702256844799,1) AS centerToChild;

Response

┌──────centerToChild─┐
│ 581496515558637567 │
└────────────────────┘

h3ExactEdgeLengthM

입력된 h3 인덱스가 나타내는 에지의 정확한 길이를 미터 단위로 반환합니다. 구문

h3ExactEdgeLengthM(index)

매개변수

index — 육각형 인덱스 번호. UInt64.

반환 값

미터 단위의 정확한 에지의 길이. Float64.

예시

Query

SELECT round(h3ExactEdgeLengthM(1310277011704381439), 6) AS exactEdgeLengthM;

Response

┌─exactEdgeLengthM─┐
│    195449.631634 │
└──────────────────┘

h3ExactEdgeLengthKm

입력된 h3 인덱스가 나타내는 에지의 정확한 길이를 킬로미터 단위로 반환합니다. 구문

h3ExactEdgeLengthKm(index)

매개변수

index — 육각형 인덱스 번호입니다. UInt64.

반환 값

킬로미터 단위의 정확한 에지 길이입니다. Float64.

예시

Query

SELECT round(h3ExactEdgeLengthKm(1310277011704381439), 8) AS exactEdgeLengthKm;

Response

┌─exactEdgeLengthKm─┐
│      195.44963163 │
└───────────────────┘

h3ExactEdgeLengthRads

입력 H3 인덱스로 표현된 에지의 정확한 길이를 라디안 단위로 반환합니다. 구문

h3ExactEdgeLengthRads(index)

매개변수

index — 육각형 인덱스 번호입니다. UInt64.

반환 값

라디안 단위의 정확한 에지 길이입니다. Float64.

예시

Query

SELECT round(h3ExactEdgeLengthRads(1310277011704381439), 12) AS exactEdgeLengthRads;

Response

┌─exactEdgeLengthRads─┐
│      0.030677980119 │
└─────────────────────┘

h3NumHexagons

지정된 해상도에서 고유한 H3 인덱스 개수를 반환합니다. 구문

h3NumHexagons(resolution)

매개변수

resolution — 인덱스 해상도. 범위: [0, 15]. UInt8.

반환 값

H3 인덱스 개수. Int64.

예시

Query

SELECT h3NumHexagons(3) AS numHexagons;

Response

┌─numHexagons─┐
│       41162 │
└─────────────┘

h3PointDistM

GeoCoord 점(위도/경도) 쌍 간의 “great circle” 또는 “haversine” 거리를 미터 단위로 반환합니다. 구문

h3PointDistM(lat1, lon1, lat2, lon2)

인수

lat1, lon1 — 점의 위도와 경도(도 단위)입니다. Float64.
lat2, lon2 — point2의 위도와 경도(도 단위)입니다. Float64.

반환 값

미터 단위의 haversine 또는 great circle 거리입니다.Float64.

예시

Query

SELECT h3PointDistM(-10.0 ,0.0, 10.0, 0.0) AS h3PointDistM;

Response

┌───────h3PointDistM─┐
│ 2223901.0395045886 │
└────────────────────┘

h3PointDistKm

GeoCoord 점(위도/경도) 쌍 사이의 “great circle” 또는 “haversine” 거리를 킬로미터 단위로 반환합니다. 구문

h3PointDistKm(lat1, lon1, lat2, lon2)

인수

lat1, lon1 — 점 1의 위도와 경도(도 단위)입니다. Float64.
lat2, lon2 — 지점 2의 위도와 경도(도 단위)입니다. Float64.

반환 값

킬로미터 단위의 haversine 또는 great circle 거리입니다. Float64.

예시

Query

SELECT h3PointDistKm(-10.0 ,0.0, 10.0, 0.0) AS h3PointDistKm;

Response

┌──────h3PointDistKm─┐
│ 2223.9010395045884 │
└────────────────────┘

h3PointDistRads

GeoCoord 점(위도/경도) 쌍 사이의 “great circle” 또는 “haversine” 거리를 라디안으로 반환합니다. 구문

h3PointDistRads(lat1, lon1, lat2, lon2)

인수

lat1, lon1 — 점 1의 위도와 경도(도 단위)입니다. Float64.
lat2, lon2 — 점 2의 위도와 경도(도 단위)입니다. Float64.

반환 값

라디안 단위의 haversine 또는 great circle 거리입니다. Float64.

예시

Query

SELECT h3PointDistRads(-10.0 ,0.0, 10.0, 0.0) AS h3PointDistRads;

Response

┌────h3PointDistRads─┐
│ 0.3490658503988659 │
└────────────────────┘

h3GetRes0Indexes

해상도 0의 모든 H3 인덱스로 이루어진 배열을 반환합니다. 구문

h3GetRes0Indexes()

반환 값

해상도 0의 모든 H3 인덱스로 구성된 배열(UInt64).

예시

Query

SELECT h3GetRes0Indexes AS indexes ;

Response

┌─indexes─────────────────────────────────────┐
│ [576495936675512319,576531121047601151,....]│
└─────────────────────────────────────────────┘

h3GetPentagonIndexes

지정된 해상도의 모든 오각형 H3 인덱스를 반환합니다. 구문

h3GetPentagonIndexes(resolution)

매개변수

resolution — 인덱스 해상도. 범위: [0, 15]. UInt8.

반환 값

모든 오각형 H3 인덱스의 배열(UInt64).

예시

Query

SELECT h3GetPentagonIndexes(3) AS indexes;

Response

┌─indexes────────────────────────────────────────────────────────┐
│ [590112357393367039,590464201114255359,590816044835143679,...] │
└────────────────────────────────────────────────────────────────┘

h3Line

주어진 두 인덱스 사이를 잇는 인덱스 선을 반환합니다. 구문

h3Line(start,end)

매개변수

start — 시작 지점을 나타내는 육각형 인덱스 번호입니다. UInt64.
end — 끝 지점을 나타내는 육각형 인덱스 번호입니다. UInt64.

반환 값 지정된 두 인덱스를 잇는 인덱스 선을 나타내는 H3 인덱스의 배열입니다. 배열(UInt64). 예시

Query

 SELECT h3Line(590080540275638271,590103561300344831) AS indexes;

Response

┌─indexes────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [590080540275638271,590080471556161535,590080883873021951,590106516237844479,590104385934065663,590103630019821567,590103561300344831] │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

h3Distance

주어진 두 인덱스 사이의 거리를 그리드 셀 단위로 반환합니다. 구문

h3Distance(start,end)

매개변수

start — 시작 지점을 나타내는 육각형 인덱스 번호입니다. UInt64.
end — 끝 지점을 나타내는 육각형 인덱스 번호입니다. UInt64.

반환 값

격자 셀 수입니다. Int64.

거리를 계산하지 못하면 음수를 반환합니다. 예시

Query

 SELECT h3Distance(590080540275638271,590103561300344831) AS distance;

Response

┌─distance─┐
│        6 │
└──────────┘

h3HexRing

지정된 origin h3Index를 중심으로 길이 k인 육각형 링의 인덱스를 반환합니다. 오각형 왜곡이 없으면 0을 반환합니다. 구문

h3HexRing(index, k)

매개변수

index — 시작점을 나타내는 육각형 인덱스 번호입니다. UInt64.
k — 거리입니다. UInt64.

반환 값

H3 인덱스 배열입니다. 배열(UInt64).

예시

Query

 SELECT h3HexRing(590080540275638271, toUInt16(1)) AS hexRing;

Response

┌─hexRing─────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [590080815153545215,590080471556161535,590080677714591743,590077585338138623,590077447899185151,590079509483487231] │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

h3GetUnidirectionalEdge

인접한 두 H3 셀 인덱스(원점 및 대상)에 대한 에지 H3 인덱스를 반환합니다. 입력 중 하나라도 유효한 H3 셀이 아니면 예외가 발생합니다(functions_h3_default_if_invalid 설정으로 제어됨). 유효하지만 서로 이웃하지 않는 셀(같은 셀이 두 번 지정된 경우 포함)의 경우 0을 반환합니다. 구문

h3GetUnidirectionalEdge(originIndex, destinationIndex)

매개변수

originIndex — 원점 육각형의 인덱스 번호. UInt64.
destinationIndex — 대상 육각형의 인덱스 번호. UInt64.

반환 값

에지의 육각형 인덱스 번호. UInt64.

예시

Query

 SELECT h3GetUnidirectionalEdge(599686042433355775, 599686043507097599) AS edge;

Response

┌────────────────edge─┐
│ 1248204388774707199 │
└─────────────────────┘

h3UnidirectionalEdgeIsValid

주어진 H3Index가 유효한 에지 인덱스인지 판별합니다. 에지이면 1을 반환하고, 아니면 0을 반환합니다. 구문

h3UnidirectionalEdgeIsValid(index)

매개변수

index — 육각형 인덱스 번호입니다. UInt64.

반환 값

1 — H3 인덱스가 유효한 에지입니다. UInt8.
0 — H3 인덱스가 유효한 에지가 아닙니다. UInt8.

예시

Query

 SELECT h3UnidirectionalEdgeIsValid(1248204388774707199) AS validOrNot;

Response

┌─validOrNot─┐
│          1 │
└────────────┘

h3GetOriginIndexFromUnidirectionalEdge

에지 H3Index에서 원점 육각형 인덱스를 반환합니다. 입력이 유효한 방향성 에지가 아니면 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 해당 설정이 활성화된 경우에만 0을 반환합니다. 구문

h3GetOriginIndexFromUnidirectionalEdge(edge)

매개변수

edge — 에지를 나타내는 육각형 인덱스 번호입니다. UInt64.

반환 값

원점 육각형 인덱스 번호입니다. UInt64.
기본적으로 유효하지 않은 방향성 에지에 대해 INCORRECT_DATA를 발생시키며, functions_h3_default_if_invalid = 1이면 0을 반환합니다.

예시

Query

 SELECT h3GetOriginIndexFromUnidirectionalEdge(1248204388774707199) AS origin;

Response

┌─────────────origin─┐
│ 599686042433355775 │
└────────────────────┘

h3GetDestinationIndexFromUnidirectionalEdge

에지 H3Index로부터 대상 육각형 인덱스를 반환합니다. 입력이 유효한 방향성 에지가 아니면 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 해당 설정이 활성화된 경우에만 0을 반환합니다. 구문

h3GetDestinationIndexFromUnidirectionalEdge(edge)

매개변수

edge — 에지를 나타내는 육각형 인덱스 번호입니다. UInt64.

반환 값

대상 육각형의 인덱스 번호입니다. UInt64.
기본적으로 유효하지 않은 방향성 에지에 대해 INCORRECT_DATA를 발생시키며, functions_h3_default_if_invalid = 1이면 0을 반환합니다.

예시

Query

 SELECT h3GetDestinationIndexFromUnidirectionalEdge(1248204388774707199) AS destination;

Response

┌────────destination─┐
│ 599686043507097599 │
└────────────────────┘

h3GetIndexesFromUnidirectionalEdge

주어진 에지 H3Index로부터 원점 및 대상 육각형 인덱스를 반환합니다. 구문

h3GetIndexesFromUnidirectionalEdge(edge)

매개변수

edge — 에지를 나타내는 육각형 인덱스 번호입니다. UInt64.

반환 값 두 개의 값으로 구성된 튜플 tuple(origin,destination)입니다.

origin — 원점 육각형 인덱스 번호입니다. UInt64.
destination — 대상 육각형 인덱스 번호입니다. UInt64.

제공된 입력이 유효한 방향성 에지가 아니면 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 해당 설정이 활성화된 경우에만 (0,0)을 반환합니다. 예시

Query

 SELECT h3GetIndexesFromUnidirectionalEdge(1248204388774707199) AS indexes;

Response

┌─indexes─────────────────────────────────┐
│ (599686042433355775,599686043507097599) │
└─────────────────────────────────────────┘

h3GetUnidirectionalEdgesFromHexagon

지정된 H3Index의 모든 에지를 반환합니다. 입력이 유효한 H3 셀이 아닌 경우 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 이 설정이 활성화된 경우에만 빈 배열을 반환합니다. 구문

h3GetUnidirectionalEdgesFromHexagon(index)

매개변수

index — 셀을 나타내는 육각형 인덱스 번호입니다. UInt64.

반환 값

각 에지를 나타내는 H3 인덱스의 배열입니다. 배열(UInt64).
기본적으로 잘못된 셀에 대해 INCORRECT_DATA를 발생시키며, functions_h3_default_if_invalid = 1이면 []를 반환합니다.

예시

Query

 SELECT h3GetUnidirectionalEdgesFromHexagon(599686042433355775) AS edges;

Response

┌─edges─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [1248204388774707199,1320261982812635135,1392319576850563071,1464377170888491007,1536434764926418943,1608492358964346879] │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

h3GetUnidirectionalEdgeBoundary

에지를 구성하는 좌표를 반환합니다. 입력이 유효한 방향성 에지가 아니면 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 해당 설정이 활성화된 경우에만 빈 배열을 반환합니다. 구문

h3GetUnidirectionalEdgeBoundary(index)

매개변수

index — 에지를 나타내는 육각형 인덱스 번호입니다. UInt64.

반환 값

‘(lat, lon)’ 쌍으로 이루어진 배열입니다. 배열(Float64, Float64).
기본적으로 잘못된 방향성 에지에서는 INCORRECT_DATA를 발생시키며, functions_h3_default_if_invalid = 1인 경우 []를 반환합니다.

예시

Query

 SELECT h3GetUnidirectionalEdgeBoundary(1248204388774707199) AS boundary;

Response

┌─boundary────────────────────────────────────────────────────────────────────────┐
│ [(37.42012867767779,-122.03773496427027),(37.33755608435299,-122.090428929044)] │
└─────────────────────────────────────────────────────────────────────────────────┘

​H3 인덱스

​h3IsValid

​h3GetResolution

​h3EdgeAngle

​h3EdgeLengthM

​h3EdgeLengthKm

​geoToH3

​h3ToGeo

​h3ToGeoBoundary

​h3kRing

​h3PolygonToCells

​h3PolygonToCellsWithContainment

​h3GetBaseCell

​h3HexAreaM2

​h3HexAreaKm2

​h3IndexesAreNeighbors

​h3ToChildren

​h3ToParent

​h3ToString

​stringToH3

​h3GetResolution

​h3IsResClassIII

​h3IsPentagon

​h3GetFaces

​h3CellAreaM2

​h3CellAreaRads2

​h3ToCenterChild

​h3ExactEdgeLengthM

​h3ExactEdgeLengthKm

​h3ExactEdgeLengthRads

​h3NumHexagons

​h3PointDistM

​h3PointDistKm

​h3PointDistRads

​h3GetRes0Indexes

​h3GetPentagonIndexes

​h3Line

​h3Distance

​h3HexRing

​h3GetUnidirectionalEdge

​h3UnidirectionalEdgeIsValid

​h3GetOriginIndexFromUnidirectionalEdge

​h3GetDestinationIndexFromUnidirectionalEdge

​h3GetIndexesFromUnidirectionalEdge

​h3GetUnidirectionalEdgesFromHexagon

​h3GetUnidirectionalEdgeBoundary

H3 인덱스

h3IsValid

h3GetResolution

h3EdgeAngle

h3EdgeLengthM

h3EdgeLengthKm

geoToH3

h3ToGeo

h3ToGeoBoundary

h3kRing

h3PolygonToCells

h3PolygonToCellsWithContainment

h3GetBaseCell

h3HexAreaM2

h3HexAreaKm2

h3IndexesAreNeighbors

h3ToChildren

h3ToParent

h3ToString

stringToH3

h3GetResolution

h3IsResClassIII

h3IsPentagon

h3GetFaces

h3CellAreaM2

h3CellAreaRads2

h3ToCenterChild

h3ExactEdgeLengthM

h3ExactEdgeLengthKm

h3ExactEdgeLengthRads

h3NumHexagons

h3PointDistM

h3PointDistKm

h3PointDistRads

h3GetRes0Indexes

h3GetPentagonIndexes

h3Line

h3Distance

h3HexRing

h3GetUnidirectionalEdge

h3UnidirectionalEdgeIsValid

h3GetOriginIndexFromUnidirectionalEdge

h3GetDestinationIndexFromUnidirectionalEdge

h3GetIndexesFromUnidirectionalEdge

h3GetUnidirectionalEdgesFromHexagon

h3GetUnidirectionalEdgeBoundary