Aracılığıyla paylaş

h3_coverash3string işlevi

Ş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

STRING değerlerini temsil eden bir H3 hücre kimlikleri dizisi döndürür. Bu değerler, girişteki doğrusal veya alansal coğrafyayı tamamen kapsayan belirtilen çözünürlüğün minimum sayıda altıgen veya beşgen kümesine karşılık gelir.

Söz dizimi

h3_coverash3 ( geographyExpr, resolutionExpr )

Argümanlar

  • geographyExpr: WKB, WKT veya GeoJSON'da doğrusal (linestring veya multilinestring) ya da areal (çokgen veya çokkademeli çokgen) coğrafyayı 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: H3 hücre kimlikleri için çözünürlüğü belirleyen, 0 ile 15 dahil arasında bir değere sahip bir INT ifadesi.

İadeler

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

İşlev, giriş ifadelerinden herhangi biri NULL ise NULL döndürür. İlk giriş bağımsız değişkeni BINARY türündeyse, giriş değeri çizgi dizesi, çokgen, çok çizgi dizesi veya çokgenin WKB açıklaması olmalıdır. İlk giriş argümanı STRING türündeyse, giriş değeri bir çizgi, çokgen, çok parçalı çizgi veya çok parçalı çokgenin WKT veya GeoJSON açıklaması olmalıdır. Giriş çizgi, çokgen, çoklu çizgi veya çoklu çokgen boyutu 2B, 3DZ, 3DM veya 4B olabilir.

Hata koşulları

  • geographyExpr binary türündeyse ve değer ya geçersiz bir WKB ise ya da bir çizgi dizesi, çokgen, çoğul satırlı dize veya çoğul köşegen temsil etmiyorsa, işlev WKB_PARSE_ERROR döndürür.
  • geographyExpr STRING türündeyse ve değer geçersiz bir WKT ise veya bir çizgi, çokgen, çoklu çizgi veya çoklu çokgen temsil etmiyorsa, 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.
  • resolutionExpr 0'den küçük veya 15'den büyükse, 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