Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
Databricks SQL
Databricks Runtime 11.3 LTS e superiori
Lakehouse//RT
Restituisce un ARRAY di ID cella H3 rappresentati come STRING, corrispondenti agli esagoni o ai pentagoni della risoluzione specificata i cui centroidi sono contenuti nell'area geografica dell'input.
Sintassi
h3_polyfillash3string ( geographyExpr, resolutionExpr )
Argomenti
-
geographyExpr: Un'espressione oSTRINGcheBINARYrappresenta una geografia areale (poligono o multipoligono) in WKB, WKT o GeoJSON. La geografia dovrebbe avere coordinate di longitudine e latitudine in gradi che fanno riferimento al sistema di riferimento delle coordinate WGS84 . -
resolutionExpr: Un'espressioneINT, il cui valore si prevede sia compreso0tra e15inclusivo, che specifica la risoluzione per gli ID delle celle H3.
Valori restituiti
Oggetto ARRAY di STRING valori corrispondenti agli ID di cella H3 della risoluzione specificata i cui centroidi sono contenuti nell'input geografico.
La funzione restituisce NULL se una delle espressioni di input è NULL.
Se il primo argomento di input è di tipo BINARY, si prevede che il valore di input sia la descrizione WKB di un poligono o un multipolygon.
Se il primo argomento di input è di tipo STRING, si prevede che il valore di input sia il WKT o la descrizione GeoJSON di un poligono o un multipolygon.
La dimensione del poligono di input o multipolygon può essere 2D, 3DZ, 3DM o 4D.
Condizioni di errore
- Se
geographyExprè di tipoBINARYe il valore è un WKB non valido o non rappresenta un poligono o un multipolygon, la funzione restituisce WKB_PARSE_ERROR. - Se
geographyExprè di tipoSTRINGe il valore è un WKT non valido o non rappresenta un poligono o un multipolygon, la funzione restituisce WKT_PARSE_ERROR. - Se
geographyExprè di tipoSTRINGe il valore è un GeoJSON non valido o non rappresenta un poligono o un multipolygon, la funzione restituisce GEOJSON_PARSE_ERROR. - Se
resolutionExprè minore o maggiore di015, la funzione restituisce H3_INVALID_RESOLUTION_VALUE.
Esempi
-- Simple example where the input is a triangle in WKT format.
> SELECT h3_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_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2);
[82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]
-- Feeding an empty linestring in GeoJSON format (as opposed to a polygon or multipolygon).
> SELECT h3_polyfillash3string('{"type":"LineString","coordinates":[]}', 2);
[GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"LineString"' at position 9
-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_polyfillash3string(unhex('020700000000'), 2);
[WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1
-- Feeding an invalid polygon in WKT (polygon is not closed)
> SELECT h3_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-74.0060 40.7128))', 2);
[WKT_PARSE_ERROR] Error parsing WKT: Found non-closed ring at position 80
-- Resolution is out of range.
> SELECT h3_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