Condividi tramite

Funzione h3_pointash3

  • Articolo

Restituisce l'ID cella H3 (come BIGINT) corrispondente al punto fornito alla risoluzione specificata.

Si applica a: segno di spunta sì Databricks SQL preview segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

Sintassi

h3_pointash3 ( geographyExpr, resolutionExpr )

Argomenti

  • geographyExpr: espressione BINARY o STRING che rappresenta un'area geografica dei punti in WKB, WKT o GeoJSON. La geografia dovrebbe avere coordinate di longitudine e latitudine in gradi che fanno riferimento al sistema di riferimento delle coordinate WGS84 .
  • resolutionExpr: espressione INT, il cui valore deve essere compreso tra 0 e 15 inclusivo, specificando la risoluzione per l'ID cella H3.

Valori restituiti

Restituisce l'ID cella H3 (come BIGINT) corrispondente al punto fornito alla risoluzione specificata.

La funzione restituisce NULL se una delle espressioni di input è NULL. Se il primo argomento di input è di tipo BINARY, si prevede che il valore di input sia la descrizione WKB di un punto. Se il primo argomento di input è di tipo STRING, il valore di input deve essere WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) o la descrizione GeoJSON di un punto. La dimensione del punto di input può essere 2D, 3DZ, 3DM o 4D. I valori di longitudine e latitudine nella descrizione WKB, WKT o GeoJSON devono trovarsi nel sistema di riferimento delle coordinate WGS84. La funzione restituisce NULL se il primo input corrisponde al punto vuoto.

Condizioni di errore

  • Se geographyExpr è di tipo BINARY e il valore è un WKB non valido o non rappresenta un punto, la funzione restituisce WKB_PARSE_ERROR.
  • Se geographyExpr è di tipo STRING e il valore è un WKT non valido o non rappresenta un punto, la funzione restituisce WKT_PARSE_ERROR.
  • Se geographyExpr è di tipo STRING e il valore è un geoJSON non valido o non rappresenta un punto, la funzione restituisce GEOJSON_PARSE_ERROR.
  • Se resolutionExpr è minore o maggiore di 0 15, la funzione restituisce H3_INVALID_RESOLUTION_VALUE.

Esempi

-- 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