h3_polyfillash3string fonksiyon

Şunun için geçerlidir:evet olarak işaretlendi Databricks SQL evet olarak işaretlendi Databricks Runtime 11.3 LTS ve üzeri

Olarak temsil edilen ARRAYH3 hücre kimliklerinden birini STRING döndürür. Bu kimlikler, centroid'leri girişte yer alan onaltılıklara veya belirtilen çözünürlüğün beşgenlerine karşılık gelir.

Syntax

h3_polyfillash3string ( geographyExpr, resolutionExpr )

Arguments

  • geographyExpr BINARY: STRING, WKT veya GeoJSON'da bir areal coğrafyayı (çokgen veya çok kutuplu) temsil eden bir veya ifadesi. Coğrafyanın WGS84 koordinat başvuru sistemine başvuran derecelerde boylam ve enlem koordinatlarına sahip olması beklenir.
  • resolutionExpr INT: H3 hücre kimliklerinin çözünürlüğünü belirten ve değeri arasında 0 ve 15 kapsayıcı olması beklenen bir ifade.

Returns

ARRAY Belirtilen çözümlemenin STRING H3 hücre kimliklerine karşılık gelen ve giriş areal coğrafyasında centroid'leri bulunan 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ğerinin bir çokgenin WKB açıklaması veya çok kutuplu olması beklenir. İlk giriş bağımsız değişkeni türündeyse STRING, giriş değerinin bir çokgen veya çok köşeligenin WKT veya GeoJSON açıklaması olması beklenir. Giriş çokgeninin veya çok kutuplunun boyutu 2B, 3DZ, 3DM veya 4D olabilir.

Hata koşulları

  • türündeyse ve değer geçersiz bir WKB ise veya çokgen veya çok kutuplu bir değeri temsil etmiyorsageographyExpr, işlev BINARY döndürür.
  • türündeyse ve değer geçersiz bir WKT ise veya çokgen veya çok kutuplu bir değeri temsil etmiyorsageographyExpr, işlev STRING döndürür.
  • türündeyse ve değer geçersiz bir GeoJSON ise veya çokgen veya çok kutuplu bir değeri temsil etmiyorsageographyExpr, işlev STRING döndürür.
  • resolutionExpr değeri 0 değerinden küçük veya 15 değerinden büyükse, işlev H3_INVALID_RESOLUTION_VALUE döndürür.

Examples

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Feeding an empty linestring in GeoJSON format (as opposed to a polygon or multipolygon).
> SELECT h3_polyfillash3string('{"type":"LineString","coordinates":[]}', 2);
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"LineString"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_polyfillash3string(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_polyfillash3string('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_polyfillash3string('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
  • Last updated on