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. دوال الإخراج

ST_AsText(geometry)

تُرجع الشكل الهندسي بصيغة نصية يقرؤها الإنسان.

ST_AsGML(geometry)

تُرجع الشكل الهندسي بصيغة GML القياسية من OGC.

ST_AsGeoJSON(geometry)

تُرجع الشكل الهندسي بصيغة GeoJSON القياسية.

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.