A h3_pointash3string
függvény
A megadott pontnak megfelelő H3 cellaazonosítót adja vissza (sztringként) a megadott felbontásban.
A következőkre vonatkozik: Databricks SQL preview Databricks Runtime 11.3 LTS és újabb
Syntax
h3_pointash3string ( geographyExpr, resolutionExpr )
Argumentumok
geographyExpr
: A WKB, A WKT vagy a GeoJSON pontföldrajzát képviselő BINÁRIS vagy SZTRING kifejezés. A földrajzi hely várhatóan hosszúsági és szélességi koordinátákkal rendelkezik, amelyek a WGS84 koordináta-referenciarendszerre hivatkoznak.resolutionExpr
: Egy INT-kifejezés, amelynek értéke várhatóan a kettő között0
és15
a befogadó között lesz, és megadja a H3 cellaazonosító felbontását.
Válaszok
A megadott pontnak megfelelő H3 cellaazonosítót adja vissza (sztringként) a megadott felbontásban.
A függvény null értéket ad vissza, ha a bemeneti kifejezések bármelyike NULL. Ha az első bemeneti argumentum BINÁRIS típusú, a bemeneti érték várhatóan egy pont WKB-leírása lesz. Ha az első bemeneti argumentum KARAKTERLÁNC típusú, a bemeneti érték várhatóan a WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) vagy a pont GeoJSON-leírása lesz. A bemeneti pont mérete lehet 2D, 3DZ, 3DM vagy 4D. A WKB, WKT vagy GeoJSON leírásban szereplő hosszúsági és szélességi értékek várhatóan a WGS84 koordináta-referenciarendszerben lesznek. A függvény NULL értéket ad vissza, ha az első bemenet az üres pontnak felel meg.
Hibafeltételek
- Ha
geographyExpr
BINÁRIS típusú, és az érték vagy érvénytelen WKB, vagy nem jelöl pontot, a függvény WKB_PARSE_ERROR ad vissza. - Ha
geographyExpr
sztring típusú, és az érték érvénytelen WKT, vagy nem jelöl pontot, a függvény WKT_PARSE_ERROR ad vissza. - Ha
geographyExpr
sztring típusú, és az érték érvénytelen GeoJSON, vagy nem jelöl pontot, a függvény GEOJSON_PARSE_ERROR ad vissza. - Ha
resolutionExpr
kisebb vagy nagyobb, mint0
15
, a függvény H3_INVALID_RESOLUTION_VALUE ad vissza.
Példák
-- Simple example.
> SELECT h3_pointash3string('POINT(100 45)', 6)
86240610fffffff
-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_pointash3string('POINT(-122.4783 37.8199)', 13)
8d283087022a93f
-- The function returns NULL if the input is the empty point.
> SELECT h3_pointash3string('{"type":"Point","coordinates":[]}', 15)
null
-- Feeding a multipoint in WKT format instead of a point.
> SELECT h3_pointash3string('MULTIPOINT(100 45)', 6)
[WKT_PARSE_ERROR] Error parsing WKT: Invalid or unsupported type 'MULTIPOINT' at position 1
-- Feeding an invalid GeoJSON string ("type" value is not correct).
> SELECT h3_pointash3string('{"type":"POINT","coordinates":[]}', 15)
[GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"POINT"' at position 9
-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_pointash3string(unhex('0201000000516b9a779c9e5ec0c5feb27bf2e84240'), 2)
[WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1
-- Resolution is out of range.
> SELECT h3_pointash3string('POINT(-122.4783 37.8199)', 16)
[H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive
Kapcsolódó függvények
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: