다음을 통해 공유

h3_pointash3string 기능

  • 아티클

지정된 해상도에서 제공된 지점에 해당하는 H3 셀 ID(STRING으로)를 반환합니다.

적용 대상: 예(예)로 표시된 확인 Databricks SQL 미리 보기 예(예)로 표시된 확인 Databricks Runtime 11.3 LTS 이상

구문

h3_pointash3string ( geographyExpr, resolutionExpr )

인수

  • geographyExpr: WKB, WKT 또는 GeoJSON으로 지점 지리를 나타내는 BINARY 또는 STRING 식입니다. 지리에는 WGS84 좌표 참조 시스템을 참조하는 경도 및 위도 좌표가 있어야 합니다.
  • resolutionExpr: H3 셀 ID의 해상도를 지정하는 0에서 15 사이의 값이 예상되는 INT 식입니다.

반품

지정된 해상도에서 제공된 지점에 해당하는 H3 셀 ID(STRING으로)를 반환합니다.

함수는 입력 식 중 하나라도 NULL이면 NULL을 반환합니다. 첫 번째 입력 인수가 BINARY 형식인 경우 입력 값은 지점에 대한 WKB 설명이어야 합니다. 첫 번째 입력 인수가 STRING 형식인 경우 입력 값은 지점에 대한 WKT(https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) 또는 GeoJSON 설명이어야 합니다. 입력 지점의 차원은 2D, 3DZ, 3DM 또는 4D일 수 있습니다. WKB, WKT 또는 GeoJSON 설명의 경도 및 위도 값은 WGS84 좌표 참조 시스템에 있어야 합니다. 첫 번째 입력이 빈 지점에 해당하는 경우 함수는 NULL을 반환합니다.

오류 조건

  • geographyExpr이 BINARY 형식이고 값이 잘못된 WKB이거나 지점을 나타내지 않는 경우 함수는 WKB_PARSE_ERROR를 반환합니다.
  • geographyExpr이 STRING 형식이고 값이 잘못된 WKT이거나 지점을 나타내지 않는 경우 함수는 WKT_PARSE_ERROR를 반환합니다.
  • geographyExpr이 STRING 형식이고 값이 잘못된 GeoJSON이거나 지점을 나타내지 않는 경우 함수는 GEOJSON_PARSE_ERROR를 반환합니다.
  • resolutionExpr이 0보다 작거나 15보다 크면 함수는 H3_INVALID_RESOLUTION_VALUE를 반환합니다.

예제

-- Simple example.
> SELECT h3_pointash3string('POINT(100 45)', 6)
  86240610fffffff

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_pointash3string('POINT(-122.4783 37.8199)', 13)
  8d283087022a93f

-- The function returns NULL if the input is the empty point.
> SELECT h3_pointash3string('{"type":"Point","coordinates":[]}', 15)
  null

-- Feeding a multipoint in WKT format instead of a point.
> SELECT h3_pointash3string('MULTIPOINT(100 45)', 6)
  [WKT_PARSE_ERROR] Error parsing WKT: Invalid or unsupported type 'MULTIPOINT' at position 1

-- Feeding an invalid GeoJSON string ("type" value is not correct).
> SELECT h3_pointash3string('{"type":"POINT","coordinates":[]}', 15)
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"POINT"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_pointash3string(unhex('0201000000516b9a779c9e5ec0c5feb27bf2e84240'), 2)
  [WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1

-- Resolution is out of range.
> SELECT h3_pointash3string('POINT(-122.4783 37.8199)', 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive