`h3_pointash3` fungsi

Artikel
04/18/2024

Mengembalikan ID sel H3 (sebagai BIGINT) yang sesuai dengan titik yang disediakan pada resolusi yang ditentukan.

Berlaku untuk: centang ditandai ya Pratinjau Databricks SQL Databricks Runtime 11.3 LTS ke atas

Sintaks

h3_pointash3 ( geographyExpr, resolutionExpr )

Argumen

geographyExpr: Ekspresi BINARY atau STRING yang mewakili geografi titik di WKB, WKT, atau GeoJSON. Geografi ini diharapkan memiliki koordinat bujur dan lintang dalam derajat yang mengacu pada sistem referensi koordinat WGS84 .
resolutionExpr: Ekspresi INT, yang nilainya diharapkan antara 0 dan 15 inklusif, menentukan resolusi untuk ID sel H3.

Mengembalikan

Mengembalikan ID sel H3 (sebagai BIGINT) yang sesuai dengan titik yang disediakan pada resolusi yang ditentukan.

Fungsi mengembalikan NULL jika salah satu ekspresi input adalah NULL. Jika argumen input pertama berjenis BINARY, nilai input diharapkan menjadi deskripsi WKB titik. Jika argumen input pertama berjenis STRING, nilai input diharapkan menjadi WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) atau deskripsi GeoJSON dari suatu titik. Dimensi titik input dapat berupa 2D, 3DZ, 3DM, atau 4D. Nilai garis bujur dan lintang dalam deskripsi WKB, WKT, atau GeoJSON diharapkan berada dalam sistem referensi koordinat WGS84. Fungsi mengembalikan NULL jika input pertama sesuai dengan titik kosong.

Kondisi kesalahan

Jika geographyExpr berjenis BINARY dan nilainya adalah WKB yang tidak valid atau tidak mewakili titik, fungsi mengembalikan WKB_PARSE_ERROR.
Jika geographyExpr berjenis STRING dan nilainya adalah WKT yang tidak valid atau tidak mewakili titik, fungsi mengembalikan WKT_PARSE_ERROR.
Jika geographyExpr berjenis STRING dan nilainya adalah GeoJSON yang tidak valid atau tidak mewakili titik, fungsi mengembalikan GEOJSON_PARSE_ERROR.
Jika resolutionExpr lebih kecil dari 0 atau lebih besar dari 15, fungsi mengembalikan H3_INVALID_RESOLUTION_VALUE.

Contoh

-- Simple example.
> SELECT h3_pointash3('POINT(100 45)', 6)
  604116085645508607

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

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

-- Feeding a multipoint in WKT format instead of a point.
> SELECT h3_pointash3('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_pointash3('{"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_pointash3(unhex('0201000000516b9a779c9e5ec0c5feb27bf2e84240'), 2)
  [WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1

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

h3_pointash3 fungsi