Funktionen h3_pointash3string

Returnerar det H3-cell-ID (som en STRÄNG) som motsvarar den angivna punkten vid den angivna upplösningen.

Gäller för: Databricks SQL preview Databricks Runtime 11.3 LTS och senare

Syntax

h3_pointash3string ( geographyExpr, resolutionExpr )

Argument

• geographyExpr: Ett BINÄRt uttryck eller STRING-uttryck som representerar ett punktgeografi i WKB, WKT eller GeoJSON. Geografin förväntas ha longitud- och latitudkoordinater i grader som refererar till WGS84-koordinatreferenssystemet .
• resolutionExpr: Ett INT-uttryck, vars värde förväntas vara mellan 0 och 15 inkluderande, som anger upplösningen för H3-cell-ID:t.

Returer

Returnerar det H3-cell-ID (som en STRÄNG) som motsvarar den angivna punkten vid den angivna upplösningen.

Funktionen returnerar NULL om något av indatauttrycken är NULL. Om det första indataargumentet är av typen BINARY förväntas indatavärdet vara WKB-beskrivningen av en punkt. Om det första indataargumentet är av typen STRING förväntas indatavärdet antingen vara WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) eller GeoJSON-beskrivningen av en punkt. Indatapunktens dimension kan vara 2D, 3DZ, 3DM eller 4D. Longitud- och latitudvärdena i WKB-, WKT- eller GeoJSON-beskrivningen förväntas finnas i WGS84-koordinatreferenssystemet. Funktionen returnerar NULL om den första indatan motsvarar den tomma punkten.

Feltillstånd

• Om geographyExpr är av typen BINÄR och värdet antingen är en ogiltig WKB eller inte representerar en punkt, returnerar funktionen WKB_PARSE_ERROR.
• Om geographyExpr är av typen STRING och värdet antingen är en ogiltig WKT eller inte representerar en punkt, returnerar funktionen WKT_PARSE_ERROR.
• Om geographyExpr är av typen STRING och värdet antingen är en ogiltig GeoJSON eller inte representerar en punkt, returnerar funktionen GEOJSON_PARSE_ERROR.
• Om resolutionExpr är mindre än 0 eller större än 15returnerar funktionen H3_INVALID_RESOLUTION_VALUE.

Exempel

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

Relaterade funktioner

• funktionen h3_longlatash3
• h3_longlatash3string funktion
• funktionen h3_pointash3