h3_boundaryaswkt-functie

  • Artikel

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

Retourneert de veelhoekige grens van de invoer H3-cel in WKT-indeling .

Syntaxis

h3_boundaryaswkt ( h3CellIdExpr )

Argumenten

  • h3CellIdExpr: Een BIGINT-expressie of een hexadecimale TEKENREEKS-expressie die een H3-cel-id vertegenwoordigt.

Retouren

Een waarde van het type TEKENREEKS die de veelhoekgrens van de invoer H3-cel in WKT-indeling vertegenwoordigt .

De functie retourneert NULL als de invoerexpressie NULL is. De functie voert gedeeltelijke validatie uit met betrekking tot of het invoerargument een geldige H3-cel-id is. Een noodzakelijke, maar niet voldoende voorwaarde voor een geldige H3-id is dat de waarde tussen 0x08001fffffffffff en 0x08ff3b6db6db6db6. Het gedrag van de functie is niet gedefinieerd als de invoercel-id geen geldige cel-id is.

Foutvoorwaarden

  • Als h3CellIdExpr dit een TEKENREEKS is die niet kan worden geconverteerd naar een BIGINT of overeenkomt met een BIGINT-waarde die kleiner is dan 0x08001fffffffffff of groter 0x08ff3b6db6db6db6is, retourneert de functie H3_INVALID_CELL_ID.

Voorbeelden

-- Input a BIGINT representing a hexagonal cell.
> SELECT h3_boundaryaswkt(599686042433355775)
  POLYGON((-121.91508032706 37.271355866732,-121.86222328902 37.353926450852,-121.9235499963 37.428341186094,-122.03773496427 37.420128677678,-122.09042892904 37.337556084353,-122.02910130919 37.263197974618,-121.91508032706 37.271355866732))

-- Input a STRING representing a pentagonal cell.
> SELECT h3_boundaryaswkt('8009fffffffffff')
  POLYGON((-10.444977544778 63.095054077525,5.5236465492903 55.706768465152,25.082722326708 58.401544870353,31.831280499087 68.92995788194,0.32561035194326 73.310223685444,-10.444977544778 63.095054077525))

-- Input is an invalid H3 cell ID.
> SELECT h3_boundaryaswkt(0)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID