h3_longlatash3 وظيفه

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

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

بناء الجملة

h3_longlatash3 ( longitudeExpr, latitudeExpr, resolutionExpr )

الوسيطات

  • longitudeExpr: تعبير مزدوج يمثل خط الطول (بالدرجات) للموقع الذي نريد حساب معرف الخلية H3 الخاص به.
  • latitudeExpr: تعبير مزدوج يمثل خط العرض (بالدرجات) للموقع الذي نريد حساب معرف الخلية H3 الخاص به.
  • resolutionExpr: تعبير INT، الذي من المتوقع أن تتراوح قيمته بين 0 و15 ضمنا، مع تحديد دقة معرف الخلية H3.

المرتجعات

قيمة من نوع BIGINT تمثل معرف الخلية H3 لموقع الإدخال بدقة محددة.

ترجع الدالة NULL إذا كان أي من تعبيرات الإدخال الثلاثة NULL. يتم تعيين القيم الخارجية [-180, 180] لتعبير خط الطول وتعبير [-90, 90] خط العرض إلى ما يعادلها داخل هذه النطاقات. من المتوقع أن تكون قيم خط الطول وخط العرض في النظام المرجعي إحداثيات WGS84.

حالات الخطأ

الأمثلة

-- Simple example.
> SELECT h3_longlatash3(100, 45, 6)
  604116085645508607

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_longlatash3(-122.4783, 37.8199, 13)
  635714569676958015

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