Aracılığıyla paylaş

h3_try_coverash3string fonksiyon

Geçerlidir:evet olarak işaretlendi Databricks SQL evet olarak işaretlendi Databricks Runtime 16.3 ve üzeri

Bu işlev h3_coverash3string gibi davranır, ancak ilk bağımsız değişken geçersizse hata yerine döndürür NULL . ARRAY bir BIGINT listesi döndürür ve bu liste H3 hücre kimliklerini temsil eden değerleri içerir. Bu değerler, belirtilen çözünürlükte giriş çizgisel veya alan coğrafyasını tamamen kapsayan asgari altıgen veya beşgen kümesine karşılık gelir.

Sözdizimi

h3_try_coverash3string ( geographyExpr, resolutionExpr )

Tartışmalar

  • geographyExpr: BINARY veya STRING ifadesi, WKB, WKT veya GeoJSON'da doğrusal (linestring veya multilinestring) ya da alan (çokgen veya multipolygon) coğrafyayı temsil eden. Coğrafyanın WGS84 koordinat başvuru sistemine başvuran derecelerde boylam ve enlem koordinatlarına sahip olması beklenir.
  • resolutionExpr: INT ifadesi, H3 hücre kimliklerinin çözünürlüğünü belirten ve değeri 0 ile 15 arasında olan bir değer içerir.

İade

ARRAY BIGINT Belirtilen çözünürlükte en az onaltılık veya beşgen kümesine karşılık gelen ve giriş doğrusal veya areal coğrafyasını tamamen kapsayan değerlerden biri.

Giriş ifadelerinden herhangi biri NULL ise, işlev NULL değerini döndürür. İlk giriş bağımsız değişkeni türündeyse BINARY, 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 hattının, çokgenin, çoklu çizgi veya çoklu çokgenin WKT veya GeoJSON açıklaması olmalıdır. Giriş çizgi, çokgen, çoklu çizgi veya çoklu çokgen boyutu 2B, 3DZ, 3DM veya 4B olabilir. İşlev, ilk bağımsız değişken geçersiz bir WKB, WKT veya GeoJSON'a karşılık geliyorsa veya bir çizgi dizesi, çokgen, çok satırlı veya çok köşeli ayrıcı temsil etmiyorsa döndürürNULL.

Hata koşulları

Ö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_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