Delen via


h3_try_polyfillash3string-functie

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

Gedraagt zich hetzelfde als h3_polyfillash3string, behalve dat NULL wordt geretourneerd in plaats van een fout als het eerste argument ongeldig is. Precies gezegd, retourneert een MATRIX van H3-cel-id's (weergegeven als TEKENREEKS) die overeenkomt met zeshoeken of vijfhoeken, van de opgegeven resolutie, die zijn opgenomen in de invoer geografie.

Syntaxis

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

Argumenten

  • geographyExpr: Een BINAIRE of TEKENREEKS-expressie die een areale geografie (veelhoek of multipolygon) 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 ligt, waarbij de resolutie voor de H3-cellen wordt opgegeven.

Retouren

Een MATRIX van TEKENREEKSwaarden die overeenkomen met de H3-cel-id's, van de opgegeven resolutie, die zijn opgenomen in de invoer, zijn geografie.

De functie retourneert NULL als een van de invoerexpressies NULL is. Als het eerste invoerargument van het type BINARY is, is de invoerwaarde naar verwachting de WKB-beschrijving van een veelhoek of een multipolygon. Als het eerste invoerargument van het type STRING is, is de invoerwaarde naar verwachting de WKT of de GeoJSON-beschrijving van een veelhoek of een multipolygon. De dimensie van de invoermagon of multipolygon kan 2D, 3DZ, 3DM of 4D zijn. De functie retourneert NULL als het eerste argument overeenkomt met een ongeldige WKB, WKT of GeoJSON of niet een veelhoek of een multipolygon vertegenwoordigt.

Foutvoorwaarden

Voorbeelden

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2)
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2)
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- The input is invalid.
> SELECT h3_try_polyfillash3string('Not-a-valid-rep', 2)
  null

-- Resolution is out of range.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive