مشاركة عبر

h3_pointash3string وظيفه

  • مقالة

إرجاع معرف الخلية H3 (كسلسلة) المطابق للنقطة المتوفرة عند الدقة المحددة.

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

بناء الجملة

h3_pointash3string ( geographyExpr, resolutionExpr )

الوسيطات

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

المرتجعات

إرجاع معرف الخلية H3 (كسلسلة) المطابق للنقطة المتوفرة عند الدقة المحددة.

ترجع الدالة NULL إذا كان أي من تعبيرات الإدخال NULL. إذا كانت وسيطة الإدخال الأولى من النوع BINARY، فمن المتوقع أن تكون قيمة الإدخال وصف W كيلوبايت للنقطة. إذا كانت وسيطة الإدخال الأولى من النوع STRING، فمن المتوقع أن تكون قيمة الإدخال إما WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) أو وصف GeoJSON للنقطة. يمكن أن يكون بعد نقطة الإدخال 2D أو 3DZ أو 3DM أو 4D. من المتوقع أن تكون قيم خط الطول وخط العرض في وصف W كيلوبايت أو WKT أو GeoJSON في النظام المرجعي إحداثيات WGS84. ترجع الدالة NULL إذا كان الإدخال الأول يتوافق مع النقطة الفارغة.

حالات الخطأ

الأمثلة

-- Simple example.
> SELECT h3_pointash3string('POINT(100 45)', 6)
  86240610fffffff

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_pointash3string('POINT(-122.4783 37.8199)', 13)
  8d283087022a93f

-- The function returns NULL if the input is the empty point.
> SELECT h3_pointash3string('{"type":"Point","coordinates":[]}', 15)
  null

-- Feeding a multipoint in WKT format instead of a point.
> SELECT h3_pointash3string('MULTIPOINT(100 45)', 6)
  [WKT_PARSE_ERROR] Error parsing WKT: Invalid or unsupported type 'MULTIPOINT' at position 1

-- Feeding an invalid GeoJSON string ("type" value is not correct).
> SELECT h3_pointash3string('{"type":"POINT","coordinates":[]}', 15)
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"POINT"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_pointash3string(unhex('0201000000516b9a779c9e5ec0c5feb27bf2e84240'), 2)
  [WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1

-- Resolution is out of range.
> SELECT h3_pointash3string('POINT(-122.4783 37.8199)', 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive