Delen via

h3_pointash3string-functie

  • Artikel

Retourneert de H3-cel-id (als een TEKENREEKS) die overeenkomt met het opgegeven punt op de opgegeven resolutie.

Van toepassing op:vinkje als ja aan Databricks SQL Preview vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

Syntaxis

h3_pointash3string ( geographyExpr, resolutionExpr )

Argumenten

  • geographyExpr: een BINAIRE of TEKENREEKSexpressie die een puntgeografie vertegenwoordigt in WKB, WKT of GeoJSON. De geografie heeft naar verwachting lengte- en breedtegraadcoördinaten in graden die verwijzen naar het WGS84-coördinaatreferentiesysteem .
  • resolutionExpr: Een INT-expressie, waarvan de waarde naar verwachting tussen 0 en 15 inclusief is, waarbij de resolutie voor de H3-cel-id wordt opgegeven.

Retouren

Retourneert de H3-cel-id (als een TEKENREEKS) die overeenkomt met het opgegeven punt op de opgegeven resolutie.

De functie retourneert NULL als een van de invoerexpressies NULL is. Als het eerste invoerargument van het type BINARY is, wordt verwacht dat de invoerwaarde de WKB-beschrijving van een punt is. Als het eerste invoerargument van het type STRING is, wordt verwacht dat de invoerwaarde de WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) of de GeoJSON-beschrijving van een punt is. De dimensie van het invoerpunt kan 2D, 3DZ, 3DM of 4D zijn. De lengte- en breedtegraad values in de WKB-, WKT-of GeoJSON beschrijving worden naar verwachting opgenomen in het WGS84-coördinaatreferentiesysteem. De functie retourneert NULL als de eerste invoer overeenkomt met het lege punt.

Foutvoorwaarden

Voorbeelden

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