Compartir a través de

h3_try_coverash3string Función

Se aplica a:marcado como sí Databricks SQL marcado como sí Databricks Runtime 16.3 y versiones posteriores

Esta función se comporta igual que h3_coverash3string, pero devuelve NULL en lugar de un error si el primer argumento no es válido. Devuelve un ARRAY de valores que representan identificadores de BIGINT celda H3. Estos valores corresponden al conjunto mínimo de hexágonos o pentágonos en la resolución especificada que cubre completamente la geografía lineal o areal de entrada.

Syntax

h3_try_coverash3string ( geographyExpr, resolutionExpr )

Arguments

  • geographyExpr: una expresión BINARY o STRING que representa una geografía lineal (línea o multilínea) o areal (polígono o multipolígono) en WKB, WKT o GeoJSON. Se espera que la geografía tenga coordenadas de longitud y latitud en grados que hacen referencia al sistema de referencia de coordenadas WGS84 .
  • resolutionExpr: expresión INT , con un valor entre 0 e 15 inclusivo, especificando la resolución de los identificadores de celda H3.

Devoluciones

Un ARRAY de BIGINT valores correspondientes al conjunto mínimo de hexágonos o pentágonos en la resolución especificada que cubre completamente la geografía lineal o de área de entrada.

La función devuelve NULL si alguna de las expresiones de entrada es NULL. Si el primer argumento de entrada es de tipo BINARY, el valor de entrada debe ser la descripción WKB de una linestring, polygon, multilinestring o multipolygon. Si el primer argumento de entrada es de tipo STRING, el valor de entrada debe ser WKT o la descripción de GeoJSON de una linestring, polygon, multilinestring o multipolygon. La dimensión de la cadena de líneas de entrada, polígono, cadena de líneas múltiples o multipolígono puede ser 2D, 3DZ, 3DM o 4D. La función devuelve NULL si el primer argumento corresponde a un WKB, WKT o GeoJSON no válido o no representa una linestring, polygon, multilinestring o multipolygon.

Condiciones de error

Examples

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 0);
  [8027fffffffffff,8029fffffffffff,802bfffffffffff,8049fffffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_coverash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 0);
  [8027fffffffffff,8029fffffffffff,802bfffffffffff,8049fffffffffff]

-- Simple example where the input is a linestring in GeoJSON format.
SELECT h3_coverash3string('{"type":"LineString","coordinates":[[-122.4194,37.7749],[-118.2437,34.0522],[-74.0060,40.7128]]}', 1);
  [8148fffffffffff, 8129bffffffffff, 812a3ffffffffff, 812abffffffffff, 81267ffffffffff, 8126fffffffffff, 81283ffffffffff]

-- Feeding an empty multipoint in GeoJSON format (as opposed to a linestring, polygon, multilinestring, or multipolygon).
> SELECT h3_try_coverash3string('{"type":"MultiPoint","coordinates":[]}', 2);
  null

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_try_coverash3string(unhex('020700000000'), 2);
  null

-- Feeding an invalid polygon in WKT (polygon is not closed)
> SELECT h3_try_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-74.0060 40.7128))', 2);
  null

-- Resolution is out of range.
> SELECT h3_try_coverash3string('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
  • Last updated on