GISarabia.org
PostGIS › الدليل الرسمي › 7. مرجع PostGIS › 7.9.3. صيغ أخرى
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_GeoHash

الصفحة الأصلية بالإنجليزية postgis.net ↗

الاسم

ST_GeoHash — تُعيد تمثيل GeoHash للشكل الهندسي.

المختصر

text ST_GeoHash(geometry geom, integer maxchars=full_precision_of_point);

الوصف

تحسب تمثيل GeoHash لشكل هندسي. يُرمِّز GeoHash نقطة جغرافية في صيغة نصية قابلة للفرز والبحث اعتمادًا على البادئات. وكلما كان GeoHash أقصر كان تمثيل النقطة أقل دقة. ويمكن تصوّره كمستطيل يحتوي النقطة.

يمكن أيضًا مقابلة قيم الأشكال الهندسية غير النقطية ذات الامتداد غير الصفري برموز GeoHash. وتعتمد دقة الرمز على الامتداد الجغرافي للشكل الهندسي.

إذا لم تُحدَّد maxchars، يكون رمز GeoHash المُعاد لأصغر خلية تحتوي الشكل الهندسي المُدخل. تُعيد النقاط GeoHash بدقة 20 حرفًا (وهو ما يكفي تقريبًا لاستيعاب الدقة المزدوجة الكاملة للمُدخل). وقد تُعيد أنواع الأشكال الهندسية الأخرى GeoHash بدقة أقل، بحسب امتداد الشكل الهندسي. تُمثَّل الأشكال الأكبر بدقة أقل، والأصغر بدقة أكبر. والمستطيل الذي يحدده رمز GeoHash يحتوي دائمًا المعلم المُدخل.

إذا حُدِّدت maxchars فإن رمز GeoHash المُعاد يحتوي على ذلك العدد من الأحرف على الأكثر. وهو يقابل تمثيلًا (ربما) أقل دقة للشكل الهندسي المُدخل. وبالنسبة إلى غير النقاط، تكون نقطة بداية الحساب مركز المستطيل المحيط للشكل الهندسي.

متاحة منذ: 1.4.0

[ملاحظة]

تتطلب ST_GeoHash أن يكون الشكل الهندسي المُدخل بإحداثيات جغرافية (lon/lat).

تدعم هذه الدالة الأقواس الدائرية (Circular Strings) والمنحنيات.

أمثلة

SELECT ST_GeoHash( ST_Point(-126,48) );

   st_geohash
----------------------
 c0w3hf1s70w3hf1s70w3

SELECT ST_GeoHash( ST_Point(-126,48), 5);

 st_geohash
------------
 c0w3h

-- This line contains the point, so the GeoHash is a prefix of the point code
SELECT ST_GeoHash('LINESTRING(-126 48, -126.1 48.1)'::geometry);

 st_geohash
------------
 c0w3