Set up docs MCPH3 인덱스
H3는 지구 표면을 균일한 육각형 셀의 격자로 나누는 지리 공간 인덱싱 시스템입니다. 이 시스템은 계층 구조를 가지며, 즉 최상위 수준의 각 육각형("parent")은 크기가 더 작은 균일한 7개의 육각형("children")으로 분할될 수 있고, 이러한 방식이 계속 반복됩니다.
이 계층 구조의 수준을 resolution이라고 하며, 값은 0부터 15까지입니다. 이때 0은 가장 크고 가장 거친 셀을 갖는 base 수준입니다.
위도와 경도의 쌍은 격자 셀을 식별하는 64비트 H3 인덱스로 변환할 수 있습니다.
H3 인덱스는 주로 위치를 버킷으로 그룹화하거나 그 밖의 지리 공간 작업을 수행하는 데 사용됩니다.
H3 시스템에 대한 전체 설명은 Uber Engineering 사이트에서 확인할 수 있습니다.
h3IsValid
숫자가 유효한 H3 인덱스인지 확인합니다.
구문
h3IsValid(h3index)매개변수
h3index— 육각형 인덱스 번호입니다. UInt64.
반환 값
예시
SELECT h3IsValid(630814730351855103) AS h3IsValid;┌─h3IsValid─┐
│ 1 │
└───────────┘h3GetResolution
지정된 H3 인덱스의 해상도를 반환합니다.
구문
h3GetResolution(h3index)매개변수
h3index— 육각형 인덱스 번호. UInt64.
반환 값
예시
SELECT h3GetResolution(639821929606596015) AS resolution;┌─resolution─┐
│ 14 │
└────────────┘h3EdgeAngle
H3 육각형 변의 평균 길이를 그라드 단위로 계산합니다.
구문
h3EdgeAngle(resolution)매개변수
resolution— 인덱스 해상도. UInt8. 범위:[0, 15].
반환 값
예시
SELECT h3EdgeAngle(10) AS edgeAngle;┌───────h3EdgeAngle(10)─┐
│ 0.0005927224846720883 │
└───────────────────────┘h3EdgeLengthM
H3 육각형의 변 길이 평균을 미터 단위로 계산합니다.
구문
h3EdgeLengthM(resolution)매개변수
resolution— 인덱스 해상도입니다. UInt8. 범위:[0, 15].
반환 값
예시
SELECT h3EdgeLengthM(15) AS edgeLengthM;┌─edgeLengthM─┐
│ 0.509713273 │
└─────────────┘h3EdgeLengthKm
H3 육각형의 변 길이 평균을 킬로미터 단위로 계산합니다.
구문
h3EdgeLengthKm(resolution)매개변수
resolution— 인덱스 해상도. UInt8. 범위:[0, 15].
반환 값
예시
SELECT h3EdgeLengthKm(15) AS edgeLengthKm;┌─edgeLengthKm─┐
│ 0.000509713 │
└──────────────┘geoToH3
지정된 해상도의 H3 점 인덱스 (lat, lon)를 반환합니다.
구문
geoToH3(lat, lon, resolution)인수
반환 값
참고: ClickHouse v25.4 이하에서는 geoToH3()가 값을 (lon, lat) 순서로 받습니다. ClickHouse v25.5부터는 입력 값의 순서가 (lat, lon)입니다. 이전 동작은 geotoh3_argument_order = 'lon_lat' 설정으로 복원할 수 있습니다.
예시
SELECT geoToH3(55.71290588, 37.79506683, 15) AS h3Index;┌────────────h3Index─┐
│ 644325524701193974 │
└────────────────────┘h3ToGeo
주어진 H3 인덱스에 해당하는 중심점의 위도와 경도를 반환합니다.
구문
h3ToGeo(h3Index)인수
h3Index— H3 인덱스. UInt64.
반환 값
참고: ClickHouse v24.12 이하에서는 h3ToGeo()가 (lon, lat) 순서로 값을 반환합니다. ClickHouse v25.1부터는 반환 값이 (lat, lon) 순서입니다. 이전 동작은 설정 h3togeo_lon_lat_result_order = true를 사용해 복원할 수 있습니다.
예시
SELECT h3ToGeo(644325524701193974) AS coordinates;┌─coordinates───────────────────────────┐
│ (55.71290243145668,37.79506616830252) │
└───────────────────────────────────────┘h3ToGeoBoundary
주어진 H3 인덱스의 경계에 해당하는 (lat, lon) 쌍의 배열을 반환합니다.
구문
h3ToGeoBoundary(h3Index)인수
h3Index— H3 인덱스. UInt64.
반환 값
예시
SELECT h3ToGeoBoundary(644325524701193974) AS coordinates;┌─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)인수
반환 값
예시
SELECT arrayJoin(h3kRing(644325529233966508, 1)) AS h3index;┌────────────h3index─┐
│ 644325529233966508 │
│ 644325529233966497 │
│ 644325529233966510 │
│ 644325529233966504 │
│ 644325529233966509 │
│ 644325529233966355 │
│ 644325529233966354 │
└────────────────────┘h3PolygonToCells
제공된 Geometry(링 또는 (multi-)polygon)에 포함된 지정된 해상도의 육각형을 반환합니다.
구문
h3PolygonToCells(geometry, resolution)인수
geometry는 다음 Geo 데이터 타입 또는 그 기반이 되는 기본 타입 중 하나일 수 있습니다:resolution— 인덱스 해상도입니다. 범위:[0, 15]. UInt8.
반환 값
예시
SELECT h3PolygonToCells([(-122.4089866999972145,37.813318999983238),(-122.3544736999993603,37.7198061999978478),(-122.4798767000009008,37.8151571999998453)], 7) AS h3index;┌────────────h3index─┐
│ 608692970769612799 │
│ 608692971927240703 │
│ 608692970585063423 │
│ 608692970819944447 │
│ 608692970719281151 │
│ 608692970752835583 │
│ 608692972027903999 │
└────────────────────┘h3PolygonToCellsWithContainment
H3 Experimental 포함 모드를 사용하여 제공된 geometry가 차지하는 영역을 지정된 해상도의 육각형으로 덮어 반환합니다. geometry는 링 또는 (multi-)polygon일 수 있습니다.
이 함수는 flags를 다음 H3 포함 모드에 매핑합니다:
0—CONTAINMENT_CENTER1—CONTAINMENT_FULL2—CONTAINMENT_OVERLAPPING3—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로 전달됩니다. 다른 네이티브 정수 타입에는 정확한 형변환이 적용됩니다.
반환 값
예시
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; ┌─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.
예시
SELECT h3GetBaseCell(612916788725809151) AS basecell;┌─basecell─┐
│ 12 │
└──────────┘h3HexAreaM2
주어진 해상도에서 육각형의 평균 면적을 제곱미터(m²) 단위로 반환합니다.
구문
h3HexAreaM2(resolution)매개변수
resolution— 인덱스 해상도. 범위:[0, 15]. UInt8.
반환 값
- 제곱미터 단위의 면적. Float64.
예시
SELECT h3HexAreaM2(13) AS area;┌─area─┐
│ 43.9 │
└──────┘h3HexAreaKm2
주어진 해상도에서 평균 육각형 면적을 제곱킬로미터 단위로 반환합니다.
구문
h3HexAreaKm2(resolution)매개변수
resolution— 인덱스 해상도입니다. 범위:[0, 15]. UInt8.
반환 값
- 제곱킬로미터 단위의 면적입니다. Float64.
예시
SELECT h3HexAreaKm2(13) AS area;┌──────area─┐
│ 0.0000439 │
└───────────┘h3IndexesAreNeighbors
주어진 H3 인덱스가 서로 인접해 있는지 반환합니다.
구문
h3IndexesAreNeighbors(index1, index2)인수
반환 값
예시
SELECT h3IndexesAreNeighbors(617420388351344639, 617420388352655359) AS n;┌─n─┐
│ 1 │
└───┘h3ToChildren
주어진 H3 인덱스의 자식 인덱스 배열을 반환합니다.
구문
h3ToChildren(index, resolution)인수
반환 값
예시
SELECT h3ToChildren(599405990164561919, 6) AS children;┌─children───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [603909588852408319,603909588986626047,603909589120843775,603909589255061503,603909589389279231,603909589523496959,603909589657714687] │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘h3ToParent
지정된 H3 인덱스를 포함하는 상위(더 낮은 해상도의) 인덱스를 반환합니다.
구문
h3ToParent(index, resolution)인수
반환 값
- 상위 H3 인덱스. UInt64.
예시
SELECT h3ToParent(599405990164561919, 3) AS parent;┌─────────────parent─┐
│ 590398848891879423 │
└────────────────────┘h3ToString
인덱스의 H3Index 표현을 문자열 형식으로 변환합니다.
h3ToString(index)매개변수
index— 육각형 인덱스 번호입니다. UInt64.
반환 값
- H3 인덱스의 문자열 형식입니다. String.
예시
SELECT h3ToString(617420388352917503) AS h3_string;┌─h3_string───────┐
│ 89184926cdbffff │
└─────────────────┘stringToH3
문자열 형식을 H3Index(UInt64) 형식으로 변환합니다.
구문
stringToH3(index_str)매개변수
index_str— H3 인덱스의 문자열 형식입니다. String.
반환 값
- 육각형 인덱스 번호입니다. 오류가 발생하면 0을 반환합니다. UInt64.
예시
SELECT stringToH3('89184926cc3ffff') AS index;┌──────────────index─┐
│ 617420388351344639 │
└────────────────────┘h3GetResolution
H3 인덱스의 해상도를 반환합니다.
구문
h3GetResolution(index)매개변수
index— 육각형 인덱스 번호. UInt64.
반환 값
- 인덱스의 해상도. 범위:
[0, 15]. UInt8.
예시
SELECT h3GetResolution(617420388352917503) AS res;┌─res─┐
│ 9 │
└─────┘h3IsResClassIII
H3 인덱스가 Class III 방향 해상도인지 여부를 반환합니다.
구문
h3IsResClassIII(index)매개변수
index— 육각형 인덱스 번호. UInt64.
반환 값
예시
SELECT h3IsResClassIII(617420388352917503) AS res;┌─res─┐
│ 1 │
└─────┘h3IsPentagon
이 H3 인덱스가 오각형 셀을 나타내는지 반환합니다.
구문
h3IsPentagon(index)매개변수
index— 육각형 인덱스 번호. UInt64.
반환 값
예시
SELECT h3IsPentagon(644721767722457330) AS pentagon;┌─pentagon─┐
│ 0 │
└──────────┘h3GetFaces
지정된 H3 인덱스가 교차하는 정이십면체의 면을 반환합니다.
구문
h3GetFaces(index)매개변수
index— 육각형 인덱스 번호. UInt64.
반환 값
예시
SELECT h3GetFaces(599686042433355775) AS faces;┌─faces─┐
│ [7] │
└───────┘h3CellAreaM2
주어진 H3 인덱스에 해당하는 특정 셀의 정확한 면적을 제곱미터 단위로 반환합니다.
구문
h3CellAreaM2(index)매개변수
index— 육각형 인덱스 번호. UInt64.
반환 값
- 제곱미터 단위의 셀의 면적. Float64.
예시
SELECT h3CellAreaM2(579205133326352383) AS area;┌───────────────area─┐
│ 4106166334463.9233 │
└────────────────────┘h3CellAreaRads2
주어진 H3 인덱스에 해당하는 특정 셀의 정확한 면적을 제곱 라디안 단위로 반환합니다.
구문
h3CellAreaRads2(index)매개변수
index— 육각형 인덱스 번호. UInt64.
반환 값
- 제곱 라디안 단위의 셀 면적입니다. Float64.
예시
SELECT h3CellAreaRads2(579205133326352383) AS area;┌────────────────area─┐
│ 0.10116268528089567 │
└─────────────────────┘h3ToCenterChild
주어진 H3에서 지정된 해상도의 중심 자식(더 세분화된) H3 인덱스를 반환합니다.
구문
h3ToCenterChild(index, resolution)매개변수
반환 값
예시
SELECT h3ToCenterChild(577023702256844799,1) AS centerToChild;┌──────centerToChild─┐
│ 581496515558637567 │
└────────────────────┘h3ExactEdgeLengthM
입력된 h3 인덱스가 나타내는 에지의 정확한 길이를 미터 단위로 반환합니다.
구문
h3ExactEdgeLengthM(index)매개변수
index— 육각형 인덱스 번호. UInt64.
반환 값
- 미터 단위의 정확한 에지의 길이. Float64.
예시
SELECT round(h3ExactEdgeLengthM(1310277011704381439), 6) AS exactEdgeLengthM;┌─exactEdgeLengthM─┐
│ 195449.631634 │
└──────────────────┘h3ExactEdgeLengthKm
입력된 h3 인덱스가 나타내는 에지의 정확한 길이를 킬로미터 단위로 반환합니다.
구문
h3ExactEdgeLengthKm(index)매개변수
index— 육각형 인덱스 번호입니다. UInt64.
반환 값
- 킬로미터 단위의 정확한 에지 길이입니다. Float64.
예시
SELECT round(h3ExactEdgeLengthKm(1310277011704381439), 8) AS exactEdgeLengthKm;┌─exactEdgeLengthKm─┐
│ 195.44963163 │
└───────────────────┘h3ExactEdgeLengthRads
입력 H3 인덱스로 표현된 에지의 정확한 길이를 라디안 단위로 반환합니다.
구문
h3ExactEdgeLengthRads(index)매개변수
index— 육각형 인덱스 번호입니다. UInt64.
반환 값
- 라디안 단위의 정확한 에지 길이입니다. Float64.
예시
SELECT round(h3ExactEdgeLengthRads(1310277011704381439), 12) AS exactEdgeLengthRads;┌─exactEdgeLengthRads─┐
│ 0.030677980119 │
└─────────────────────┘h3NumHexagons
지정된 해상도에서 고유한 H3 인덱스 개수를 반환합니다.
구문
h3NumHexagons(resolution)매개변수
resolution— 인덱스 해상도. 범위:[0, 15]. UInt8.
반환 값
- H3 인덱스 개수. Int64.
예시
SELECT h3NumHexagons(3) AS numHexagons;┌─numHexagons─┐
│ 41162 │
└─────────────┘h3PointDistM
GeoCoord 점(위도/경도) 쌍 간의 "great circle" 또는 "haversine" 거리를 미터 단위로 반환합니다.
구문
h3PointDistM(lat1, lon1, lat2, lon2)인수
반환 값
- 미터 단위의 haversine 또는 great circle 거리입니다.Float64.
예시
SELECT h3PointDistM(-10.0 ,0.0, 10.0, 0.0) AS h3PointDistM;┌───────h3PointDistM─┐
│ 2223901.0395045886 │
└────────────────────┘h3PointDistKm
GeoCoord 점(위도/경도) 쌍 사이의 "great circle" 또는 "haversine" 거리를 킬로미터 단위로 반환합니다.
구문
h3PointDistKm(lat1, lon1, lat2, lon2)인수
반환 값
- 킬로미터 단위의 haversine 또는 great circle 거리입니다. Float64.
예시
SELECT h3PointDistKm(-10.0 ,0.0, 10.0, 0.0) AS h3PointDistKm;┌──────h3PointDistKm─┐
│ 2223.9010395045884 │
└────────────────────┘h3PointDistRads
GeoCoord 점(위도/경도) 쌍 사이의 "great circle" 또는 "haversine" 거리를 라디안으로 반환합니다.
구문
h3PointDistRads(lat1, lon1, lat2, lon2)인수
반환 값
- 라디안 단위의 haversine 또는 great circle 거리입니다. Float64.
예시
SELECT h3PointDistRads(-10.0 ,0.0, 10.0, 0.0) AS h3PointDistRads;┌────h3PointDistRads─┐
│ 0.3490658503988659 │
└────────────────────┘h3GetRes0Indexes
해상도 0의 모든 H3 인덱스로 이루어진 배열을 반환합니다.
구문
h3GetRes0Indexes()반환 값
예시
SELECT h3GetRes0Indexes AS indexes ;┌─indexes─────────────────────────────────────┐
│ [576495936675512319,576531121047601151,....]│
└─────────────────────────────────────────────┘h3GetPentagonIndexes
지정된 해상도의 모든 오각형 H3 인덱스를 반환합니다.
구문
h3GetPentagonIndexes(resolution)매개변수
resolution— 인덱스 해상도. 범위:[0, 15]. UInt8.
반환 값
예시
SELECT h3GetPentagonIndexes(3) AS indexes;┌─indexes────────────────────────────────────────────────────────┐
│ [590112357393367039,590464201114255359,590816044835143679,...] │
└────────────────────────────────────────────────────────────────┘h3Line
주어진 두 인덱스 사이를 잇는 인덱스 선을 반환합니다.
구문
h3Line(start,end)매개변수
반환 값
지정된 두 인덱스를 잇는 인덱스 선을 나타내는 H3 인덱스의 배열입니다. 배열(UInt64).
예시
SELECT h3Line(590080540275638271,590103561300344831) AS indexes;┌─indexes────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [590080540275638271,590080471556161535,590080883873021951,590106516237844479,590104385934065663,590103630019821567,590103561300344831] │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘h3Distance
주어진 두 인덱스 사이의 거리를 그리드 셀 단위로 반환합니다.
구문
h3Distance(start,end)매개변수
반환 값
- 격자 셀 수입니다. Int64.
거리를 계산하지 못하면 음수를 반환합니다.
예시
SELECT h3Distance(590080540275638271,590103561300344831) AS distance;┌─distance─┐
│ 6 │
└──────────┘h3HexRing
지정된 origin h3Index를 중심으로 길이 k인 육각형 링의 인덱스를 반환합니다.
오각형 왜곡이 없으면 0을 반환합니다.
구문
h3HexRing(index, k)매개변수
반환 값
예시
SELECT h3HexRing(590080540275638271, toUInt16(1)) AS hexRing;┌─hexRing─────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [590080815153545215,590080471556161535,590080677714591743,590077585338138623,590077447899185151,590079509483487231] │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘h3GetUnidirectionalEdge
인접한 두 H3 셀 인덱스(원점 및 대상)에 대한 에지 H3 인덱스를 반환합니다. 입력 중 하나라도 유효한 H3 셀이 아니면 예외가 발생합니다(functions_h3_default_if_invalid 설정으로 제어됨). 유효하지만 서로 이웃하지 않는 셀(같은 셀이 두 번 지정된 경우 포함)의 경우 0을 반환합니다.
구문
h3GetUnidirectionalEdge(originIndex, destinationIndex)매개변수
반환 값
- 에지의 육각형 인덱스 번호. UInt64.
예시
SELECT h3GetUnidirectionalEdge(599686042433355775, 599686043507097599) AS edge;┌────────────────edge─┐
│ 1248204388774707199 │
└─────────────────────┘h3UnidirectionalEdgeIsValid
주어진 H3Index가 유효한 에지 인덱스인지 판별합니다. 에지이면 1을 반환하고, 아니면 0을 반환합니다.
구문
h3UnidirectionalEdgeIsValid(index)매개변수
index— 육각형 인덱스 번호입니다. UInt64.
반환 값
예시
SELECT h3UnidirectionalEdgeIsValid(1248204388774707199) AS validOrNot;┌─validOrNot─┐
│ 1 │
└────────────┘h3GetOriginIndexFromUnidirectionalEdge
에지 H3Index에서 원점 육각형 인덱스를 반환합니다. 입력이 유효한 방향성 에지가 아니면 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 해당 설정이 활성화된 경우에만 0을 반환합니다.
구문
h3GetOriginIndexFromUnidirectionalEdge(edge)매개변수
edge— 에지를 나타내는 육각형 인덱스 번호입니다. UInt64.
반환 값
- 원점 육각형 인덱스 번호입니다. UInt64.
- 기본적으로 유효하지 않은 방향성 에지에 대해
INCORRECT_DATA를 발생시키며,functions_h3_default_if_invalid = 1이면0을 반환합니다.
예시
SELECT h3GetOriginIndexFromUnidirectionalEdge(1248204388774707199) AS origin;┌─────────────origin─┐
│ 599686042433355775 │
└────────────────────┘h3GetDestinationIndexFromUnidirectionalEdge
에지 H3Index로부터 대상 육각형 인덱스를 반환합니다. 입력이 유효한 방향성 에지가 아니면 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 해당 설정이 활성화된 경우에만 0을 반환합니다.
구문
h3GetDestinationIndexFromUnidirectionalEdge(edge)매개변수
edge— 에지를 나타내는 육각형 인덱스 번호입니다. UInt64.
반환 값
- 대상 육각형의 인덱스 번호입니다. UInt64.
- 기본적으로 유효하지 않은 방향성 에지에 대해
INCORRECT_DATA를 발생시키며,functions_h3_default_if_invalid = 1이면0을 반환합니다.
예시
SELECT h3GetDestinationIndexFromUnidirectionalEdge(1248204388774707199) AS destination;┌────────destination─┐
│ 599686043507097599 │
└────────────────────┘h3GetIndexesFromUnidirectionalEdge
주어진 에지 H3Index로부터 원점 및 대상 육각형 인덱스를 반환합니다.
구문
h3GetIndexesFromUnidirectionalEdge(edge)매개변수
edge— 에지를 나타내는 육각형 인덱스 번호입니다. UInt64.
반환 값
두 개의 값으로 구성된 튜플 tuple(origin,destination)입니다.
제공된 입력이 유효한 방향성 에지가 아니면 예외를 발생시킵니다(functions_h3_default_if_invalid 설정으로 제어됨). 해당 설정이 활성화된 경우에만 (0,0)을 반환합니다.
예시
SELECT h3GetIndexesFromUnidirectionalEdge(1248204388774707199) AS indexes;┌─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이면[]를 반환합니다.
예시
SELECT h3GetUnidirectionalEdgesFromHexagon(599686042433355775) AS edges;┌─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인 경우[]를 반환합니다.
예시
SELECT h3GetUnidirectionalEdgeBoundary(1248204388774707199) AS boundary;┌─boundary────────────────────────────────────────────────────────────────────────┐
│ [(37.42012867767779,-122.03773496427027),(37.33755608435299,-122.090428929044)] │
└─────────────────────────────────────────────────────────────────────────────────┘