h3_pointash3string
işlevi
Belirtilen çözünürlükte sağlanan noktaya karşılık gelen H3 hücre kimliğini (DIZE olarak) döndürür.
Şunlar için geçerlidir: Databricks SQL önizlemesi Databricks Runtime 11.3 LTS ve üzeri
Söz dizimi
h3_pointash3string ( geographyExpr, resolutionExpr )
Bağımsız değişkenler
geographyExpr
: WKB, WKT veya GeoJSON'da bir nokta coğrafyasını temsil eden binary veya STRING ifadesi. Coğrafyanın WGS84 koordinat başvuru sistemine başvuran derecelerde boylam ve enlem koordinatlarına sahip olması beklenir.resolutionExpr
: Değerinin arasında0
ve15
kapsayıcı olması beklenen, H3 hücre kimliğinin çözünürlüğünü belirten bir INT ifadesi.
Döndürülenler
Belirtilen çözünürlükte sağlanan noktaya karşılık gelen H3 hücre kimliğini (DIZE olarak) döndürür.
Giriş ifadelerinden herhangi biri NULL ise işlev NULL döndürür. İlk giriş bağımsız değişkeni BINARY türündeyse, giriş değerinin bir noktanın WKB açıklaması olması beklenir. İlk giriş bağımsız değişkeni STRING türündeyse, giriş değerinin WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) veya bir noktanın GeoJSON açıklaması olması beklenir. Giriş noktasının boyutu 2B, 3DZ, 3DM veya 4D olabilir. WKB, WKT veya GeoJSON açıklamasındaki boylam ve enlem değerlerinin WGS84 koordinat başvuru sisteminde olması beklenir. İlk giriş boş noktaya karşılık geliyorsa işlev NULL döndürür.
Hata koşulları
- binary türündeyse ve değer geçersiz bir WKB ise veya bir noktayı temsil etmiyorsa
geographyExpr
, işlev WKB_PARSE_ERROR döndürür. - STRING türündeyse ve değer geçersiz bir WKT ise veya bir noktayı temsil etmiyorsa
geographyExpr
, işlev WKT_PARSE_ERROR döndürür. - STRING türündeyse ve değer geçersiz bir GeoJSON ise veya bir noktayı temsil etmiyorsa
geographyExpr
işlev GEOJSON_PARSE_ERROR döndürür. - değerinden küçük
0
veya daha15
büyükseresolutionExpr
işlev H3_INVALID_RESOLUTION_VALUE döndürür.
Örnekler
-- 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