Compartir vía

Función h3_boundaryasgeojson

  • Artículo

Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores

Devuelve el límite poligonal de la celda H3 de entrada en formato GeoJSON.

Sintaxis

h3_boundaryasgeojson ( h3CellIdExpr )

Argumentos

  • h3CellIdExpr: expresión BIGINT o expresión STRING hexadecimal que representa un identificador de celda H3.

Devoluciones

Valor del tipo STRING que representa el límite poligonal de la celda H3 de entrada en formato GeoJSON.

La función devuelve NULL si la expresión de entrada es NULL. La función realiza una validación parcial con respecto a si el argumento de entrada es un identificador de celda H3 válido. Una condición necesaria, pero no suficiente para un identificador H3 válido es que su valor está entre 0x08001fffffffffff y 0x08ff3b6db6db6db6. El comportamiento de la función no está definido si el identificador de celda de entrada no es un identificador de celda válido.

Condiciones de error

  • Si h3CellIdExpr es una cadena que no se puede convertir en BIGINT o corresponde a un valor BIGINT menor que 0x08001fffffffffff o mayor que 0x08ff3b6db6db6db6, la función devuelve H3_INVALID_CELL_ID.

Ejemplos

-- Input a BIGINT representing a hexagonal cell.
> SELECT h3_boundaryasgeojson(599686042433355775)
  {"type":"Polygon","coordinates":[[[-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_boundaryasgeojson('8009fffffffffff')
  {"type":"Polygon","coordinates":[[[-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_boundaryasgeojson(0)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID