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.
حالات الخطأ
- إذا كانت
resolutionExpr
أصغر من0
أو أكبر من15
، ترجع الدالة H3_INVALID_RESOLUTION_VALUE.
الأمثلة
-- 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