مشاركة عبر

h3_try_polyfillash3string وظيفه

  • مقالة

ينطبق على:وضع علامة Databricks SQL وضع علامة Databricks Runtime 11.3 LTS وما فوق

يتصرف بنفس سلوك h3_polyfillash3string، باستثناء أنه يتم إرجاع NULL بدلا من خطأ إذا كانت الوسيطة الأولى غير صالحة. بشكل أكثر دقة، ترجع صفيف من معرفات الخلية H3 (ممثلة كسلسلة) مطابقة للسكساسيات أو البنتاغونات، للدقة المحددة، التي تحتوي عليها الجغرافيا الجغرافية للمدخلات.

بناء الجملة

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

الوسيطات

  • geographyExpr: تعبير ثنائي أو سلسلة يمثل جغرافيا جغرافية (مضلع أو متعدد المسارات) في W كيلوبايت أو WKT أو GeoJSON. ومن المتوقع أن يكون للجغرافيا إحداثيات خط الطول وخط العرض بالدرجات التي تشير إلى النظام المرجعي إحداثيات WGS84 .
  • resolutionExpr: تعبير INT، من المتوقع أن تكون قيمته بين 0 و15 ضمنا، مع تحديد دقة الخلايا H3.

المرتجعات

صفيف من قيم STRING المقابلة لمعرفات الخلية H3، للدقة المحددة، التي تحتوي عليها جغرافية الإدخال.

ترجع الدالة NULL إذا كان أي من تعبيرات الإدخال NULL. إذا كانت وسيطة الإدخال الأولى من النوع BINARY، فمن المتوقع أن تكون قيمة الإدخال وصف W كيلوبايت لمضلع أو متعدد المضلعات. إذا كانت وسيطة الإدخال الأولى من النوع STRING، فمن المتوقع أن تكون قيمة الإدخال إما WKT أو وصف GeoJSON لمضلع أو متعدد المضلعات. يمكن أن يكون بعد مضلع الإدخال أو متعدد المضلعات 2D أو 3DZ أو 3DM أو 4D. ترجع الدالة NULL إذا كانت الوسيطة الأولى تتوافق مع W كيلوبايت أو WKT أو GeoJSON غير صالح أو لا تمثل مضلعا أو متعدد المضلعات.

حالات الخطأ

الأمثلة

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_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_try_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2)
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

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

-- Resolution is out of range.
> SELECT h3_try_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