41. الملحق A: دوال PostGIS¶
41.1. دوال الإنشاء¶
- ST_MakePoint(Longitude, Latitude)
تُرجع نقطة جديدة. لاحظ ترتيب الإحداثيات (خط الطول ثم خط العرض).
- ST_GeomFromText(WellKnownText, srid)
تُرجع شكلًا هندسيًا جديدًا من سلسلة WKT قياسية وقيمة srid.
- ST_SetSRID(geometry, srid)
تحدّث قيمة srid لشكل هندسي، وتُرجع الشكل الهندسي نفسه. لا تغيّر هذه الدالة إحداثيات الشكل الهندسي، بل تحدّث srid فقط. وهي مفيدة لتهيئة الأشكال الهندسية التي أُنشئت دون srid.
- ST_Expand(geometry, Radius)
تُرجع شكلًا هندسيًا جديدًا هو مربع محيط موسَّع للشكل الهندسي المُدخل. وهي مفيدة لإنشاء أغلفة تُستخدم في عمليات البحث المفهرسة.
41.2. دوال الإخراج¶
41.3. دوال القياس¶
- ST_Area(geometry)
تُرجع مساحة الشكل الهندسي بوحدات النظام المرجعي المكاني.
- ST_Length(geometry)
تُرجع طول الشكل الهندسي بوحدات النظام المرجعي المكاني.
- ST_Perimeter(geometry)
تُرجع محيط الشكل الهندسي بوحدات النظام المرجعي المكاني.
- ST_NumPoints(linestring)
تُرجع عدد الرؤوس في خط (linestring).
- ST_NumRings(polygon)
تُرجع عدد الحلقات في مضلع.
- ST_NumGeometries(geometry)
تُرجع عدد الأشكال الهندسية في مجموعة أشكال هندسية.
41.4. دوال العلاقات¶
- ST_Distance(geometry, geometry)
تُرجع المسافة بين شكلين هندسيين بوحدات النظام المرجعي المكاني.
- ST_DWithin(geometry, geometry, radius)
تُرجع true إذا كان الشكلان الهندسيان ضمن مسافة نصف القطر أحدهما من الآخر، وإلا تُرجع false.
- ST_Intersects(geometry, geometry)
تُرجع true إذا لم يكن الشكلان الهندسيان منفصلين، وإلا تُرجع false.
- ST_Contains(geometry, geometry)
تُرجع true إذا كان الشكل الهندسي الأول يحتوي الشكل الهندسي الثاني بالكامل، وإلا تُرجع false.
- ST_Crosses(geometry, geometry)
تُرجع true إذا عبر خط أو حد مضلع خطًا آخر أو حد مضلع آخر، وإلا تُرجع false.