Aracılığıyla paylaş

h3_coverash3string işlevi

  • Makale

Şunlar için geçerlidir: onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 13.3 LTS ve üzeri

H3 hücre kimliklerini temsil eden BIR STRING değerleri DIZISI döndürür. Bu değerler, giriş doğrusal veya areal coğrafyasını tamamen kapsayan belirtilen çözünürlüğün en az onaltılık veya beşgen kümesine karşılık gelir.

Söz dizimi

h3_coverash3 ( geographyExpr, resolutionExpr )

Bağımsız değişkenler

Döndürülenler

Giriş doğrusal veya areal coğrafyasını tam olarak kapsayan, belirtilen çözünürlüğün en düşük H3 hücre kimlikleri kümesine karşılık gelen STRING değerleri dizisi.

giriş ifadelerinden herhangi biri ise NULLişlevi döndürürNULL. İlk giriş bağımsız değişkeni BINARY türündeyse, giriş değeri bir satır dizesinin, çokgenin, çok satırlı dizenin veya çok köşeli ayrıcın WKB açıklaması olmalıdır. İlk giriş bağımsız değişkeni STRING türündeyse, giriş değeri bir çizgi dizesinin, çokgenin, çok satırlı dizenin veya çok kutuplunun WKT veya GeoJSON açıklaması olmalıdır. Giriş çizgi dizesi, çokgen, çok satırlı veya çok köşeligen boyutu 2B, 3DZ, 3DM veya 4B olabilir.

Hata koşulları

  • binary türündeyse ve değer geçersiz bir WKB ise veya bir çizgi dizesi, çokgen, çok satırlı dize veya çok köşeli ayrıcı temsil etmiyorsageographyExpr, işlev WKB_PARSE_ERROR döndürür.
  • STRING türündeyse ve değer geçersiz bir WKT ise veya bir çizgi dizesi, çokgen, çok satırlı veya çok köşeli ayrıcı temsil etmiyorsageographyExpr, işlev WKT_PARSE_ERROR döndürür.
  • STRING türündeyse ve değer geçersiz bir GeoJSON ise veya bir çizgi dizisini, çokgeni, çok satırlı dizeyi veya çok kutupluyu temsil etmiyorsageographyExpr, işlev GEOJSON_PARSE_ERROR döndürür.
  • değerinden küçük 0 veya daha 15büyükse resolutionExpr işlev H3_INVALID_RESOLUTION_VALUE döndürür.

Örnekler

-- 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_coverash3string('{"type":"MultiPoint","coordinates":[]}', 2)
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"MultiPoint"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_coverash3string(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_coverash3string('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_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