h3_try_polyfillash3 fungsi

  • Artikel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 11.3 LTS ke atas

Bereaksi sama seperti h3_polyfillash3, kecuali bahwa NULL dikembalikan alih-alih kesalahan jika argumen pertama tidak valid. Lebih tepatnya, mengembalikan ARRAY ID sel H3 (direpresentasikan sebagai BIGINT) yang sesuai dengan segi enam atau segi lima, dari resolusi yang ditentukan, yang dimuat oleh geografi areal input.

Sintaks

h3_try_polyfillash3 ( geographyExpr, resolutionExpr )

Argumen

  • geographyExpr: Ekspresi BINER atau STRING yang mewakili geografi areal (poligon atau multipoligon) di WKB, WKT, atau GeoJSON. Geografi ini diharapkan memiliki koordinat bujur dan lintang dalam derajat yang mengacu pada sistem referensi koordinat WGS84 .
  • resolutionExpr: Ekspresi INT, yang nilainya diharapkan antara 0 dan 15 inklusif, menentukan resolusi untuk sel H3.

Mengembalikan

ARRAY nilai BIGINT yang sesuai dengan ID sel H3, dari resolusi yang ditentukan, yang dimuat oleh geografi areal input.

Fungsi mengembalikan NULL jika salah satu ekspresi input adalah NULL. Jika argumen input pertama berjenis BINARY, nilai input diharapkan menjadi deskripsi WKB dari poligon atau multipoligon. Jika argumen input pertama berjenis STRING, nilai input diharapkan menjadi WKT atau deskripsi GeoJSON dari poligon atau multipoligon. Dimensi poligon input atau multipoligon dapat berupa 2D, 3DZ, 3DM, atau 4D. Fungsi mengembalikan NULL jika argumen pertama sesuai dengan WKB, WKT, atau GeoJSON yang tidak valid atau tidak mewakili poligon atau multipoligon.

Kondisi kesalahan

Contoh

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_polyfillash3('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2)
  [586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2)
  [586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]

-- The input is invalid.
> SELECT h3_try_polyfillash3('Not-a-valid-rep', 2)
  null

-- Resolution is out of range.
> SELECT h3_try_polyfillash3('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