فصل 13. فهرس دوال PostGIS الخاصة
- 13.1. الدوال التجميعية في PostGIS
- 13.2. دوال النافذة في PostGIS
- 13.3. دوال PostGIS المتوافقة مع SQL-MM
- 13.4. دوال PostGIS الداعمة لنوع geography
- 13.5. دوال PostGIS الداعمة للرستر
- 13.6. دوال التفريغ (Dump) في PostGIS للأنواع geometry وgeography والرستر
- 13.7. دوال الصناديق (Box) في PostGIS
- 13.8. دوال PostGIS الداعمة للأبعاد الثلاثية
- 13.9. دوال PostGIS الداعمة للأشكال الهندسية المنحنية
- 13.10. دوال PostGIS الداعمة للأسطح متعددة الوجوه
- 13.11. مصفوفة دعم دوال PostGIS
- 13.12. دوال PostGIS الجديدة أو المحسّنة أو المعدّلة
13.1. الدوال التجميعية في PostGIS
الدوال أدناه دوال تجميعية مكانية تُستخدم بالطريقة نفسها التي تُستخدم بها الدوال التجميعية في SQL مثل sum وaverage.
- CG_3DUnion - تُجري اتحادًا ثلاثي الأبعاد باستخدام postgis_sfcgal.
- ST_3DExtent - دالة تجميعية تُعيد المستطيل المحيط ثلاثي الأبعاد بالأشكال الهندسية.
- ST_3DUnion - تُجري اتحادًا ثلاثي الأبعاد.
- ST_AsFlatGeobuf - تُعيد تمثيل FlatGeobuf لمجموعة من الصفوف.
- ST_AsGeobuf - تُعيد تمثيل Geobuf لمجموعة من الصفوف.
- ST_AsMVT - دالة تجميعية تُعيد تمثيل MVT لمجموعة من الصفوف.
- ST_ClusterDBSCAN - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية DBSCAN.
- ST_ClusterIntersecting - دالة تجميعية تُعنقد الأشكال الهندسية المُدخلة في مجموعات متصلة.
- ST_ClusterIntersectingWin - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل، بعنقدة الأشكال الهندسية المُدخلة في مجموعات متصلة.
- ST_ClusterKMeans - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية K-means.
- ST_ClusterWithin - دالة تجميعية تُعنقد الأشكال الهندسية حسب مسافة الفصل.
- ST_ClusterWithinWin - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل، بالعنقدة حسب مسافة الفصل.
- ST_Collect - تُنشئ مجموعة أشكال GeometryCollection أو شكلًا هندسيًا متعددًا Multi* من مجموعة أشكال هندسية.
- ST_CoverageClean - تحسب تغطية مضلعية نظيفة (متطابقة الحواف، غير متداخلة، خالية من الفجوات) انطلاقًا من مُدخل غير نظيف.
- ST_CoverageInvalidEdges - دالة نافذة تحدد المواضع التي تخفق فيها المضلعات في تشكيل تغطية صالحة.
- ST_CoverageSimplify - دالة نافذة تبسّط حواف تغطية مضلعية.
- ST_CoverageUnion - تحسب اتحاد مجموعة من المضلعات التي تشكّل تغطية بإزالة الحواف المشتركة.
- ST_Extent - دالة تجميعية تُعيد المستطيل المحيط بالأشكال الهندسية.
- ST_MakeLine - تُنشئ خطًا (LineString) من أشكال هندسية من نوع Point أو MultiPoint أو LineString.
- ST_MemUnion - دالة تجميعية تحسب اتحاد الأشكال الهندسية بطريقة موفّرة للذاكرة لكنها أبطأ
- ST_Polygonize - تحسب مجموعة من المضلعات المتكوّنة من خطوط مجموعة من الأشكال الهندسية.
- ST_SameAlignment - تُعيد true إذا كان للرسترات الميل والمقياس والمرجع المكاني والإزاحة نفسها (بحيث يمكن وضع البكسلات على الشبكة نفسها دون قطع البكسلات)، وتُعيد false إذا لم تكن كذلك مع إشعار يوضح المشكلة.
- ST_Union - تحسب شكلاً هندسياً يمثّل اتحاد مجموعات نقاط الأشكال المُدخلة.
- ST_Union - تُعيد اتحاد مجموعة من بلاطات الرستر في رستر واحد يتكون من نطاق واحد أو أكثر.
- TopoElementArray_Agg - تُعيد topoelementarray لمجموعة من مصفوفات element_id وtype (عناصر طوبولوجية).
13.2. دوال النافذة في PostGIS
الدوال أدناه دوال نافذة مكانية تُستخدم بالطريقة نفسها التي تُستخدم بها دوال النافذة في SQL مثل row_number() وlead() وlag(). ويجب أن تليها عبارة OVER().
- ST_ClusterDBSCAN - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية DBSCAN.
- ST_ClusterIntersectingWin - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل، بعنقدة الأشكال الهندسية المُدخلة في مجموعات متصلة.
- ST_ClusterKMeans - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية K-means.
- ST_ClusterWithinWin - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل، بالعنقدة حسب مسافة الفصل.
- ST_CoverageClean - تحسب تغطية مضلعية نظيفة (متطابقة الحواف، غير متداخلة، خالية من الفجوات) انطلاقًا من مُدخل غير نظيف.
- ST_CoverageInvalidEdges - دالة نافذة تحدد المواضع التي تخفق فيها المضلعات في تشكيل تغطية صالحة.
- ST_CoverageSimplify - دالة نافذة تبسّط حواف تغطية مضلعية.
13.3. دوال PostGIS المتوافقة مع SQL-MM
الدوال الواردة أدناه دوال PostGIS المتوافقة مع معيار SQL/MM 3
- CG_3DArea - تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- CG_3DDifference - تُجري فرقًا ثلاثي الأبعاد
- CG_3DIntersection - تُجري تقاطعًا ثلاثي الأبعاد
- CG_3DUnion - تُجري اتحادًا ثلاثي الأبعاد باستخدام postgis_sfcgal.
- CG_Volume - تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- ST_3DArea - تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- ST_3DDWithin - تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد ضمن مسافة ثلاثية الأبعاد معيّنة
- ST_3DDifference - تُجري فرقًا ثلاثي الأبعاد
- ST_3DDistance - تُعيد أقل مسافة ديكارتية ثلاثية الأبعاد (بناءً على النظام المرجعي المكاني) بين شكلين بوحدات الإسقاط.
- ST_3DIntersection - تُجري تقاطعًا ثلاثي الأبعاد
- ST_3DIntersects - تختبر ما إذا كان شكلان هندسيان يتقاطعان مكانيًا في الأبعاد الثلاثية - فقط للنقاط والخطوط والمضلعات والأسطح متعددة الوجوه (المساحة)
- ST_3DLength - تُعيد الطول ثلاثي الأبعاد لشكل هندسي خطي.
- ST_3DPerimeter - تُعيد المحيط ثلاثي الأبعاد لشكل هندسي مضلعي.
- ST_3DUnion - تُجري اتحادًا ثلاثي الأبعاد.
- ST_AddEdgeModFace - تضيف حافة جديدة، وإذا أدى ذلك إلى تقسيم وجه، تعدّل الوجه الأصلي وتضيف وجهًا جديدًا.
- ST_AddEdgeNewFaces - تضيف حافة جديدة، وإذا أدى ذلك إلى تقسيم وجه، تحذف الوجه الأصلي وتستبدله بوجهين جديدين.
- ST_AddIsoEdge - تضيف حافة معزولة معرّفة بالشكل الهندسي alinestring إلى طوبولوجيا، تصل بين عقدتين معزولتين موجودتين anode وanothernode، وتُعيد معرّف الحافة الجديدة.
- ST_AddIsoNode - تضيف عقدة معزولة إلى وجه في طوبولوجيا وتُعيد معرّف العقدة الجديدة (nodeid). إذا كان الوجه null فإن العقدة تُنشأ مع ذلك.
- ST_Area - تُعيد مساحة شكل هندسي مضلعي.
- ST_AsBinary - تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsGML - تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsText - تُعيد تمثيل النص المعروف (WKT) لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_Boundary - تُعيد حدود الشكل الهندسي.
- ST_Buffer - تحسب شكلاً هندسياً يغطي جميع النقاط الواقعة ضمن مسافة معيّنة من شكل هندسي.
- ST_Centroid - تُعيد المركز الهندسي لشكل هندسي.
- ST_ChangeEdgeGeom - تغيّر شكل حافة دون التأثير في بنية الطوبولوجيا.
- ST_Contains - تختبر ما إذا كانت كل نقطة من B تقع في A، وما إذا كان لداخليهما نقطة مشتركة
- ST_ConvexHull - تحسب الغلاف المحدب لشكل هندسي.
- ST_CoordDim - تُعيد بُعد الإحداثيات للشكل الهندسي.
- ST_CreateTopoGeo - تضيف مجموعة من الأشكال الهندسية إلى طوبولوجيا فارغة معطاة وتُعيد رسالة توضّح نجاح العملية.
- ST_Crosses - تختبر ما إذا كان لشكلين هندسيين بعض النقاط الداخلية المشتركة، لا كلها
- ST_CurveN - تُعيد المنحنى المكوِّن رقم N من منحنى مركّب (CompoundCurve).
- ST_CurveToLine - تحوّل شكلًا هندسيًا يحتوي على منحنيات إلى شكل خطي.
- ST_Difference - تحسب شكلًا هندسيًا يمثّل جزء الشكل الهندسي A الذي لا يتقاطع مع الشكل الهندسي B.
- ST_Dimension - تُعيد البُعد الطوبولوجي للشكل الهندسي.
- ST_Disjoint - تختبر ما إذا كان شكلان هندسيان لا يشتركان في أي نقطة
- ST_Distance - تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_EndPoint - تُعيد النقطة الأخيرة من خط (LineString) أو خط دائري (CircularLineString).
- ST_Envelope - تُعيد شكلًا هندسيًا يمثل المستطيل المحيط بالشكل الهندسي.
- ST_Equals - تختبر ما إذا كان شكلان هندسيان يضمّان مجموعة النقاط نفسها
- ST_ExteriorRing - تُعيد خطًا (LineString) يمثل الحلقة الخارجية لمضلع.
- ST_GMLToSQL - تُعيد قيمة ST_Geometry محددة من تمثيل GML. هذه الدالة اسم بديل لـ ST_GeomFromGML
- ST_GeomCollFromText - تُنشئ مجموعة أشكال (geometry) من WKT لمجموعة أشكال باستخدام SRID المعطى. وإذا لم يُعطَ SRID فقيمته الافتراضية 0.
- ST_GeomFromText - تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف (WKT).
- ST_GeomFromWKB - تُنشئ نسخة geometry من تمثيل geometry بصيغة الثنائي المعروف (WKB) مع SRID اختياري.
- ST_GeometryFromText - تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف (WKT). هذه الدالة اسم بديل لـ ST_GeomFromText
- ST_GeometryN - تُعيد عنصرًا من مجموعة أشكال هندسية.
- ST_GeometryType - تُعيد نوع SQL-MM للشكل الهندسي كنص.
- ST_GetFaceEdges - تُعيد مجموعة مرتّبة من الحواف التي تحدّ aface.
- ST_GetFaceGeometry - تُعيد المضلع في الطوبولوجيا المعطاة ذا معرّف الوجه المحدد.
- ST_InitTopoGeo - تُنشئ مخطط طوبولوجيا جديدًا وتسجّله في الجدول topology.topology.
- ST_InteriorRingN - تُعيد الحلقة الداخلية (الثقب) رقم N لمضلع.
- ST_Intersection - تحسب شكلاً هندسياً يمثّل الجزء المشترك بين الشكلين A وB.
- ST_Intersects - تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- ST_IsClosed - تختبر ما إذا كانت نقطتا بداية الخط (LineString) ونهايته متطابقتين. وبالنسبة إلى السطح متعدد الوجوه (PolyhedralSurface) تختبر ما إذا كان مغلقًا (حجميًا).
- ST_IsEmpty - تختبر ما إذا كان الشكل الهندسي فارغًا.
- ST_IsRing - تختبر ما إذا كان الخط (LineString) مغلقًا وبسيطًا.
- ST_IsSimple - تختبر ما إذا كان الشكل الهندسي خاليًا من نقاط التقاطع الذاتي أو التماس الذاتي.
- ST_IsValid - تختبر ما إذا كان الشكل الهندسي سليم البنية في البعدين.
- ST_Length - تُعيد الطول ثنائي الأبعاد لشكل هندسي خطي.
- ST_LineFromText - تُنشئ geometry من تمثيل WKT باستخدام SRID المعطى. وإذا لم يُعطَ SRID فقيمته الافتراضية 0.
- ST_LineFromWKB - تُنشئ LINESTRING من WKB باستخدام SRID المعطى
- ST_LinestringFromWKB - تُنشئ geometry من WKB باستخدام SRID المعطى.
- ST_LocateAlong - تُعيد النقطة (أو النقاط) على شكل هندسي التي تطابق قيمة قياس معيّنة.
- ST_LocateBetween - تُعيد أجزاء الشكل الهندسي التي تطابق نطاق قياس معيّنًا.
- ST_M - تُعيد إحداثي M لنقطة.
- ST_MLineFromText - تُعيد قيمة ST_MultiLineString محددة من تمثيل WKT.
- ST_MPointFromText - تُنشئ geometry من WKT باستخدام SRID المعطى. وإذا لم يُعطَ SRID فقيمته الافتراضية 0.
- ST_MPolyFromText - تُنشئ geometry من نوع MultiPolygon من WKT باستخدام SRID المعطى. وإذا لم يُعطَ SRID فقيمته الافتراضية 0.
- ST_ModEdgeHeal - تدمج حافتين بحذف العقدة التي تصل بينهما، مع تعديل الحافة الأولى وحذف الحافة الثانية. تُعيد معرّف العقدة المحذوفة.
- ST_ModEdgeSplit - تقسّم حافة بإنشاء عقدة جديدة على امتداد حافة موجودة، مع تعديل الحافة الأصلية وإضافة حافة جديدة.
- ST_MoveIsoNode - تنقل عقدة معزولة في طوبولوجيا من نقطة إلى أخرى. إذا كان الشكل الهندسي apoint الجديد موجودًا كعقدة فسيُطلق خطأ. تُعيد وصفًا لعملية النقل.
- ST_NewEdgeHeal - تدمج حافتين بحذف العقدة التي تصل بينهما، وحذف الحافتين كلتيهما، واستبدالهما بحافة اتجاهها مماثل لاتجاه الحافة الأولى المعطاة.
- ST_NewEdgesSplit - تقسّم حافة بإنشاء عقدة جديدة على امتداد حافة موجودة، مع حذف الحافة الأصلية واستبدالها بحافتين جديدتين. تُعيد معرّف العقدة الجديدة المُنشأة التي تصل بين الحافتين الجديدتين.
- ST_NumCurves - تُعيد عدد المنحنيات المكوِّنة في منحنى مركّب (CompoundCurve).
- ST_NumGeometries - تُعيد عدد العناصر في مجموعة أشكال هندسية.
- ST_NumInteriorRings - تُعيد عدد الحلقات الداخلية (الثقوب) لمضلع.
- ST_NumPatches - تُعيد عدد الوجوه في سطح متعدد الوجوه. وتُعيد null للأشكال الهندسية غير متعددة الوجوه.
- ST_NumPoints - تُعيد عدد النقاط في خط (LineString) أو قوس دائري (CircularString).
- ST_OrderingEquals - تختبر ما إذا كان شكلان هندسيان يمثلان الشكل نفسه ولهما نقاط بترتيب الاتجاه نفسه
- ST_Overlaps - تختبر ما إذا كان لشكلين هندسيين البعد نفسه ويتقاطعان، مع امتلاك كل منهما نقطة واحدة على الأقل ليست في الآخر
- ST_PatchN - تُعيد الشكل الهندسي (الوجه) رقم N من سطح متعدد الوجوه (PolyhedralSurface).
- ST_Perimeter - تُعيد طول حدود شكل مضلعي من نوع geometry أو geography.
- ST_Point - تُنشئ نقطة بقيم X وY وSRID.
- ST_PointFromText - تُنشئ geometry من نوع نقطة من WKT باستخدام SRID المعطى. وإذا لم يُعطَ SRID فقيمته الافتراضية غير معروفة.
- ST_PointFromWKB - تُنشئ geometry من WKB باستخدام SRID المعطى
- ST_PointN - تُعيد النقطة رقم N في أول خط (LineString) أو خط دائري في الشكل الهندسي.
- ST_PointOnSurface - تحسب نقطة مضمونة الوقوع داخل مضلع أو على شكل هندسي.
- ST_Polygon - تُنشئ مضلعًا من خط (LineString) مع SRID محدد.
- ST_PolygonFromText - تُنشئ geometry من WKT باستخدام SRID المعطى. وإذا لم يُعطَ SRID فقيمته الافتراضية 0.
- ST_Relate - تختبر ما إذا كان لشكلين هندسيين علاقة طوبولوجية تطابق نمط مصفوفة تقاطع، أو تحسب مصفوفة التقاطع الخاصة بهما
- ST_RemEdgeModFace - تزيل حافة، وإذا كانت الحافة تفصل بين وجهين، تحذف أحد الوجهين وتعدّل الوجه الآخر ليغطي مساحة كليهما.
- ST_RemEdgeNewFace - تزيل حافة، وإذا كانت الحافة المزالة تفصل بين وجهين، تحذف الوجهين الأصليين وتستبدلهما بوجه جديد.
- ST_RemoveIsoEdge - تزيل حافة معزولة وتُعيد وصفًا للإجراء. إذا لم تكن الحافة معزولة، فسيُطلق استثناء.
- ST_RemoveIsoNode - تزيل عقدة معزولة وتُعيد وصفًا للإجراء. إذا لم تكن العقدة معزولة (أي كانت بداية حافة أو نهايتها)، فسيُطلق استثناء.
- ST_SRID - تُعيد معرّف النظام المرجعي المكاني لشكل هندسي.
- ST_StartPoint - تُعيد النقطة الأولى من خط (LineString).
- ST_SymDifference - تحسب شكلاً هندسياً يمثّل أجزاء الشكلين A وB التي لا تتقاطع.
- ST_Touches - تختبر ما إذا كان لشكلين هندسيين نقطة مشتركة واحدة على الأقل، دون أن يتقاطع داخلاهما
- ST_Transform - تُعيد شكلًا هندسيًا جديدًا بإحداثيات محوّلة إلى نظام مرجعي مكاني مختلف.
- ST_Union - تحسب شكلاً هندسياً يمثّل اتحاد مجموعات نقاط الأشكال المُدخلة.
- ST_Volume - تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- ST_WKBToSQL - تُعيد قيمة ST_Geometry محددة من تمثيل الثنائي المعروف (WKB). هذه الدالة اسم بديل لـ ST_GeomFromWKB لا يأخذ srid
- ST_WKTToSQL - تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف (WKT). هذه الدالة اسم بديل لـ ST_GeomFromText
- ST_Within - تختبر ما إذا كانت كل نقطة من A تقع في B، وكان لداخليهما نقطة مشتركة
- ST_X - تُعيد إحداثي X لنقطة.
- ST_Y - تُعيد إحداثي Y لنقطة.
- ST_Z - تُعيد إحداثي Z لنقطة.
- ST_SRID - تُعيد معرّف النظام المرجعي المكاني لكائن TopoGeometry.
13.4. دوال PostGIS الداعمة لنوع geography
الدوال والمعاملات الواردة أدناه دوال/معاملات PostGIS تأخذ كمُدخل أو تُعيد كمُخرج كائنًا من نوع البيانات geography.
|
|
|
الدوال المميزة بـ (T) ليست دوال جيوديسية أصلية، بل تستخدم استدعاء ST_Transform للتحويل من geometry وإليه لإجراء العملية. ونتيجة لذلك، قد لا تتصرف كما هو متوقع عند عبور خط التاريخ الدولي أو القطبين، ومع الأشكال الهندسية الكبيرة أو أزواج الأشكال الهندسية التي تغطي أكثر من نطاق UTM واحد. التحويل الأساسي - (يفضّل UTM، ثم Lambert Azimuthal (شمالي/جنوبي)، ويلجأ إلى ميركاتور في أسوأ الحالات) |
- ST_Area - تُعيد مساحة شكل هندسي مضلعي.
- ST_AsBinary - تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsEWKT - تُعيد تمثيل النص المعروف (WKT) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsGML - تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsGeoJSON - تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_AsKML - تُعيد الشكل الهندسي كعنصر KML.
- ST_AsSVG - تُعيد بيانات مسار SVG لشكل هندسي.
- ST_AsText - تُعيد تمثيل النص المعروف (WKT) لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_Azimuth - تُعيد السمت المرجعي إلى الشمال لخط بين نقطتين.
- ST_Buffer - تحسب شكلاً هندسياً يغطي جميع النقاط الواقعة ضمن مسافة معيّنة من شكل هندسي.
- ST_Centroid - تُعيد المركز الهندسي لشكل هندسي.
- ST_ClosestPoint - تُعيد النقطة ثنائية الأبعاد على g1 الأقرب إلى g2. وهي النقطة الأولى من أقصر خط من أحد الشكلين إلى الآخر.
- ST_CoveredBy - تختبر ما إذا كانت كل نقطة من A تقع في B
- ST_Covers - تختبر ما إذا كانت كل نقطة من B تقع في A
- ST_DWithin - تختبر ما إذا كان شكلان هندسيان ضمن مسافة معيّنة
- ST_Distance - تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_GeogFromText - تُعيد قيمة geography محددة من تمثيل النص المعروف (WKT) أو الموسّع.
- ST_GeogFromWKB - تُنشئ نسخة geography من تمثيل geometry بصيغة الثنائي المعروف (WKB) أو الثنائي المعروف الموسّع (EWKB).
- ST_GeographyFromText - تُعيد قيمة geography محددة من تمثيل النص المعروف (WKT) أو الموسّع.
- = - تُعيد TRUE إذا كانت إحداثيات geometry/geography A وترتيبها مطابقة لإحداثيات geometry/geography B وترتيبها.
- ST_Intersection - تحسب شكلاً هندسياً يمثّل الجزء المشترك بين الشكلين A وB.
- ST_Intersects - تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- ST_Length - تُعيد الطول ثنائي الأبعاد لشكل هندسي خطي.
- ST_LineInterpolatePoint - تُعيد نقطة مُستكمَلة على امتداد خط عند موقع كسري.
- ST_LineInterpolatePoints - تُعيد نقاطًا مُستكمَلة على امتداد خط عند فاصل كسري.
- ST_LineLocatePoint - تُعيد الموقع الكسري لأقرب نقطة على خط إلى نقطة.
- ST_LineSubstring - تُعيد جزء الخط الواقع بين موقعين كسريين.
- ST_Perimeter - تُعيد طول حدود شكل مضلعي من نوع geometry أو geography.
- ST_Project - تُعيد نقطة مُسقطة من نقطة بداية بمسافة واتجاه (سمت).
- ST_Segmentize - تُعيد geometry/geography معدّلًا لا تزيد فيه أي قطعة عن مسافة مُعطاة.
- ST_ShortestLine - تُعيد أقصر خط ثنائي الأبعاد بين شكلين هندسيين
- ST_Summary - تُعيد ملخصًا نصيًا لمحتويات الشكل الهندسي.
- <-> - تُعيد المسافة ثنائية الأبعاد بين A وB.
- && - تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد لـ A مع المستطيل المحيط ثنائي الأبعاد لـ B.
13.5. دوال PostGIS الداعمة للرستر
الدوال والمعاملات الواردة أدناه دوال/معاملات PostGIS تأخذ كمُدخل أو تُعيد كمُخرج كائنًا من نوع البيانات raster. مرتبة أبجديًا.
- Box3D - تُعيد تمثيل box3d للصندوق المحيط بالرستر.
- @ - تُعيد TRUE إذا كان المستطيل المحيط بـ A محتوى داخل المستطيل المحيط بـ B. تستخدم مستطيلًا محيطًا بدقة مضاعفة (double precision).
- ~ - تُعيد TRUE إذا كان المستطيل المحيط بـ A يحتوي المستطيل المحيط بـ B. تستخدم مستطيلًا محيطًا بدقة مضاعفة (double precision).
- = - تُعيد TRUE إذا كان المستطيل المحيط بـ A مطابقًا للمستطيل المحيط بـ B. تستخدم مستطيلًا محيطًا بدقة مضاعفة (double precision).
- && - تُعيد TRUE إذا كان المستطيل المحيط بـ A يتقاطع مع المستطيل المحيط بـ B.
- &< - تُعيد TRUE إذا كان المستطيل المحيط بـ A يقع إلى يسار المستطيل المحيط بـ B.
- &> - تُعيد TRUE إذا كان المستطيل المحيط بـ A يقع إلى يمين المستطيل المحيط بـ B.
- ~= - تُعيد TRUE إذا كان المستطيل المحيط لـ A مطابقًا للمستطيل المحيط لـ B.
- ST_Retile - تُعيد مجموعة من البلاطات المُهيّأة من تغطية رستر مقسّمة إلى بلاطات بشكل عشوائي.
- ST_AddBand - تُعيد رسترًا أُضيف إليه نطاق (أو نطاقات) جديد من النوع المحدد بالقيمة الأولية المحددة في موضع الفهرس المحدد. إذا لم يُحدَّد فهرس، يُضاف النطاق في النهاية.
- ST_AsBinary/ST_AsWKB - تُعيد تمثيل Well-Known Binary (WKB) للرستر.
- ST_AsGDALRaster - تُعيد بلاطة الرستر بصيغة رستر GDAL المحددة. صيغ الرستر هي إحدى الصيغ التي تدعمها المكتبة المُترجَمة لديك. استخدم ST_GDALDrivers() للحصول على قائمة بالصيغ التي تدعمها مكتبتك.
- ST_AsHexWKB - تُعيد تمثيل Well-Known Binary (WKB) للرستر في صورة ست عشرية (Hex).
- ST_AsJPEG - تُعيد النطاقات المحددة من بلاطة الرستر كصورة واحدة بصيغة Joint Photographic Exports Group (JPEG) (مصفوفة بايتات). إذا لم يُحدَّد نطاق وكان هناك نطاق واحد أو أكثر من 3 نطاقات، فيُستخدم النطاق الأول فقط. وإذا كانت هناك 3 نطاقات فقط فتُستخدم النطاقات الثلاثة جميعًا وتُربط بـ RGB.
- ST_AsPNG - تُعيد النطاقات المحددة من بلاطة الرستر كصورة واحدة بصيغة Portable Network Graphics (PNG) (مصفوفة بايتات). إذا كان في الرستر 1 أو 3 أو 4 نطاقات ولم تُحدَّد نطاقات، فتُستخدم جميع النطاقات. وإذا كان هناك نطاقان أو أكثر من 4 نطاقات ولم تُحدَّد نطاقات، فيُستخدم النطاق 1 فقط. تُربط النطاقات بفضاء RGB أو RGBA.
- ST_AsRaster - تحوّل شكلًا هندسيًا (geometry) في PostGIS إلى رستر PostGIS.
- ST_AsRasterAgg - دالة تجميعية. ترسم الأشكال الهندسية في PostGIS في رستر جديد.
- ST_AsTIFF - تُعيد النطاقات المحددة من الرستر كصورة TIFF واحدة (مصفوفة بايتات). إذا لم يُحدَّد نطاق أو كان أي من النطاقات المحددة غير موجود في الرستر، فستحاول استخدام جميع النطاقات.
- ST_Aspect - تُعيد الاتجاه (Aspect) (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_Band - تُعيد نطاقًا أو أكثر من رستر موجود في صورة رستر جديد. مفيدة لبناء رسترات جديدة من رسترات موجودة.
- ST_BandFileSize - تُعيد حجم ملف نطاق مخزّن في نظام الملفات. إذا لم يُحدَّد bandnum، يُفترض 1.
- ST_BandFileTimestamp - تُعيد الطابع الزمني لملف نطاق مخزّن في نظام الملفات. إذا لم يُحدَّد bandnum، يُفترض 1.
- ST_BandIsNoData - تُعيد true إذا كان النطاق ممتلئًا بقيم nodata فقط.
- ST_BandMetaData - تُعيد البيانات الوصفية الأساسية لنطاق رستر محدد. يُفترض النطاق رقم 1 إذا لم يُحدَّد.
- ST_BandNoDataValue - تُعيد القيمة التي تمثّل انعدام البيانات (no data) في نطاق معيّن. إذا لم يُحدَّد نطاق يُفترض الرقم 1.
- ST_BandPath - تُعيد مسار الملف في النظام لنطاق مخزّن في نظام الملفات. إذا لم يُحدَّد bandnum، يُفترض 1.
- ST_BandPixelType - تُعيد نوع البكسل للنطاق المحدد. إذا لم يُحدَّد bandnum، يُفترض 1.
- ST_Clip - تُعيد الرستر مقصوصًا بالشكل الهندسي المُدخل. إذا لم يُحدَّد رقم النطاق، فتُعالَج جميع النطاقات. إذا لم يُحدَّد crop أو كان TRUE، فيُقتطع الرستر الناتج. إذا ضُبط touched على TRUE، فتُضمَّن البكسلات الملامِسة، وإلا فلا يُضمَّن البكسل إلا إذا وقع مركزه داخل الشكل الهندسي.
- ST_ColorMap - تُنشئ رسترًا جديدًا يضم حتى أربعة نطاقات من نوع 8BUI (تدرّج رمادي، RGB، RGBA) من الرستر المصدر ونطاق محدد. يُفترض النطاق 1 إذا لم يُحدَّد.
- ST_Contains - تُعيد true إذا لم تقع أي نقطة من الرستر rastB خارج الرستر rastA، ووقعت نقطة واحدة على الأقل من داخل rastB في داخل rastA.
- ST_ContainsProperly - تُعيد true إذا كان rastB يتقاطع مع داخل rastA وليس مع حدوده أو خارجه.
- ST_Contour - تولّد مجموعة من خطوط الكنتور المتجهية من نطاق الرستر المُعطى، باستخدام خوارزمية الكنتور في GDAL.
- ST_ConvexHull - تُعيد الشكل الهندسي للغلاف المحدب للرستر بما في ذلك البكسلات ذات القيم المساوية لـ BandNoDataValue. بالنسبة للرسترات منتظمة الشكل وغير المائلة، يعطي هذا النتيجة نفسها التي تعطيها ST_Envelope، لذا فهو مفيد فقط للرسترات غير منتظمة الشكل أو المائلة.
- ST_Count - تُعيد عدد البكسلات في نطاق معيّن من رستر أو تغطية رستر. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. إذا ضُبط exclude_nodata_value على true، فستُعدّ فقط البكسلات غير المساوية لقيمة nodata.
- ST_CountAgg - دالة تجميعية. تُعيد عدد البكسلات في نطاق معيّن من مجموعة رسترات. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. إذا ضُبط exclude_nodata_value على true، فستُعدّ فقط البكسلات غير المساوية لقيمة NODATA.
- ST_CoveredBy - تُعيد true إذا لم تقع أي نقطة من الرستر rastA خارج الرستر rastB.
- ST_Covers - تُعيد true إذا لم تقع أي نقطة من الرستر rastB خارج الرستر rastA.
- ST_DFullyWithin - تُعيد true إذا كان الرستران rastA وrastB ضمن المسافة المحددة أحدهما من الآخر بالكامل.
- ST_DWithin - تُعيد true إذا كان الرستران rastA وrastB ضمن المسافة المحددة أحدهما من الآخر.
- ST_Disjoint - تُعيد true إذا كان الرستر rastA لا يتقاطع مكانيًا مع rastB.
- ST_DumpAsPolygons - تُعيد مجموعة من صفوف geomval (geom,val) من نطاق رستر مُعطى. إذا لم يُحدَّد رقم النطاق، فالقيمة الافتراضية لرقم النطاق هي 1.
- ST_DumpValues - تحصل على قيم النطاق المحدد في صورة مصفوفة ثنائية الأبعاد.
- ST_Envelope - تُعيد التمثيل المضلعي لامتداد الرستر.
- ST_FromGDALRaster - تُعيد رسترًا من ملف رستر مدعوم في GDAL.
- ST_GeoReference - تُعيد البيانات الوصفية للإسناد الجغرافي بصيغة GDAL أو ESRI كما تظهر عادةً في ملف العالم (world file). القيمة الافتراضية GDAL.
- ST_Grayscale - تُنشئ رسترًا جديدًا بنطاق 8BUI واحد من الرستر المصدر والنطاقات المحددة التي تمثل الأحمر والأخضر والأزرق
- ST_HasNoBand - تُعيد true إذا لم يوجد نطاق برقم النطاق المحدد. إذا لم يُحدَّد رقم نطاق، يُفترض رقم النطاق 1.
- ST_Height - تُعيد ارتفاع الرستر بالبكسل.
- ST_HillShade - تُعيد الإضاءة الافتراضية لنطاق رستر ارتفاعات باستخدام مُدخلات السمت والارتفاع والسطوع والمقياس المُعطاة.
- ST_Histogram - تُعيد مجموعة من السجلات تلخّص توزيع بيانات رستر أو تغطية رستر على فئات (bins) منفصلة. يُحسب عدد الفئات تلقائيًا إذا لم يُحدَّد.
- ST_InterpolateRaster - تستكمل سطحًا شبكيًا استنادًا إلى مجموعة مُدخلة من النقاط ثلاثية الأبعاد، مستخدمةً قيم X وY لتحديد مواضع النقاط على الشبكة وقيمة Z للنقاط بوصفها ارتفاع السطح.
- ST_Intersection - تُعيد رسترًا أو مجموعة من أزواج (شكل هندسي-قيمة بكسل) تمثل الجزء المشترك بين رسترين أو التقاطع الهندسي بين تحويل الرستر إلى متجهات وشكل هندسي.
- ST_IntersectionFractions - تحسب نسبة كل خلية رستر التي يغطيها شكل هندسي مُعطى.
- ST_Intersects - تُعيد true إذا كان الرستر rastA يتقاطع مكانيًا مع الرستر rastB.
- ST_IsEmpty - تُعيد true إذا كان الرستر فارغًا (العرض = 0 والارتفاع = 0)، وإلا تُعيد false.
- ST_MakeEmptyCoverage - تغطي منطقة مُسندة جغرافيًا بشبكة من بلاطات رستر فارغة.
- ST_MakeEmptyRaster - تُعيد رسترًا فارغًا (بلا نطاقات) بالأبعاد المحددة (العرض & الارتفاع)، وX وY للزاوية العلوية اليسرى، وحجم البكسل والدوران (scalex وscaley وskewx & skewy)، والنظام المرجعي (srid). إذا مُرّر رستر، تُعيد رسترًا جديدًا بالحجم والمحاذاة وSRID نفسها. وإذا أُغفل srid، يُضبط النظام المرجعي المكاني على غير معروف (0).
- ST_MapAlgebra (callback function version) - نسخة دالة الاستدعاء الراجع (callback) - تُعيد رسترًا بنطاق واحد انطلاقًا من رستر مُدخل واحد أو أكثر وفهارس نطاقات ودالة استدعاء راجع واحدة يحددها المستخدم.
- ST_MapAlgebraExpr - نسخة نطاق رستر واحد: تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق عملية جبرية صالحة في PostgreSQL على نطاق الرستر المُدخل وبنوع البكسل المقدَّم. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_MapAlgebraExpr - نسخة نطاقي رستر: تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق عملية جبرية صالحة في PostgreSQL على نطاقي الرسترين المُدخلين وبنوع البكسل المقدَّم. يُفترض النطاق 1 من كل رستر إذا لم تُحدَّد أرقام النطاقات. سيُحاذى الرستر الناتج (المقياس والانحراف وأركان البكسلات) على الشبكة التي يعرّفها الرستر الأول، ويتحدد امتداده بالمعامل «extenttype». يمكن أن تكون قيم «extenttype»: INTERSECTION وUNION وFIRST وSECOND.
- ST_MapAlgebraFct - نسخة النطاق الواحد - تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق دالة PostgreSQL صالحة على نطاق الرستر المُدخل وبنوع البكسل المقدَّم. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_MapAlgebraFct - نسخة النطاقين - تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق دالة PostgreSQL صالحة على نطاقي الرسترين المُدخلين وبنوع البكسل المقدَّم. يُفترض النطاق 1 إذا لم يُحدَّد نطاق. نوع الامتداد الافتراضي هو INTERSECTION إذا لم يُحدَّد.
- ST_MapAlgebraFctNgb - نسخة النطاق الواحد: جبر الخرائط بالجار الأقرب باستخدام دالة PostgreSQL يعرّفها المستخدم. تُعيد رسترًا تكون قيمه ناتج دالة مستخدم بلغة PLPGSQL تتضمن جوارًا من القيم من نطاق الرستر المُدخل.
- ST_MapAlgebra (expression version) - نسخة التعبير - تُعيد رسترًا بنطاق واحد انطلاقًا من رستر مُدخل واحد أو اثنين وفهارس نطاقات وتعبير SQL واحد أو أكثر يحدده المستخدم.
- ST_MemSize - تُعيد مقدار المساحة (بالبايت) التي يشغلها الرستر.
- ST_MetaData - تُعيد البيانات الوصفية الأساسية لكائن رستر مثل حجم البكسل، والدوران (الانحراف)، والزاوية العلوية والسفلية اليسرى، وغير ذلك.
- ST_MinConvexHull - تُعيد الشكل الهندسي للغلاف المحدب للرستر مع استبعاد بكسلات NODATA.
- ST_NearestValue - تُعيد أقرب قيمة غير NODATA لبكسل نطاق معيّن محدد بـ columnx وrowy أو بنقطة هندسية مُعبَّر عنها في نظام الإحداثيات المرجعي المكاني نفسه للرستر.
- ST_Neighborhood - تُعيد مصفوفة ثنائية الأبعاد من نوع double precision تضم القيم غير NODATA المحيطة ببكسل نطاق معيّن محدد إما بـ columnX وrowY أو بنقطة هندسية مُعبَّر عنها في نظام الإحداثيات المرجعي المكاني نفسه للرستر.
- ST_NotSameAlignmentReason - تُعيد نصًا يوضح ما إذا كانت الرسترات متحاذية، وإن لم تكن متحاذية فسبب ذلك.
- ST_NumBands - تُعيد عدد النطاقات في كائن الرستر.
- ST_Overlaps - تُعيد true إذا كان الرستران rastA وrastB يتقاطعان لكن أحدهما لا يحتوي الآخر احتواءً كاملًا.
- ST_PixelAsCentroid - تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) للمساحة التي يمثّلها بكسل.
- ST_PixelAsCentroids - تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. الشكل الهندسي النقطي هو المركز الهندسي للمساحة التي يمثّلها البكسل.
- ST_PixelAsPoint - تُعيد شكلًا هندسيًا نقطيًا للزاوية العلوية اليسرى من البكسل.
- ST_PixelAsPoints - تُعيد شكلًا هندسيًا نقطيًا لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. إحداثيات الشكل الهندسي النقطي هي إحداثيات الزاوية العلوية اليسرى من البكسل.
- ST_PixelAsPolygon - تُعيد الشكل الهندسي المضلع الذي يحدّ البكسل لصف وعمود معينين.
- ST_PixelAsPolygons - تُعيد الشكل الهندسي المضلع الذي يحدّ كل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل.
- ST_PixelHeight - تُعيد ارتفاع البكسل بالوحدات الهندسية للنظام المرجعي المكاني.
- ST_PixelOfValue - تحصل على إحداثيَّي columnx وrowy للبكسل الذي تساوي قيمته قيمة البحث.
- ST_PixelWidth - تُعيد عرض البكسل بالوحدات الهندسية للنظام المرجعي المكاني.
- ST_Polygon - تُعيد شكلًا هندسيًا من نوع multipolygon يتكوّن من اتحاد البكسلات التي لا تساوي قيمتها قيمة NODATA. إذا لم يُحدَّد رقم النطاق، فالقيمة الافتراضية لرقم النطاق هي 1.
- ST_Quantile - تحسب الكميّات (quantiles) لرستر أو لتغطية جدول رستر في سياق العينة أو المجتمع الإحصائي. وبذلك يمكن فحص ما إذا كانت قيمة ما تقع عند المئين 25% أو 50% أو 75% من الرستر.
- ST_RastFromHexWKB - تُعيد قيمة رستر من تمثيل ست عشري (Hex) لرستر بصيغة Well-Known Binary (WKB).
- ST_RastFromWKB - تُعيد قيمة رستر من رستر بصيغة Well-Known Binary (WKB).
- ST_RasterToWorldCoord - تُعيد الزاوية العلوية اليسرى للرستر في صورة X وY هندسيين (خط الطول ودائرة العرض) بمعلومية عمود وصف. يبدأ ترقيم العمود والصف من 1.
- ST_RasterToWorldCoordX - تُعيد الإحداثي الهندسي X للزاوية العلوية اليسرى لرستر وعمود وصف. يبدأ ترقيم الأعمدة والصفوف من 1.
- ST_RasterToWorldCoordY - تُعيد الإحداثي الهندسي Y للزاوية العلوية اليسرى لرستر وعمود وصف. يبدأ ترقيم الأعمدة والصفوف من 1.
- ST_Reclass - تُنشئ رسترًا جديدًا يتكون من أنواع نطاقات مُعاد تصنيفها من الأصل. nband هو النطاق المراد تغييره. إذا لم يُحدَّد nband فيُفترض أنه 1. تُعاد جميع النطاقات الأخرى دون تغيير. حالة الاستخدام: تحويل نطاق 16BUI إلى 8BUI وما إلى ذلك لتسهيل العرض بصيغ قابلة للعرض.
- ST_ReclassExact - تُنشئ رسترًا جديدًا يتكون من نطاقات مُعاد تصنيفها من الأصل، باستخدام ربط واحد لواحد (1:1) من القيم في النطاق الأصلي إلى قيم جديدة في النطاق الهدف.
- ST_Resample - تُعيد تشكيل (resample) رستر باستخدام خوارزمية إعادة تشكيل محددة، وأبعاد جديدة، وزاوية شبكة عشوائية، ومجموعة من سمات الإسناد الجغرافي للرستر معرَّفة أو مستعارة من رستر آخر.
- ST_Rescale - تُعيد تشكيل رستر بضبط مقياسه (أو حجم بكسله) فقط. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos أو Max أو Min. القيمة الافتراضية NearestNeighbor.
- ST_Resize - تغيّر حجم رستر إلى عرض/ارتفاع جديد
- ST_Reskew - تُعيد تشكيل رستر بضبط انحرافه (أو معاملات دورانه) فقط. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos. القيمة الافتراضية NearestNeighbor.
- ST_Rotation - تُعيد دوران الرستر بالراديان.
- ST_Roughness - تُعيد رسترًا يحتوي على «الخشونة» المحسوبة لنموذج ارتفاع رقمي DEM.
- ST_SRID - تُعيد مُعرّف النظام المرجعي المكاني للرستر كما هو معرَّف في الجدول spatial_ref_sys.
- ST_SameAlignment - تُعيد true إذا كان للرسترات الميل والمقياس والمرجع المكاني والإزاحة نفسها (بحيث يمكن وضع البكسلات على الشبكة نفسها دون قطع البكسلات)، وتُعيد false إذا لم تكن كذلك مع إشعار يوضح المشكلة.
- ST_ScaleX - تُعيد المركّبة X لعرض البكسل بوحدات النظام المرجعي للإحداثيات.
- ST_ScaleY - تُعيد المركّبة Y لارتفاع البكسل بوحدات النظام المرجعي للإحداثيات.
- ST_SetBandIndex - تحديث رقم النطاق الخارجي لنطاق out-db
- ST_SetBandIsNoData - تضبط علامة isnodata للنطاق على TRUE.
- ST_SetBandNoDataValue - تضبط قيمة النطاق المحدد التي تمثل غياب البيانات (nodata). يُفترض النطاق 1 إذا لم يُحدَّد نطاق. لتعليم نطاق بأنه لا يملك قيمة nodata، اضبط قيمة nodata = NULL.
- ST_SetBandPath - تحديث المسار الخارجي ورقم النطاق لنطاق مخزَّن خارج قاعدة البيانات (out-db)
- ST_SetGeoReference - تضبط معاملات الإسناد الجغرافي الستة في استدعاء واحد. يجب فصل الأعداد بمسافات بيضاء. تقبل المُدخَلات بصيغة GDAL أو ESRI. القيمة الافتراضية GDAL.
- ST_SetM - تُعيد شكلًا هندسيًا له إحداثيات X/Y نفسها للشكل الهندسي المُدخَل، مع نسخ قيم من الرستر إلى بعد القياس M باستخدام خوارزمية إعادة التشكيل المطلوبة.
- ST_SetRotation - تضبط دوران الرستر بالراديان.
- ST_SetSRID - تضبط SRID لرستر على قيمة srid عددية صحيحة معيّنة معرَّفة في الجدول spatial_ref_sys.
- ST_SetScale - تضبط حجم البكسلات في الاتجاهين X وY بوحدات النظام المرجعي للإحداثيات. عدد الوحدات لكل بكسل عرضًا/ارتفاعًا.
- ST_SetSkew - تضبط انحراف X وY للإسناد الجغرافي (أو معامل الدوران). إذا مُرّرت قيمة واحدة فقط، تضبط X وY على القيمة نفسها.
- ST_SetUpperLeft - تضبط قيمة الزاوية العلوية اليسرى من بكسل الرستر على إحداثيَّي X وY المُسقَطين.
- ST_SetValue - تُعيد الرستر المعدَّل الناتج عن ضبط قيمة نطاق معيّن في بكسل معيّن (columnx، rowy) أو في البكسلات التي تتقاطع مع شكل هندسي معيّن. يبدأ ترقيم النطاقات من 1 ويُفترض 1 إذا لم يُحدَّد.
- ST_SetValues - تُعيد الرستر المعدَّل الناتج عن ضبط قيم نطاق معيّن.
- ST_SetZ - تُعيد شكلًا هندسيًا له إحداثيات X/Y نفسها للشكل الهندسي المُدخَل، مع نسخ قيم من الرستر إلى البعد Z باستخدام خوارزمية إعادة التشكيل المطلوبة.
- ST_SkewX - تُعيد انحراف X للإسناد الجغرافي (أو معامل الدوران).
- ST_SkewY - تُعيد انحراف Y للإسناد الجغرافي (أو معامل الدوران).
- ST_Slope - تُعيد الانحدار (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_SnapToGrid - تُعيد تشكيل رستر بالتقاطه إلى شبكة. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos. القيمة الافتراضية NearestNeighbor.
- ST_Summary - تُعيد ملخصًا نصيًا لمحتويات الرستر.
- ST_SummaryStats - تُعيد summarystats المكوّنة من count وsum وmean وstddev وmin وmax لنطاق رستر معيّن من رستر أو تغطية رستر. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_SummaryStatsAgg - دالة تجميعية. تُعيد summarystats المكوّنة من count وsum وmean وstddev وmin وmax لنطاق رستر معيّن من مجموعة رسترات. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_TPI - تُعيد رسترًا يحتوي على مؤشر الموقع الطبوغرافي (TPI) المحسوب.
- ST_TRI - تُعيد رسترًا يحتوي على مؤشر وعورة التضاريس (TRI) المحسوب.
- ST_Tile - تُعيد مجموعة من الرسترات الناتجة عن تقسيم الرستر المُدخَل بناءً على الأبعاد المطلوبة للرسترات الناتجة.
- ST_Touches - تُعيد true إذا كان للرسترين rastA وrastB نقطة مشتركة واحدة على الأقل لكن داخليهما لا يتقاطعان.
- ST_Transform - تُعيد إسقاط رستر من نظام مرجعي مكاني معروف إلى نظام مرجعي مكاني معروف آخر باستخدام خوارزمية إعادة اعتيان محددة. الخيارات هي NearestNeighbor وBilinear وCubic وCubicSpline وLanczos، والافتراضي NearestNeighbor.
- ST_Union - تُعيد اتحاد مجموعة من بلاطات الرستر في رستر واحد يتكون من نطاق واحد أو أكثر.
- ST_UpperLeftX - تُعيد إحداثي X للزاوية العلوية اليسرى للرستر في النظام المرجعي المكاني المُسقَط.
- ST_UpperLeftY - تُعيد إحداثي Y للزاوية العلوية اليسرى للرستر في النظام المرجعي المكاني المُسقَط.
- ST_Value - تُعيد قيمة نطاق معيّن في بكسل معيّن (columnx، rowy) أو عند نقطة هندسية معينة. يبدأ ترقيم النطاقات من 1 ويُفترض 1 إذا لم يُحدَّد. إذا ضُبط exclude_nodata_value على false، فإن جميع البكسلات بما فيها بكسلات nodata تُعدّ متقاطعة وتُعيد قيمة. وإذا لم يُمرَّر exclude_nodata_value، فتُقرأ قيمته من البيانات الوصفية للرستر.
- ST_ValueCount - تُعيد مجموعة من السجلات تحتوي على قيمة نطاق البكسل وعدد البكسلات في نطاق معيّن من رستر (أو تغطية رستر) التي تملك مجموعة معيّنة من القيم. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. افتراضيًا لا تُعدّ البكسلات ذات قيمة nodata، وتُخرَج جميع القيم الأخرى في البكسل، وتُقرَّب قيم نطاق البكسل إلى أقرب عدد صحيح.
- ST_Width - تُعيد عرض الرستر بالبكسل.
- ST_Within - تُعيد true إذا لم تقع أي نقطة من الرستر rastA خارج الرستر rastB، ووقعت نقطة واحدة على الأقل من داخل rastA في داخل rastB.
- ST_WorldToRasterCoord - تُعيد الزاوية العلوية اليسرى في صورة عمود وصف بمعلومية X وY هندسيين (خط الطول ودائرة العرض) أو شكل هندسي نقطي مُعبَّر عنه في نظام الإحداثيات المرجعي المكاني للرستر.
- ST_WorldToRasterCoordX - تُعيد العمود في الرستر المقابل للشكل الهندسي النقطي (pt) أو لإحداثيَّي العالم X وY (xw، yw) المُمثَّلين في النظام المرجعي المكاني العالمي للرستر.
- ST_WorldToRasterCoordY - تُعيد الصف في الرستر المقابل للشكل الهندسي النقطي (pt) أو لإحداثيَّي العالم X وY (xw، yw) المُمثَّلين في النظام المرجعي المكاني العالمي للرستر.
- UpdateRasterSRID - تغيّر SRID لجميع الرسترات في العمود والجدول اللذين يحددهما المستخدم.
13.6. دوال التفريغ (Dump) في PostGIS للأنواع geometry وgeography والرستر
الدوال الواردة أدناه دوال PostGIS تأخذ كمُدخل أو تُعيد كمُخرج مجموعة من كائنات نوع البيانات geometry_dump أو geomval أو كائنًا واحدًا منها.
- ST_DumpAsPolygons - تُعيد مجموعة من صفوف geomval (geom,val) من نطاق رستر مُعطى. إذا لم يُحدَّد رقم النطاق، فالقيمة الافتراضية لرقم النطاق هي 1.
- ST_Intersection - تُعيد رسترًا أو مجموعة من أزواج (شكل هندسي-قيمة بكسل) تمثل الجزء المشترك بين رسترين أو التقاطع الهندسي بين تحويل الرستر إلى متجهات وشكل هندسي.
- ST_Dump - تُعيد مجموعة من صفوف geometry_dump لمكونات الشكل الهندسي.
- ST_DumpPoints - تُعيد مجموعة من صفوف geometry_dump للإحداثيات في الشكل الهندسي.
- ST_DumpRings - تُعيد مجموعة من صفوف geometry_dump للحلقات الخارجية والداخلية لمضلع.
- ST_DumpSegments - تُعيد مجموعة من صفوف geometry_dump للقطع المستقيمة في الشكل الهندسي.
13.7. دوال الصناديق (Box) في PostGIS
الدوال الواردة أدناه دوال PostGIS تأخذ كمُدخل أو تُعيد كمُخرج أنواع عائلة box* من الأنواع المكانية في PostGIS. تتكون عائلة أنواع box من box2d وbox3d
- Box2D - تُعيد BOX2D يمثل الامتداد ثنائي الأبعاد للشكل الهندسي.
- Box3D - تُعيد BOX3D يمثل الامتداد ثلاثي الأبعاد للشكل الهندسي.
- MakeTopologyPrecise - التقاط رؤوس الطوبولوجيا إلى شبكة الدقة.
- Box3D - تُعيد تمثيل box3d للصندوق المحيط بالرستر.
- ST_3DExtent - دالة تجميعية تُعيد المستطيل المحيط ثلاثي الأبعاد بالأشكال الهندسية.
- ST_3DMakeBox - تُنشئ BOX3D معرّفًا بنقطتين ثلاثيتي الأبعاد.
- ST_AsMVTGeom - تحوّل شكلًا هندسيًا إلى فضاء إحداثيات بلاطة MVT.
- ST_AsTWKB - تُعيد الشكل الهندسي بصيغة TWKB، أي "Tiny Well-Known Binary"
- ST_Box2dFromGeoHash - تُعيد BOX2D من سلسلة GeoHash.
- ST_ClipByBox2D - تحسب جزء الشكل الهندسي الواقع داخل مستطيل.
- ST_EstimatedExtent - تُعيد الامتداد التقديري لجدول مكاني.
- ST_Expand - تُعيد مستطيلًا محيطًا موسّعًا من مستطيل محيط آخر أو من شكل هندسي.
- ST_Extent - دالة تجميعية تُعيد المستطيل المحيط بالأشكال الهندسية.
- ST_MakeBox2D - تُنشئ BOX2D معرّفًا بنقطتين ثنائيتي الأبعاد.
- ST_RemoveIrrelevantPointsForView - تزيل النقاط غير المؤثرة في رسم عرض مستطيل محدد لشكل هندسي.
- ST_XMax - تُعيد القيمة القصوى لـ X لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_XMin - تُعيد القيمة الدنيا لـ X لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_YMax - تُعيد القيمة القصوى لـ Y لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_YMin - تُعيد القيمة الدنيا لـ Y لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_ZMax - تُعيد القيمة القصوى لـ Z لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_ZMin - تُعيد القيمة الدنيا لـ Z لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- RemoveUnusedPrimitives - تزيل العناصر الأولية للطوبولوجيا غير اللازمة لتعريف كائنات TopoGeometry الموجودة.
- ValidateTopology - تُعيد مجموعة من كائنات validatetopology_returntype تفصّل المشكلات في الطوبولوجيا.
- ValidateTopologyPrecision - تُعيد الرؤوس غير الدقيقة في الطوبولوجيا.
- ~(box2df,box2df) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي مستطيلًا محيطًا آخر ثنائي الأبعاد بدقة float (BOX2DF).
- ~(box2df,geometry) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- ~(geometry,box2df) - تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي يحتوي مستطيلًا محيطًا ثنائي الأبعاد بدقة float (GIDX).
- @(box2df,box2df) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في مستطيل محيط آخر ثنائي الأبعاد بدقة float.
- @(box2df,geometry) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- @(geometry,box2df) - تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي محتوًى في مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
- &&(box2df,box2df) - تُعيد TRUE إذا تقاطع مستطيلان محيطان ثنائيا الأبعاد بدقة float (BOX2DF) أحدهما مع الآخر.
- &&(box2df,geometry) - تُعيد TRUE إذا تقاطع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) مع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&(geometry,box2df) - تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
13.8. دوال PostGIS الداعمة للأبعاد الثلاثية
الدوال الواردة أدناه دوال PostGIS لا تُسقط قيمة Z.
- AddGeometryColumn - تضيف عمود geometry إلى جدول موجود.
- Box3D - تُعيد BOX3D يمثل الامتداد ثلاثي الأبعاد للشكل الهندسي.
- CG_3DAlphaWrapping - تحسب تغليف ألفا ثلاثي الأبعاد (Alpha-wrapping) يحيط بالشكل الهندسي إحاطة تامة.
- CG_3DArea - تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- CG_3DConvexHull - تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- CG_3DDifference - تُجري فرقًا ثلاثي الأبعاد
- CG_3DIntersection - تُجري تقاطعًا ثلاثي الأبعاد
- CG_3DRotate - تُدير شكلًا هندسيًا في الفضاء الثلاثي الأبعاد حول متجه محور.
- CG_3DScale - تغيّر مقياس شكل هندسي بمعاملات منفصلة على طول المحاور X وY وZ.
- CG_3DScaleAroundCenter - تغيّر مقياس شكل هندسي في الفضاء الثلاثي الأبعاد حول نقطة مركز محددة.
- CG_3DTranslate - تُزيح (تنقل) شكلًا هندسيًا بإزاحات معيّنة في الفضاء الثلاثي الأبعاد.
- CG_3DUnion - تُجري اتحادًا ثلاثي الأبعاد باستخدام postgis_sfcgal.
- CG_ApproximateMedialAxis - تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- CG_ConstrainedDelaunayTriangles - تُعيد تثليث ديلوني مقيّدًا حول الشكل الهندسي المُدخَل.
- CG_Extrude - تبثق (extrude) سطحًا إلى حجم مرتبط به
- CG_ForceLHR - تفرض الاتجاه LHR
- CG_IsPlanar - تتحقق مما إذا كان السطح مستويًا أم لا
- CG_IsSolid - تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- CG_MakeSolid - تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- CG_Orientation - تحدد اتجاه السطح
- CG_RotateX - تُدير شكلًا هندسيًا حول المحور X بزاوية معيّنة.
- CG_RotateY - تُدير شكلًا هندسيًا حول المحور Y بزاوية معيّنة.
- CG_RotateZ - تُدير شكلًا هندسيًا حول المحور Z بزاوية معيّنة.
- CG_Simplify - تقلّل تعقيد الشكل الهندسي مع الحفاظ على سماته الأساسية وقيم Z/M.
- CG_StraightSkeleton - تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- CG_Tesselate - تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- CG_Visibility - تحسب مضلع الرؤية من نقطة أو قطعة مستقيمة داخل شكل هندسي مضلعي
- CG_Volume - تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- DropGeometryColumn - تحذف عمود geometry من جدول مكاني.
- GeometryType - تُعيد نوع الشكل الهندسي كنص.
- ST_3DArea - تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- ST_3DClosestPoint - تُعيد النقطة ثلاثية الأبعاد على g1 الأقرب إلى g2. وهي النقطة الأولى من أقصر خط ثلاثي الأبعاد.
- ST_3DConvexHull - تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- ST_3DDFullyWithin - تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد يقعان بالكامل ضمن مسافة ثلاثية الأبعاد معيّنة
- ST_3DDWithin - تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد ضمن مسافة ثلاثية الأبعاد معيّنة
- ST_3DDifference - تُجري فرقًا ثلاثي الأبعاد
- ST_3DDistance - تُعيد أقل مسافة ديكارتية ثلاثية الأبعاد (بناءً على النظام المرجعي المكاني) بين شكلين بوحدات الإسقاط.
- ST_3DExtent - دالة تجميعية تُعيد المستطيل المحيط ثلاثي الأبعاد بالأشكال الهندسية.
- ST_3DIntersection - تُجري تقاطعًا ثلاثي الأبعاد
- ST_3DIntersects - تختبر ما إذا كان شكلان هندسيان يتقاطعان مكانيًا في الأبعاد الثلاثية - فقط للنقاط والخطوط والمضلعات والأسطح متعددة الوجوه (المساحة)
- ST_3DLength - تُعيد الطول ثلاثي الأبعاد لشكل هندسي خطي.
- ST_3DLineInterpolatePoint - تُعيد نقطة مُستكمَلة على امتداد خط ثلاثي الأبعاد عند موقع كسري.
- ST_3DLongestLine - تُعيد أطول خط ثلاثي الأبعاد بين شكلين
- ST_3DMaxDistance - تُعيد المسافة الديكارتية القصوى ثلاثية الأبعاد (بحسب النظام المرجعي المكاني) بين شكلين هندسيين بوحدات الإسقاط.
- ST_3DPerimeter - تُعيد المحيط ثلاثي الأبعاد لشكل هندسي مضلعي.
- ST_3DShortestLine - تُعيد أقصر خط ثلاثي الأبعاد بين شكلين هندسيين
- ST_3DUnion - تُجري اتحادًا ثلاثي الأبعاد.
- ST_AddMeasure - تستكمل القياسات على امتداد شكل هندسي خطي.
- ST_AddPoint - إضافة نقطة إلى خط (LineString).
- ST_Affine - تطبّق تحويلًا تآلفيًا ثلاثي الأبعاد على شكل هندسي.
- ST_ApproximateMedialAxis - تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- ST_AsBinary - تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsEWKB - تُعيد تمثيل الثنائي المعروف الموسَّع (EWKB) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsEWKT - تُعيد تمثيل النص المعروف (WKT) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsGML - تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsGeoJSON - تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_AsHEXEWKB - تُعيد شكلًا هندسيًا بصيغة HEXEWKB (كنص) باستخدام ترميز little-endian (NDR) أو big-endian (XDR).
- ST_AsKML - تُعيد الشكل الهندسي كعنصر KML.
- ST_AsX3D - تُعيد شكلًا هندسيًا بصيغة عنصر عقدة X3D xml: ISO-IEC-19776-1.2-X3DEncodings-XML
- ST_Boundary - تُعيد حدود الشكل الهندسي.
- ST_BoundingDiagonal - تُعيد قطر المستطيل المحيط بالشكل الهندسي.
- ST_CPAWithin - تختبر ما إذا كانت نقطة أقرب اقتراب بين مسارين ضمن المسافة المحددة.
- ST_ChaikinSmoothing - تُعيد نسخة منعّمة من شكل هندسي باستخدام خوارزمية Chaikin
- ST_ClosestPointOfApproach - تُعيد القياس عند نقطة أقرب اقتراب بين مسارين.
- ST_Collect - تُنشئ مجموعة أشكال GeometryCollection أو شكلًا هندسيًا متعددًا Multi* من مجموعة أشكال هندسية.
- ST_ConstrainedDelaunayTriangles - تُعيد تثليث ديلوني مقيّدًا حول الشكل الهندسي المُدخَل.
- ST_ConvexHull - تحسب الغلاف المحدب لشكل هندسي.
- ST_CoordDim - تُعيد بُعد الإحداثيات للشكل الهندسي.
- ST_CurveN - تُعيد المنحنى المكوِّن رقم N من منحنى مركّب (CompoundCurve).
- ST_CurveToLine - تحوّل شكلًا هندسيًا يحتوي على منحنيات إلى شكل خطي.
- ST_DelaunayTriangles - تُعيد تثليث ديلوناي (Delaunay) لرؤوس شكل هندسي.
- ST_Difference - تحسب شكلًا هندسيًا يمثّل جزء الشكل الهندسي A الذي لا يتقاطع مع الشكل الهندسي B.
- ST_DistanceCPA - تُعيد المسافة عند نقطة أقرب اقتراب بين مسارين.
- ST_Dump - تُعيد مجموعة من صفوف geometry_dump لمكونات الشكل الهندسي.
- ST_DumpPoints - تُعيد مجموعة من صفوف geometry_dump للإحداثيات في الشكل الهندسي.
- ST_DumpRings - تُعيد مجموعة من صفوف geometry_dump للحلقات الخارجية والداخلية لمضلع.
- ST_DumpSegments - تُعيد مجموعة من صفوف geometry_dump للقطع المستقيمة في الشكل الهندسي.
- ST_EndPoint - تُعيد النقطة الأخيرة من خط (LineString) أو خط دائري (CircularLineString).
- ST_ExteriorRing - تُعيد خطًا (LineString) يمثل الحلقة الخارجية لمضلع.
- ST_Extrude - تبثق (extrude) سطحًا إلى حجم مرتبط به
- ST_FlipCoordinates - تُعيد نسخة من الشكل الهندسي مع تبديل المحورين X وY.
- ST_Force2D - فرض "الوضع ثنائي الأبعاد" على الأشكال الهندسية.
- ST_ForceCurve - رفع الشكل الهندسي إلى نوعه المنحني، إن أمكن.
- ST_ForceLHR - تفرض الاتجاه LHR
- ST_ForcePolygonCCW - توجّه جميع الحلقات الخارجية عكس اتجاه عقارب الساعة وجميع الحلقات الداخلية مع اتجاه عقارب الساعة.
- ST_ForcePolygonCW - توجّه جميع الحلقات الخارجية مع اتجاه عقارب الساعة وجميع الحلقات الداخلية عكس اتجاه عقارب الساعة.
- ST_ForceRHR - فرض اتباع اتجاه رؤوس المضلع لقاعدة اليد اليمنى.
- ST_ForceSFS - فرض استخدام أنواع الأشكال الهندسية الواردة في SFS 1.1 فقط.
- ST_Force3D - فرض وضع XYZ على الأشكال الهندسية. وهي اسم بديل لـ ST_Force3DZ.
- ST_Force3DZ - فرض وضع XYZ على الأشكال الهندسية.
- ST_Force4D - فرض وضع XYZM على الأشكال الهندسية.
- ST_ForceCollection - تحويل الشكل الهندسي إلى GEOMETRYCOLLECTION.
- ST_GeomFromEWKB - تُعيد قيمة ST_Geometry محددة من تمثيل الثنائي المعروف الموسّع (EWKB).
- ST_GeomFromEWKT - تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف الموسّع (EWKT).
- ST_GeomFromGML - تأخذ تمثيل GML لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeomFromGeoJSON - تأخذ تمثيل GeoJSON لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeomFromKML - تأخذ تمثيل KML لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeometricMedian - تُعيد الوسيط الهندسي لـ MultiPoint.
- ST_GeometryN - تُعيد عنصرًا من مجموعة أشكال هندسية.
- ST_GeometryType - تُعيد نوع SQL-MM للشكل الهندسي كنص.
- ST_HasArc - تختبر ما إذا كان الشكل الهندسي يحتوي على قوس دائري
- ST_HasM - تتحقق مما إذا كان للشكل الهندسي بُعد M (القياس).
- ST_HasZ - تتحقق مما إذا كان للشكل الهندسي بُعد Z.
- ST_InteriorRingN - تُعيد الحلقة الداخلية (الثقب) رقم N لمضلع.
- ST_InterpolatePoint - تُعيد القياس المُستكمَل لشكل هندسي عند أقرب موقع إلى نقطة.
- ST_Intersection - تحسب شكلاً هندسياً يمثّل الجزء المشترك بين الشكلين A وB.
- ST_IsClosed - تختبر ما إذا كانت نقطتا بداية الخط (LineString) ونهايته متطابقتين. وبالنسبة إلى السطح متعدد الوجوه (PolyhedralSurface) تختبر ما إذا كان مغلقًا (حجميًا).
- ST_IsCollection - تختبر ما إذا كان الشكل الهندسي من أنواع مجموعات الأشكال الهندسية.
- ST_IsPlanar - تتحقق مما إذا كان السطح مستويًا أم لا
- ST_IsPolygonCCW - تختبر ما إذا كانت الحلقات الخارجية للمضلعات موجهة عكس اتجاه عقارب الساعة والحلقات الداخلية موجهة مع اتجاه عقارب الساعة.
- ST_IsPolygonCW - تختبر ما إذا كانت الحلقات الخارجية للمضلعات موجهة مع اتجاه عقارب الساعة والحلقات الداخلية موجهة عكس اتجاه عقارب الساعة.
- ST_IsSimple - تختبر ما إذا كان الشكل الهندسي خاليًا من نقاط التقاطع الذاتي أو التماس الذاتي.
- ST_IsSolid - تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- ST_IsValidTrajectory - تختبر ما إذا كان الشكل الهندسي مسارًا صالحًا.
- ST_LengthSpheroid - تُعيد الطول/المحيط ثنائي أو ثلاثي الأبعاد لشكل بإحداثيات خط الطول/خط العرض على شكل إهليلجي.
- ST_LineFromMultiPoint - تُنشئ خطًا (LineString) من شكل هندسي MultiPoint.
- ST_LineInterpolatePoint - تُعيد نقطة مُستكمَلة على امتداد خط عند موقع كسري.
- ST_LineInterpolatePoints - تُعيد نقاطًا مُستكمَلة على امتداد خط عند فاصل كسري.
- ST_LineSubstring - تُعيد جزء الخط الواقع بين موقعين كسريين.
- ST_LineToCurve - تحوّل شكلًا هندسيًا خطيًا إلى شكل منحنٍ.
- ST_LocateBetweenElevations - تُعيد أجزاء الشكل الهندسي الواقعة ضمن نطاق ارتفاع (Z).
- ST_M - تُعيد إحداثي M لنقطة.
- ST_MakeLine - تُنشئ خطًا (LineString) من أشكال هندسية من نوع Point أو MultiPoint أو LineString.
- ST_MakePoint - تُنشئ نقطة ثنائية الأبعاد أو ثلاثية الأبعاد (3DZ) أو رباعية الأبعاد.
- ST_MakePolygon - تُنشئ مضلعًا من غلاف خارجي وقائمة اختيارية من الثقوب.
- ST_MakeSolid - تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- ST_MakeValid - تحاول جعل شكل هندسي غير صالح صالحًا دون فقدان أي رؤوس.
- ST_MemSize - تُعيد مقدار مساحة الذاكرة التي يشغلها الشكل الهندسي.
- ST_MemUnion - دالة تجميعية تحسب اتحاد الأشكال الهندسية بطريقة موفّرة للذاكرة لكنها أبطأ
- ST_NDims - تُعيد بُعد الإحداثيات للشكل الهندسي.
- ST_NPoints - تُعيد عدد النقاط (الرؤوس) في الشكل الهندسي.
- ST_NRings - تُعيد عدد الحلقات في شكل هندسي مضلعي.
- ST_Node - تُنشئ العُقد لمجموعة من الخطوط.
- ST_NumCurves - تُعيد عدد المنحنيات المكوِّنة في منحنى مركّب (CompoundCurve).
- ST_NumGeometries - تُعيد عدد العناصر في مجموعة أشكال هندسية.
- ST_NumPatches - تُعيد عدد الوجوه في سطح متعدد الوجوه. وتُعيد null للأشكال الهندسية غير متعددة الوجوه.
- ST_Orientation - تحدد اتجاه السطح
- ST_PatchN - تُعيد الشكل الهندسي (الوجه) رقم N من سطح متعدد الوجوه (PolyhedralSurface).
- ST_PointFromWKB - تُنشئ geometry من WKB باستخدام SRID المعطى
- ST_PointN - تُعيد النقطة رقم N في أول خط (LineString) أو خط دائري في الشكل الهندسي.
- ST_PointOnSurface - تحسب نقطة مضمونة الوقوع داخل مضلع أو على شكل هندسي.
- ST_Points - تُعيد نقطة متعددة (MultiPoint) تحتوي على إحداثيات الشكل الهندسي.
- ST_Polygon - تُنشئ مضلعًا من خط (LineString) مع SRID محدد.
- ST_RemovePoint - إزالة نقطة من خط.
- ST_RemoveRepeatedPoints - تُعيد نسخة من الشكل الهندسي بعد إزالة النقاط المكررة.
- ST_Reverse - إعادة الشكل الهندسي مع عكس ترتيب رؤوسه.
- ST_Rotate - تُدير شكلًا هندسيًا حول نقطة أصل.
- ST_RotateX - تُدير شكلًا هندسيًا حول المحور X.
- ST_RotateY - تُدير شكلًا هندسيًا حول المحور Y.
- ST_RotateZ - تُدير شكلًا هندسيًا حول المحور Z.
- ST_Scale - تغيّر مقياس شكل هندسي بمعاملات معيّنة.
- ST_Scroll - تغيير نقطة بداية خط (LineString) مغلق.
- ST_SetPoint - استبدال نقطة من خط بنقطة مُعطاة.
- ST_ShiftLongitude - تُزيح إحداثيات خطوط الطول في شكل هندسي بين -180..180 و0..360.
- ST_SnapToGrid - التقاط جميع نقاط الشكل المُدخل إلى شبكة منتظمة.
- ST_StartPoint - تُعيد النقطة الأولى من خط (LineString).
- ST_StraightSkeleton - تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- ST_SwapOrdinates - تُعيد نسخة من الشكل الهندسي المُعطى مع تبديل قيم الإحداثيات المحددة.
- ST_SymDifference - تحسب شكلاً هندسياً يمثّل أجزاء الشكلين A وB التي لا تتقاطع.
- ST_Tesselate - تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- ST_TransScale - تُزيح شكلًا هندسيًا وتغيّر مقياسه بإزاحات ومعاملات معيّنة.
- ST_Translate - تُزيح شكلًا هندسيًا بإزاحات معيّنة.
- ST_UnaryUnion - تحسب اتحاد مكوّنات شكل هندسي واحد.
- ST_Union - تحسب شكلاً هندسياً يمثّل اتحاد مجموعات نقاط الأشكال المُدخلة.
- ST_Volume - تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- ST_WrapX - التفاف شكل هندسي حول قيمة X.
- ST_X - تُعيد إحداثي X لنقطة.
- ST_XMax - تُعيد القيمة القصوى لـ X لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_XMin - تُعيد القيمة الدنيا لـ X لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_Y - تُعيد إحداثي Y لنقطة.
- ST_YMax - تُعيد القيمة القصوى لـ Y لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_YMin - تُعيد القيمة الدنيا لـ Y لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_Z - تُعيد إحداثي Z لنقطة.
- ST_ZMax - تُعيد القيمة القصوى لـ Z لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_ZMin - تُعيد القيمة الدنيا لـ Z لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_Zmflag - تُعيد رمزًا يشير إلى بُعد إحداثيات ZM للشكل الهندسي.
- Equals - تُعيد true إذا كان كائنا TopoGeometry يتكوّنان من العناصر الطوبولوجية الأولية نفسها.
- Intersects - تُعيد true إذا تقاطع أي زوج من العناصر الأولية من كائني TopoGeometry.
- UpdateGeometrySRID - تحدّث SRID لجميع المعالم في عمود geometry، والبيانات الوصفية للجدول.
- &&& - تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) لـ A مع المستطيل المحيط متعدد الأبعاد لـ B.
- &&&(geometry,gidx) - تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط متعدد الأبعاد بدقة float (GIDX).
- &&&(gidx,geometry) - تُعيد TRUE إذا تقاطع مستطيل محيط متعدد الأبعاد (n-D) بدقة float (GIDX) مع المستطيل المحيط متعدد الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&&(gidx,gidx) - تُعيد TRUE إذا تقاطع مستطيلان محيطان متعددا الأبعاد (n-D) بدقة float (GIDX) أحدهما مع الآخر.
13.9. دوال PostGIS الداعمة للأشكال الهندسية المنحنية
الدوال الواردة أدناه دوال PostGIS يمكنها التعامل مع CIRCULARSTRING وCURVEPOLYGON وغيرها من أنواع الأشكال الهندسية المنحنية
- AddGeometryColumn - تضيف عمود geometry إلى جدول موجود.
- Box2D - تُعيد BOX2D يمثل الامتداد ثنائي الأبعاد للشكل الهندسي.
- Box3D - تُعيد BOX3D يمثل الامتداد ثلاثي الأبعاد للشكل الهندسي.
- DropGeometryColumn - تحذف عمود geometry من جدول مكاني.
- GeometryType - تُعيد نوع الشكل الهندسي كنص.
- PostGIS_AddBBox - إضافة المستطيل المحيط إلى الشكل الهندسي.
- PostGIS_DropBBox - حذف ذاكرة المستطيل المحيط المخبأة من الشكل الهندسي.
- PostGIS_HasBBox - تُعيد TRUE إذا كان المستطيل المحيط لهذا الشكل الهندسي مخبأً، وFALSE خلاف ذلك.
- ST_3DExtent - دالة تجميعية تُعيد المستطيل المحيط ثلاثي الأبعاد بالأشكال الهندسية.
- ST_Affine - تطبّق تحويلًا تآلفيًا ثلاثي الأبعاد على شكل هندسي.
- ST_AsBinary - تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsEWKB - تُعيد تمثيل الثنائي المعروف الموسَّع (EWKB) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsEWKT - تُعيد تمثيل النص المعروف (WKT) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsHEXEWKB - تُعيد شكلًا هندسيًا بصيغة HEXEWKB (كنص) باستخدام ترميز little-endian (NDR) أو big-endian (XDR).
- ST_AsSVG - تُعيد بيانات مسار SVG لشكل هندسي.
- ST_AsText - تُعيد تمثيل النص المعروف (WKT) لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_ClusterDBSCAN - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية DBSCAN.
- ST_ClusterWithin - دالة تجميعية تُعنقد الأشكال الهندسية حسب مسافة الفصل.
- ST_ClusterWithinWin - دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل، بالعنقدة حسب مسافة الفصل.
- ST_Collect - تُنشئ مجموعة أشكال GeometryCollection أو شكلًا هندسيًا متعددًا Multi* من مجموعة أشكال هندسية.
- ST_CoordDim - تُعيد بُعد الإحداثيات للشكل الهندسي.
- ST_CurveToLine - تحوّل شكلًا هندسيًا يحتوي على منحنيات إلى شكل خطي.
- ST_Distance - تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_Dump - تُعيد مجموعة من صفوف geometry_dump لمكونات الشكل الهندسي.
- ST_DumpPoints - تُعيد مجموعة من صفوف geometry_dump للإحداثيات في الشكل الهندسي.
- ST_EndPoint - تُعيد النقطة الأخيرة من خط (LineString) أو خط دائري (CircularLineString).
- ST_EstimatedExtent - تُعيد الامتداد التقديري لجدول مكاني.
- ST_FlipCoordinates - تُعيد نسخة من الشكل الهندسي مع تبديل المحورين X وY.
- ST_Force2D - فرض "الوضع ثنائي الأبعاد" على الأشكال الهندسية.
- ST_ForceCurve - رفع الشكل الهندسي إلى نوعه المنحني، إن أمكن.
- ST_ForceSFS - فرض استخدام أنواع الأشكال الهندسية الواردة في SFS 1.1 فقط.
- ST_Force3D - فرض وضع XYZ على الأشكال الهندسية. وهي اسم بديل لـ ST_Force3DZ.
- ST_Force3DM - فرض وضع XYM على الأشكال الهندسية.
- ST_Force3DZ - فرض وضع XYZ على الأشكال الهندسية.
- ST_Force4D - فرض وضع XYZM على الأشكال الهندسية.
- ST_ForceCollection - تحويل الشكل الهندسي إلى GEOMETRYCOLLECTION.
- ST_GeoHash - تُعيد تمثيل GeoHash للشكل الهندسي.
- ST_GeogFromWKB - تُنشئ نسخة geography من تمثيل geometry بصيغة الثنائي المعروف (WKB) أو الثنائي المعروف الموسّع (EWKB).
- ST_GeomFromEWKB - تُعيد قيمة ST_Geometry محددة من تمثيل الثنائي المعروف الموسّع (EWKB).
- ST_GeomFromEWKT - تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف الموسّع (EWKT).
- ST_GeomFromText - تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف (WKT).
- ST_GeomFromWKB - تُنشئ نسخة geometry من تمثيل geometry بصيغة الثنائي المعروف (WKB) مع SRID اختياري.
- ST_GeometryN - تُعيد عنصرًا من مجموعة أشكال هندسية.
- = - تُعيد TRUE إذا كانت إحداثيات geometry/geography A وترتيبها مطابقة لإحداثيات geometry/geography B وترتيبها.
- &<| - تُعيد TRUE إذا كان المستطيل المحيط لـ A يتداخل مع المستطيل المحيط لـ B أو يقع أسفله.
- ST_HasArc - تختبر ما إذا كان الشكل الهندسي يحتوي على قوس دائري
- ST_Intersects - تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- ST_IsClosed - تختبر ما إذا كانت نقطتا بداية الخط (LineString) ونهايته متطابقتين. وبالنسبة إلى السطح متعدد الوجوه (PolyhedralSurface) تختبر ما إذا كان مغلقًا (حجميًا).
- ST_IsCollection - تختبر ما إذا كان الشكل الهندسي من أنواع مجموعات الأشكال الهندسية.
- ST_IsEmpty - تختبر ما إذا كان الشكل الهندسي فارغًا.
- ST_LineToCurve - تحوّل شكلًا هندسيًا خطيًا إلى شكل منحنٍ.
- ST_MemSize - تُعيد مقدار مساحة الذاكرة التي يشغلها الشكل الهندسي.
- ST_NPoints - تُعيد عدد النقاط (الرؤوس) في الشكل الهندسي.
- ST_NRings - تُعيد عدد الحلقات في شكل هندسي مضلعي.
- ST_PointFromWKB - تُنشئ geometry من WKB باستخدام SRID المعطى
- ST_PointN - تُعيد النقطة رقم N في أول خط (LineString) أو خط دائري في الشكل الهندسي.
- ST_Points - تُعيد نقطة متعددة (MultiPoint) تحتوي على إحداثيات الشكل الهندسي.
- ST_Rotate - تُدير شكلًا هندسيًا حول نقطة أصل.
- ST_RotateZ - تُدير شكلًا هندسيًا حول المحور Z.
- ST_SRID - تُعيد معرّف النظام المرجعي المكاني لشكل هندسي.
- ST_Scale - تغيّر مقياس شكل هندسي بمعاملات معيّنة.
- ST_SetSRID - تعيّن SRID لشكل هندسي.
- ST_StartPoint - تُعيد النقطة الأولى من خط (LineString).
- ST_Summary - تُعيد ملخصًا نصيًا لمحتويات الشكل الهندسي.
- ST_SwapOrdinates - تُعيد نسخة من الشكل الهندسي المُعطى مع تبديل قيم الإحداثيات المحددة.
- ST_TransScale - تُزيح شكلًا هندسيًا وتغيّر مقياسه بإزاحات ومعاملات معيّنة.
- ST_Transform - تُعيد شكلًا هندسيًا جديدًا بإحداثيات محوّلة إلى نظام مرجعي مكاني مختلف.
- ST_Translate - تُزيح شكلًا هندسيًا بإزاحات معيّنة.
- ST_XMax - تُعيد القيمة القصوى لـ X لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_XMin - تُعيد القيمة الدنيا لـ X لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_YMax - تُعيد القيمة القصوى لـ Y لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_YMin - تُعيد القيمة الدنيا لـ Y لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_ZMax - تُعيد القيمة القصوى لـ Z لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_ZMin - تُعيد القيمة الدنيا لـ Z لمستطيل محيط ثنائي أو ثلاثي الأبعاد أو لشكل هندسي.
- ST_Zmflag - تُعيد رمزًا يشير إلى بُعد إحداثيات ZM للشكل الهندسي.
- UpdateGeometrySRID - تحدّث SRID لجميع المعالم في عمود geometry، والبيانات الوصفية للجدول.
- ~(box2df,box2df) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي مستطيلًا محيطًا آخر ثنائي الأبعاد بدقة float (BOX2DF).
- ~(box2df,geometry) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- ~(geometry,box2df) - تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي يحتوي مستطيلًا محيطًا ثنائي الأبعاد بدقة float (GIDX).
- && - تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد لـ A مع المستطيل المحيط ثنائي الأبعاد لـ B.
- &&& - تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) لـ A مع المستطيل المحيط متعدد الأبعاد لـ B.
- @(box2df,box2df) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في مستطيل محيط آخر ثنائي الأبعاد بدقة float.
- @(box2df,geometry) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- @(geometry,box2df) - تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي محتوًى في مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
- &&(box2df,box2df) - تُعيد TRUE إذا تقاطع مستطيلان محيطان ثنائيا الأبعاد بدقة float (BOX2DF) أحدهما مع الآخر.
- &&(box2df,geometry) - تُعيد TRUE إذا تقاطع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) مع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&(geometry,box2df) - تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
- &&&(geometry,gidx) - تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط متعدد الأبعاد بدقة float (GIDX).
- &&&(gidx,geometry) - تُعيد TRUE إذا تقاطع مستطيل محيط متعدد الأبعاد (n-D) بدقة float (GIDX) مع المستطيل المحيط متعدد الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&&(gidx,gidx) - تُعيد TRUE إذا تقاطع مستطيلان محيطان متعددا الأبعاد (n-D) بدقة float (GIDX) أحدهما مع الآخر.
13.10. دوال PostGIS الداعمة للأسطح متعددة الوجوه
الدوال الواردة أدناه دوال PostGIS يمكنها التعامل مع أشكال POLYHEDRALSURFACE وPOLYHEDRALSURFACEM
- Box2D - تُعيد BOX2D يمثل الامتداد ثنائي الأبعاد للشكل الهندسي.
- Box3D - تُعيد BOX3D يمثل الامتداد ثلاثي الأبعاد للشكل الهندسي.
- CG_3DArea - تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- CG_3DConvexHull - تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- CG_3DDifference - تُجري فرقًا ثلاثي الأبعاد
- CG_3DIntersection - تُجري تقاطعًا ثلاثي الأبعاد
- CG_3DUnion - تُجري اتحادًا ثلاثي الأبعاد باستخدام postgis_sfcgal.
- CG_ApproximateMedialAxis - تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- CG_Extrude - تبثق (extrude) سطحًا إلى حجم مرتبط به
- CG_ForceLHR - تفرض الاتجاه LHR
- CG_IsPlanar - تتحقق مما إذا كان السطح مستويًا أم لا
- CG_IsSolid - تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- CG_MakeSolid - تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- CG_StraightSkeleton - تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- CG_Tesselate - تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- CG_Visibility - تحسب مضلع الرؤية من نقطة أو قطعة مستقيمة داخل شكل هندسي مضلعي
- CG_Volume - تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- GeometryType - تُعيد نوع الشكل الهندسي كنص.
- ST_3DArea - تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- ST_3DClosestPoint - تُعيد النقطة ثلاثية الأبعاد على g1 الأقرب إلى g2. وهي النقطة الأولى من أقصر خط ثلاثي الأبعاد.
- ST_3DConvexHull - تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- ST_3DDFullyWithin - تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد يقعان بالكامل ضمن مسافة ثلاثية الأبعاد معيّنة
- ST_3DDWithin - تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد ضمن مسافة ثلاثية الأبعاد معيّنة
- ST_3DDifference - تُجري فرقًا ثلاثي الأبعاد
- ST_3DDistance - تُعيد أقل مسافة ديكارتية ثلاثية الأبعاد (بناءً على النظام المرجعي المكاني) بين شكلين بوحدات الإسقاط.
- ST_3DExtent - دالة تجميعية تُعيد المستطيل المحيط ثلاثي الأبعاد بالأشكال الهندسية.
- ST_3DIntersection - تُجري تقاطعًا ثلاثي الأبعاد
- ST_3DIntersects - تختبر ما إذا كان شكلان هندسيان يتقاطعان مكانيًا في الأبعاد الثلاثية - فقط للنقاط والخطوط والمضلعات والأسطح متعددة الوجوه (المساحة)
- ST_3DLongestLine - تُعيد أطول خط ثلاثي الأبعاد بين شكلين
- ST_3DMaxDistance - تُعيد المسافة الديكارتية القصوى ثلاثية الأبعاد (بحسب النظام المرجعي المكاني) بين شكلين هندسيين بوحدات الإسقاط.
- ST_3DShortestLine - تُعيد أقصر خط ثلاثي الأبعاد بين شكلين هندسيين
- ST_3DUnion - تُجري اتحادًا ثلاثي الأبعاد.
- ST_Affine - تطبّق تحويلًا تآلفيًا ثلاثي الأبعاد على شكل هندسي.
- ST_ApproximateMedialAxis - تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- ST_Area - تُعيد مساحة شكل هندسي مضلعي.
- ST_AsBinary - تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsEWKB - تُعيد تمثيل الثنائي المعروف الموسَّع (EWKB) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsEWKT - تُعيد تمثيل النص المعروف (WKT) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsGML - تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsX3D - تُعيد شكلًا هندسيًا بصيغة عنصر عقدة X3D xml: ISO-IEC-19776-1.2-X3DEncodings-XML
- ST_CoordDim - تُعيد بُعد الإحداثيات للشكل الهندسي.
- ST_Dimension - تُعيد البُعد الطوبولوجي للشكل الهندسي.
- ST_Dump - تُعيد مجموعة من صفوف geometry_dump لمكونات الشكل الهندسي.
- ST_DumpPoints - تُعيد مجموعة من صفوف geometry_dump للإحداثيات في الشكل الهندسي.
- ST_Expand - تُعيد مستطيلًا محيطًا موسّعًا من مستطيل محيط آخر أو من شكل هندسي.
- ST_Extent - دالة تجميعية تُعيد المستطيل المحيط بالأشكال الهندسية.
- ST_Extrude - تبثق (extrude) سطحًا إلى حجم مرتبط به
- ST_FlipCoordinates - تُعيد نسخة من الشكل الهندسي مع تبديل المحورين X وY.
- ST_Force2D - فرض "الوضع ثنائي الأبعاد" على الأشكال الهندسية.
- ST_ForceLHR - تفرض الاتجاه LHR
- ST_ForceRHR - فرض اتباع اتجاه رؤوس المضلع لقاعدة اليد اليمنى.
- ST_ForceSFS - فرض استخدام أنواع الأشكال الهندسية الواردة في SFS 1.1 فقط.
- ST_Force3D - فرض وضع XYZ على الأشكال الهندسية. وهي اسم بديل لـ ST_Force3DZ.
- ST_Force3DZ - فرض وضع XYZ على الأشكال الهندسية.
- ST_ForceCollection - تحويل الشكل الهندسي إلى GEOMETRYCOLLECTION.
- ST_GeomFromEWKB - تُعيد قيمة ST_Geometry محددة من تمثيل الثنائي المعروف الموسّع (EWKB).
- ST_GeomFromEWKT - تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف الموسّع (EWKT).
- ST_GeomFromGML - تأخذ تمثيل GML لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeometryN - تُعيد عنصرًا من مجموعة أشكال هندسية.
- ST_GeometryType - تُعيد نوع SQL-MM للشكل الهندسي كنص.
- = - تُعيد TRUE إذا كانت إحداثيات geometry/geography A وترتيبها مطابقة لإحداثيات geometry/geography B وترتيبها.
- &<| - تُعيد TRUE إذا كان المستطيل المحيط لـ A يتداخل مع المستطيل المحيط لـ B أو يقع أسفله.
- ~= - تُعيد TRUE إذا كان المستطيل المحيط لـ A مطابقًا للمستطيل المحيط لـ B.
- ST_IsClosed - تختبر ما إذا كانت نقطتا بداية الخط (LineString) ونهايته متطابقتين. وبالنسبة إلى السطح متعدد الوجوه (PolyhedralSurface) تختبر ما إذا كان مغلقًا (حجميًا).
- ST_IsPlanar - تتحقق مما إذا كان السطح مستويًا أم لا
- ST_IsSolid - تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- ST_MakeSolid - تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- ST_MemSize - تُعيد مقدار مساحة الذاكرة التي يشغلها الشكل الهندسي.
- ST_NPoints - تُعيد عدد النقاط (الرؤوس) في الشكل الهندسي.
- ST_NumGeometries - تُعيد عدد العناصر في مجموعة أشكال هندسية.
- ST_NumPatches - تُعيد عدد الوجوه في سطح متعدد الوجوه. وتُعيد null للأشكال الهندسية غير متعددة الوجوه.
- ST_PatchN - تُعيد الشكل الهندسي (الوجه) رقم N من سطح متعدد الوجوه (PolyhedralSurface).
- ST_RemoveRepeatedPoints - تُعيد نسخة من الشكل الهندسي بعد إزالة النقاط المكررة.
- ST_Reverse - إعادة الشكل الهندسي مع عكس ترتيب رؤوسه.
- ST_Rotate - تُدير شكلًا هندسيًا حول نقطة أصل.
- ST_RotateX - تُدير شكلًا هندسيًا حول المحور X.
- ST_RotateY - تُدير شكلًا هندسيًا حول المحور Y.
- ST_RotateZ - تُدير شكلًا هندسيًا حول المحور Z.
- ST_Scale - تغيّر مقياس شكل هندسي بمعاملات معيّنة.
- ST_ShiftLongitude - تُزيح إحداثيات خطوط الطول في شكل هندسي بين -180..180 و0..360.
- ST_StraightSkeleton - تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- ST_Summary - تُعيد ملخصًا نصيًا لمحتويات الشكل الهندسي.
- ST_SwapOrdinates - تُعيد نسخة من الشكل الهندسي المُعطى مع تبديل قيم الإحداثيات المحددة.
- ST_Tesselate - تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- ST_Transform - تُعيد شكلًا هندسيًا جديدًا بإحداثيات محوّلة إلى نظام مرجعي مكاني مختلف.
- ST_Volume - تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- ~(box2df,box2df) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي مستطيلًا محيطًا آخر ثنائي الأبعاد بدقة float (BOX2DF).
- ~(box2df,geometry) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- ~(geometry,box2df) - تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي يحتوي مستطيلًا محيطًا ثنائي الأبعاد بدقة float (GIDX).
- && - تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد لـ A مع المستطيل المحيط ثنائي الأبعاد لـ B.
- &&& - تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) لـ A مع المستطيل المحيط متعدد الأبعاد لـ B.
- @(box2df,box2df) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في مستطيل محيط آخر ثنائي الأبعاد بدقة float.
- @(box2df,geometry) - تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- @(geometry,box2df) - تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي محتوًى في مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
- &&(box2df,box2df) - تُعيد TRUE إذا تقاطع مستطيلان محيطان ثنائيا الأبعاد بدقة float (BOX2DF) أحدهما مع الآخر.
- &&(box2df,geometry) - تُعيد TRUE إذا تقاطع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) مع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&(geometry,box2df) - تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
- &&&(geometry,gidx) - تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط متعدد الأبعاد بدقة float (GIDX).
- &&&(gidx,geometry) - تُعيد TRUE إذا تقاطع مستطيل محيط متعدد الأبعاد (n-D) بدقة float (GIDX) مع المستطيل المحيط متعدد الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&&(gidx,gidx) - تُعيد TRUE إذا تقاطع مستطيلان محيطان متعددا الأبعاد (n-D) بدقة float (GIDX) أحدهما مع الآخر.
13.11. مصفوفة دعم دوال PostGIS
فيما يلي قائمة مرتبة أبجديًا بالدوال المكانية الخاصة في PostGIS، وأنواع البيانات المكانية التي تعمل معها، أو التوافق مع OGC/SQL الذي تسعى إلى تحقيقه.
- تعني العلامة
أن الدالة تعمل مع النوع أو النوع الفرعي بشكل أصلي. - تعني العلامة
أنها تعمل لكن مع تحويل مدمج يعتمد على التحويل إلى geometry، ثم إعادة الإسقاط إلى نظام مرجعي مكاني «بأفضل SRID»، ثم التحويل مرة أخرى. وقد لا تكون النتائج كما هو متوقع في المساحات الكبيرة أو المناطق القطبية، وقد تتراكم فيها أخطاء الفاصلة العائمة. - تعني العلامة
أن الدالة تعمل مع النوع بفضل التحويل التلقائي إلى نوع آخر مثل box3d، لا بدعم مباشر للنوع. - تعني العلامة
أن الدالة لا تتوفر إلا إذا جرى بناء PostGIS بدعم SFCGAL. - geom - الدعم الأساسي للأشكال الهندسية ثنائية الأبعاد (x,y).
- geog - الدعم الأساسي للإحداثيات الجغرافية ثنائية الأبعاد (x,y).
- 2.5D - أشكال هندسية أساسية ثنائية الأبعاد في فضاء ثلاثي/رباعي الأبعاد (لها إحداثي Z أو M).
- PS - الأسطح متعددة الوجوه
- T - المثلثات وأسطح الشبكات المثلثية غير المنتظمة (TIN)
13.12. دوال PostGIS الجديدة أو المحسّنة أو المعدّلة
- 13.12.1. دوال PostGIS الجديدة أو المحسّنة في 3.6
- 13.12.2. دوال PostGIS الجديدة أو المحسّنة في 3.5
- 13.12.3. دوال PostGIS الجديدة أو المحسّنة في 3.4
- 13.12.4. دوال PostGIS الجديدة أو المحسّنة في 3.3
- 13.12.5. دوال PostGIS الجديدة أو المحسّنة في 3.2
- 13.12.6. دوال PostGIS الجديدة أو المحسّنة في 3.1
- 13.12.7. دوال PostGIS الجديدة أو المحسّنة في 3.0
- 13.12.8. دوال PostGIS الجديدة أو المحسّنة في 2.5
- 13.12.9. دوال PostGIS الجديدة أو المحسّنة في 2.4
- 13.12.10. دوال PostGIS الجديدة أو المحسّنة في 2.3
- 13.12.11. دوال PostGIS الجديدة أو المحسّنة في 2.2
- 13.12.12. دوال PostGIS الجديدة أو المحسّنة في 2.1
- 13.12.13. دوال PostGIS الجديدة أو المحسّنة في 2.0
- 13.12.14. دوال PostGIS الجديدة أو المحسّنة في 1.5
- 13.12.15. دوال PostGIS الجديدة أو المحسّنة في 1.4
- 13.12.16. دوال PostGIS الجديدة أو المحسّنة في 1.3
13.12.1. دوال PostGIS الجديدة أو المحسّنة في 3.6
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 3.6
- CG_2DRotate - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُدير شكلًا هندسيًا بزاوية معيّنة حول نقطة محددة في الفضاء الثنائي الأبعاد.
- CG_3DAlphaWrapping - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.1.0 تحسب تغليف ألفا ثلاثي الأبعاد (Alpha-wrapping) يحيط بالشكل الهندسي إحاطة تامة.
- CG_3DBuffer - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تحسب نطاقًا عازلًا ثلاثي الأبعاد حول شكل هندسي.
- CG_3DRotate - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُدير شكلًا هندسيًا في الفضاء الثلاثي الأبعاد حول متجه محور.
- CG_3DScale - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تغيّر مقياس شكل هندسي بمعاملات منفصلة على طول المحاور X وY وZ.
- CG_3DScaleAroundCenter - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تغيّر مقياس شكل هندسي في الفضاء الثلاثي الأبعاد حول نقطة مركز محددة.
- CG_3DTranslate - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُزيح (تنقل) شكلًا هندسيًا بإزاحات معيّنة في الفضاء الثلاثي الأبعاد.
- CG_Rotate - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُدير شكلًا هندسيًا بزاوية معيّنة حول نقطة الأصل (0,0).
- CG_RotateX - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُدير شكلًا هندسيًا حول المحور X بزاوية معيّنة.
- CG_RotateY - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُدير شكلًا هندسيًا حول المحور Y بزاوية معيّنة.
- CG_RotateZ - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُدير شكلًا هندسيًا حول المحور Z بزاوية معيّنة.
- CG_Scale - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تغيّر مقياس شكل هندسي بانتظام في جميع الأبعاد بمعامل معيّن.
- CG_Simplify - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.1.0 تقلّل تعقيد الشكل الهندسي مع الحفاظ على سماته الأساسية وقيم Z/M.
- CG_StraightSkeletonPartition - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0. تحسب تقسيم الهيكل المستقيم لمضلع.
- CG_Translate - متاحة منذ: 3.6.0 - تتطلب SFCGAL >= 2.0.0 تُزيح (تنقل) شكلًا هندسيًا بإزاحات معيّنة في الفضاء الثنائي الأبعاد.
- FixCorruptTopoGeometryColumn - Availability: 3.6.1 Fixes topogeometry corruption caused by upgrade to postgis_topology 3.6.0 and higher
- MakeTopologyPrecise - متاحة منذ: 3.6.0 التقاط رؤوس الطوبولوجيا إلى شبكة الدقة.
- ST_AsRasterAgg - متاحة منذ: 3.6.0 دالة تجميعية. ترسم الأشكال الهندسية في PostGIS في رستر جديد.
- ST_CoverageClean - متاحة منذ: 3.6.0 - تتطلب GEOS >= 3.14.0 تحسب تغطية مضلعية نظيفة (متطابقة الحواف، غير متداخلة، خالية من الفجوات) انطلاقًا من مُدخل غير نظيف.
- ST_IntersectionFractions - متاحة منذ: 3.6.0 تتطلب GEOS 3.14 أو أحدث. تحسب نسبة كل خلية رستر التي يغطيها شكل هندسي مُعطى.
- ST_ReclassExact - متاحة منذ: 3.6.0 تُنشئ رسترًا جديدًا يتكون من نطاقات مُعاد تصنيفها من الأصل، باستخدام ربط واحد لواحد (1:1) من القيم في النطاق الأصلي إلى قيم جديدة في النطاق الهدف.
- TotalTopologySize - متاحة منذ: 3.6.0 إجمالي مساحة القرص التي تستخدمها الطوبولوجيا المحددة، بما في ذلك جميع الفهارس وبيانات TOAST.
- UpgradeTopology - متاحة منذ: 3.6.0 تُرقّي الطوبولوجيا المحددة لدعم المعرّفات الكبيرة (int8) للطوبولوجيا وللعناصر الأوّلية.
- ValidateTopologyPrecision - متاحة منذ: 3.6.0 تُعيد الرؤوس غير الدقيقة في الطوبولوجيا.
- postgis.gdal_cpl_debug - متاحة منذ: 3.6.0 إعداد منطقي (boolean) لتشغيل تسجيل رسائل تصحيح الأخطاء الخاصة بـ GDAL وإيقافه.
13.12.2. دوال PostGIS الجديدة أو المحسّنة في 3.5
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 3.5
- CG_3DArea - متاحة منذ: 3.5.0 تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- CG_3DConvexHull - متاحة منذ: 3.5.0 تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- CG_3DDifference - متاحة منذ: 3.5.0 تُجري فرقًا ثلاثي الأبعاد
- CG_3DDistance - متاحة منذ: 3.5.0 تحسب أقل مسافة ثلاثية الأبعاد بين شكلين هندسيين
- CG_3DIntersection - متاحة منذ: 3.5.0 تُجري تقاطعًا ثلاثي الأبعاد
- CG_3DIntersects - متاحة منذ: 3.5.0 تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد يتقاطعان
- CG_3DUnion - متاحة منذ: 3.5.0 تُجري اتحادًا ثلاثي الأبعاد باستخدام postgis_sfcgal.
- CG_AlphaShape - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.4.1. تحسب شكل ألفا (Alpha-shape) المحيط بشكل هندسي
- CG_ApproxConvexPartition - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.5.0. تحسب تقسيمًا محدبًا تقريبيًا للشكل الهندسي المضلعي
- CG_ApproximateMedialAxis - متاحة منذ: 3.5.0 تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- CG_Area - متاحة منذ: 3.5.0 تحسب مساحة الشكل الهندسي
- CG_Difference - متاحة منذ: 3.5.0 تحسب الفرق الهندسي بين شكلين هندسيين
- CG_Distance - متاحة منذ: 3.5.0 تحسب أقل مسافة بين شكلين هندسيين
- CG_Extrude - متاحة منذ: 3.5.0 تبثق (extrude) سطحًا إلى حجم مرتبط به
- CG_ExtrudeStraightSkeleton - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.5.0. البثق بالهيكل المستقيم
- CG_ForceLHR - متاحة منذ: 3.5.0 تفرض الاتجاه LHR
- CG_GreeneApproxConvexPartition - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.5.0. تحسب تقسيمًا محدبًا تقريبيًا للشكل الهندسي المضلعي
- CG_Intersection - متاحة منذ: 3.5.0 تحسب تقاطع شكلين هندسيين
- CG_Intersects - متاحة منذ: 3.5.0 تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- CG_IsPlanar - متاحة منذ: 3.5.0 تتحقق مما إذا كان السطح مستويًا أم لا
- CG_IsSolid - متاحة منذ: 3.5.0 تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- CG_MakeSolid - متاحة منذ: 3.5.0 تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- CG_MinkowskiSum - متاحة منذ: 3.5.0 تُجري جمع مينكوفسكي
- CG_OptimalAlphaShape - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.4.1. تحسب شكل ألفا المحيط بشكل هندسي باستخدام قيمة ألفا "مثلى".
- CG_OptimalConvexPartition - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.5.0. تحسب تقسيمًا محدبًا أمثل للشكل الهندسي المضلعي
- CG_Orientation - متاحة منذ: 3.5.0 تحدد اتجاه السطح
- CG_StraightSkeleton - متاحة منذ: 3.5.0 تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- CG_Tesselate - متاحة منذ: 3.5.0 تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- CG_Triangulate - متاحة منذ: 3.5.0 تُثلّث شكلًا هندسيًا مضلعيًا
- CG_Union - متاحة منذ: 3.5.0 تحسب اتحاد شكلين هندسيين
- CG_Visibility - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.5.0. تحسب مضلع الرؤية من نقطة أو قطعة مستقيمة داخل شكل هندسي مضلعي
- CG_Volume - متاحة منذ: 3.5.0 تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- CG_YMonotonePartition - متاحة منذ: 3.5.0 - تتطلب SFCGAL >= 1.5.0. تحسب تقسيمًا رتيبًا بالنسبة إلى y (y-monotone) للشكل الهندسي المضلعي
- ST_HasM - متاحة منذ: 3.5.0 تتحقق مما إذا كان للشكل الهندسي بُعد M (القياس).
- ST_HasZ - متاحة منذ: 3.5.0 تتحقق مما إذا كان للشكل الهندسي بُعد Z.
- ST_RemoveIrrelevantPointsForView - متاحة منذ: 3.5.0 تزيل النقاط غير المؤثرة في رسم عرض مستطيل محدد لشكل هندسي.
- ST_RemoveSmallParts - متاحة منذ: 3.5.0 تزيل الأجزاء الصغيرة (حلقات المضلعات أو الخطوط) من شكل هندسي.
- TopoGeo_LoadGeometry - متاحة منذ: 3.5.0 تحميل شكل هندسي إلى طوبولوجيا موجودة، مع الالتقاط والتقسيم حسب الحاجة.
الدوال المحسّنة في PostGIS 3.5
- ST_Clip - حُسّنت في: 3.5.0 - أُضيف الوسيط touched. تُعيد الرستر مقصوصًا بالشكل الهندسي المُدخل. إذا لم يُحدَّد رقم النطاق، فتُعالَج جميع النطاقات. إذا لم يُحدَّد crop أو كان TRUE، فيُقتطع الرستر الناتج. إذا ضُبط touched على TRUE، فتُضمَّن البكسلات الملامِسة، وإلا فلا يُضمَّن البكسل إلا إذا وقع مركزه داخل الشكل الهندسي.
الدوال المتغيّرة في PostGIS 3.5
- ST_AsGeoJSON - تغيّرت في: 3.5.0 السماح بتحديد العمود الذي يحتوي على معرّف المعلم تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_DFullyWithin - تغيّرت في: 3.5.0: أصبح منطق الدالة يعتمد على اختبار الاحتواء داخل نطاق عازل بدلًا من خوارزمية ST_MaxDistance. ستختلف النتائج عن الإصدارات السابقة، لكنها يُفترض أن تكون أقرب إلى توقعات المستخدم. تختبر ما إذا كان شكل هندسي يقع بالكامل ضمن مسافة معيّنة من شكل آخر
13.12.3. دوال PostGIS الجديدة أو المحسّنة في 3.4
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 3.4
- PostGIS_GEOS_Compiled_Version - متاحة منذ: 3.4.0 تُعيد رقم إصدار مكتبة GEOS التي بُني PostGIS عليها.
- PostGIS_PROJ_Compiled_Version - متاحة منذ: 3.5.0 تُعيد رقم إصدار مكتبة PROJ التي بُني PostGIS عليها.
- RenameTopoGeometryColumn - متاحة منذ: 3.4.0 تُعيد تسمية عمود topogeometry
- RenameTopology - متاحة منذ: 3.4.0 تُعيد تسمية طوبولوجيا
- ST_ClusterIntersectingWin - متاحة منذ: 3.4.0 دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل، بعنقدة الأشكال الهندسية المُدخلة في مجموعات متصلة.
- ST_ClusterWithinWin - متاحة منذ: 3.4.0 دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل، بالعنقدة حسب مسافة الفصل.
- ST_CoverageInvalidEdges - متاحة منذ: 3.4.0 دالة نافذة تحدد المواضع التي تخفق فيها المضلعات في تشكيل تغطية صالحة.
- ST_CoverageSimplify - متاحة منذ: 3.4.0 دالة نافذة تبسّط حواف تغطية مضلعية.
- ST_CoverageUnion - متاحة منذ: 3.4.0 - تتطلب GEOS >= 3.8.0 تحسب اتحاد مجموعة من المضلعات التي تشكّل تغطية بإزالة الحواف المشتركة.
- ST_InverseTransformPipeline - متاحة منذ: 3.4.0 تُعيد شكلًا هندسيًا جديدًا بإحداثيات محوّلة إلى نظام مرجعي مكاني مختلف باستخدام معكوس خط تحويل إحداثيات (pipeline) معرّف.
- ST_LargestEmptyCircle - متاحة منذ: 3.4.0. تحسب أكبر دائرة لا تتداخل مع شكل هندسي.
- ST_LineExtend - متاحة منذ: 3.4.0 تُعيد خطًا ممدَّدًا إلى الأمام والخلف بمسافات محددة.
- ST_TransformPipeline - متاحة منذ: 3.4.0 تُعيد شكلًا هندسيًا جديدًا بإحداثيات محوّلة إلى نظام مرجعي مكاني مختلف باستخدام خط تحويل إحداثيات (pipeline) معرّف.
- TopoElement - متاحة منذ: 3.4.0 تحوّل TopoGeometry إلى topoelement.
- debug_standardize_address - متاحة منذ: 3.4.0 تُعيد نصًا بتنسيق json يسرد رموز التحليل وعمليات التوحيد
- postgis_srs - متاحة منذ: 3.4.0 تُعيد سجل بيانات وصفية للجهة المرجعية وSRID المطلوبين.
- postgis_srs_all - متاحة منذ: 3.4.0 تُعيد سجلات البيانات الوصفية لكل نظام مرجعي مكاني في قاعدة بيانات Proj الأساسية.
- postgis_srs_codes - متاحة منذ: 3.4.0 تُعيد قائمة رموز الأنظمة المرجعية المكانية (SRS) المرتبطة بالجهة المرجعية المعطاة.
- postgis_srs_search - متاحة منذ: 3.4.0 تُعيد سجلات البيانات الوصفية لأنظمة الإحداثيات المُسقَطة التي تحتوي مناطق استخدامها بالكامل على معامل الحدود.
الدوال المحسّنة في PostGIS 3.4
- PostGIS_Full_Version - حُسّنت في: 3.4.0 أصبحت تتضمن إعدادات PROJ إضافية هي NETWORK_ENABLED وURL_ENDPOINT وDATABASE_PATH لموقع proj.db تُبلغ عن إصدار PostGIS الكامل ومعلومات إعدادات البناء.
- PostGIS_PROJ_Version - حُسّنت في: 3.4.0 أصبحت تتضمن NETWORK_ENABLED وURL_ENDPOINT وDATABASE_PATH لموقع proj.db تُعيد رقم إصدار مكتبة PROJ4.
- ST_AsSVG - حُسّنت في: 3.4.0 لدعم كل أنواع المنحنيات تُعيد بيانات مسار SVG لشكل هندسي.
- ST_ClosestPoint - حُسّنت في: 3.4.0 - دعم geography. تُعيد النقطة ثنائية الأبعاد على g1 الأقرب إلى g2. وهي النقطة الأولى من أقصر خط من أحد الشكلين إلى الآخر.
- ST_LineSubstring - حُسّنت في: 3.4.0 - أُضيف دعم geography. تُعيد جزء الخط الواقع بين موقعين كسريين.
- ST_Project - حُسّنت في: 3.4.0 السماح بوسائط geometry وبصيغة النقطتين التي تحذف السمت. تُعيد نقطة مُسقطة من نقطة بداية بمسافة واتجاه (سمت).
- ST_Resample - حُسّنت في: 3.4.0 أُضيف خيارا إعادة التشكيل max وmin تُعيد تشكيل (resample) رستر باستخدام خوارزمية إعادة تشكيل محددة، وأبعاد جديدة، وزاوية شبكة عشوائية، ومجموعة من سمات الإسناد الجغرافي للرستر معرَّفة أو مستعارة من رستر آخر.
- ST_Rescale - حُسّنت في: 3.4.0 أُضيف خيارا إعادة التشكيل max وmin تُعيد تشكيل رستر بضبط مقياسه (أو حجم بكسله) فقط. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos أو Max أو Min. القيمة الافتراضية NearestNeighbor.
- ST_ShortestLine - حُسّنت في: 3.4.0 - دعم geography. تُعيد أقصر خط ثنائي الأبعاد بين شكلين هندسيين
الدوال المتغيّرة في PostGIS 3.4
- PostGIS_Extensions_Upgrade - تغيّرت في: 3.4.0 بإضافة الوسيط target_version. تحزم امتدادات PostGIS (مثل postgis_raster وpostgis_topology وpostgis_sfcgal) وتُرقّيها إلى الإصدار المحدد أو إلى أحدث إصدار.
13.12.4. دوال PostGIS الجديدة أو المحسّنة في 3.3
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 3.3
- RemoveUnusedPrimitives - متاحة منذ: 3.3.0 تزيل العناصر الأولية للطوبولوجيا غير اللازمة لتعريف كائنات TopoGeometry الموجودة.
- ST_3DConvexHull - متاحة منذ: 3.3.0 تحسب الغلاف المحدب الثلاثي الأبعاد لشكل هندسي.
- ST_3DUnion - متاحة منذ: 3.3.0 أُضيف الشكل التجميعي تُجري اتحادًا ثلاثي الأبعاد.
- ST_AsMARC21 - متاحة منذ: 3.3.0 تُعيد الشكل الهندسي كسجل MARC21/XML يحتوي على حقل بيانات جغرافي (034).
- ST_GeomFromMARC21 - متاحة منذ: 3.3.0، تتطلب libxml2 2.6+ تأخذ بيانات جغرافية بصيغة MARC21/XML مدخلًا وتُعيد كائن geometry في PostGIS.
- ST_Letters - متاحة منذ: 3.3.0 تُعيد الحروف المُدخلة مرسومة شكلًا هندسيًا، مع موضع بداية افتراضي عند الأصل وارتفاع نص افتراضي قدره 100.
- ST_OptimalAlphaShape - متاحة منذ: 3.3.0 - تتطلب SFCGAL >= 1.4.1. تحسب شكل ألفا المحيط بشكل هندسي باستخدام قيمة ألفا "مثلى".
- ST_SimplifyPolygonHull - متاحة منذ: 3.3.0. تحسب غلافاً خارجياً أو داخلياً مبسّطاً يحافظ على الطوبولوجيا لشكل مضلّعي.
- ST_TriangulatePolygon - متاحة منذ: 3.3.0. تحسب تثليث ديلوناي المقيَّد للمضلعات
- postgis_sfcgal_full_version - متاحة منذ: 3.3.0 تُعيد الإصدار الكامل لـ SFCGAL المستخدم بما في ذلك إصدارا CGAL وBoost
الدوال المحسّنة في PostGIS 3.3
- ST_ConcaveHull - حُسّنت في: 3.3.0، فُعّل التنفيذ الأصلي في GEOS لإصدارات GEOS 3.11+ تحسب شكلاً هندسياً قد يكون مقعّراً يحتوي على جميع رؤوس الشكل المُدخل
- ST_LineMerge - حُسّنت في: 3.3.0 أصبحت تقبل المعامل directed. تُعيد الخطوط المتكوّنة من خياطة MultiLineString معاً.
الدوال المتغيّرة في PostGIS 3.3
- PostGIS_Extensions_Upgrade - تغيّرت في: 3.3.0 بدعم الترقية من أي إصدار من PostGIS. لا تعمل على جميع الأنظمة. تحزم امتدادات PostGIS (مثل postgis_raster وpostgis_topology وpostgis_sfcgal) وتُرقّيها إلى الإصدار المحدد أو إلى أحدث إصدار.
13.12.5. دوال PostGIS الجديدة أو المحسّنة في 3.2
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 3.2
- FindLayer - متاحة منذ: 3.2.0 تُعيد سجلًا من topology.layer بوسائل مختلفة.
- FindTopology - متاحة منذ: 3.2.0 تُعيد سجل طوبولوجيا بوسائل مختلفة.
- GetFaceContainingPoint - متاحة منذ: 3.2.0 تبحث عن الوجه الذي يحتوي نقطة.
- ST_AsFlatGeobuf - متاحة منذ: 3.2.0 تُعيد تمثيل FlatGeobuf لمجموعة من الصفوف.
- ST_Contour - متاحة منذ: 3.2.0 تولّد مجموعة من خطوط الكنتور المتجهية من نطاق الرستر المُعطى، باستخدام خوارزمية الكنتور في GDAL.
- ST_DumpSegments - متاحة منذ: 3.2.0 تُعيد مجموعة من صفوف geometry_dump للقطع المستقيمة في الشكل الهندسي.
- ST_FromFlatGeobuf - متاحة منذ: 3.2.0 تقرأ بيانات FlatGeobuf.
- ST_FromFlatGeobufToTable - متاحة منذ: 3.2.0 تُنشئ جدولًا بناءً على بنية بيانات FlatGeobuf.
- ST_InterpolateRaster - متاحة منذ: 3.2.0 تستكمل سطحًا شبكيًا استنادًا إلى مجموعة مُدخلة من النقاط ثلاثية الأبعاد، مستخدمةً قيم X وY لتحديد مواضع النقاط على الشبكة وقيمة Z للنقاط بوصفها ارتفاع السطح.
- ST_SRID - متاحة منذ: 3.2.0 تُعيد معرّف النظام المرجعي المكاني لكائن TopoGeometry.
- ST_Scroll - متاحة منذ: 3.2.0 تغيير نقطة بداية خط (LineString) مغلق.
- ST_SetM - متاحة منذ: 3.2.0 تُعيد شكلًا هندسيًا له إحداثيات X/Y نفسها للشكل الهندسي المُدخَل، مع نسخ قيم من الرستر إلى بعد القياس M باستخدام خوارزمية إعادة التشكيل المطلوبة.
- ST_SetZ - متاحة منذ: 3.2.0 تُعيد شكلًا هندسيًا له إحداثيات X/Y نفسها للشكل الهندسي المُدخَل، مع نسخ قيم من الرستر إلى البعد Z باستخدام خوارزمية إعادة التشكيل المطلوبة.
- TopoGeom_addTopoGeom - متاحة منذ: 3.2 تضيف عناصر TopoGeometry إلى تعريف TopoGeometry آخر.
- ValidateTopologyRelation - متاحة منذ: 3.2.0 تُعيد معلومات عن سجلات علاقات الطوبولوجيا غير الصالحة
- postgis.gdal_vsi_options - متاحة منذ: 3.2.0 إعداد نصي لضبط الخيارات المستخدمة عند التعامل مع رستر مخزّن خارج قاعدة البيانات (out-db).
الدوال المحسّنة في PostGIS 3.2
- GetFaceByPoint - حُسّنت في: 3.2.0 تنفيذ أكثر كفاءة وعقد استخدام أوضح، ولم تعد تعمل مع الطوبولوجيات غير الصالحة. تبحث عن الوجه الذي يتقاطع مع نقطة معطاة.
- ST_ClusterKMeans - حُسّنت في: 3.2.0 دعم max_radius دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية K-means.
- ST_MakeValid - حُسّنت في: 3.2.0، أُضيف خيارا الخوارزمية 'linework' و'structure' اللذان يتطلبان GEOS >= 3.10.0. تحاول جعل شكل هندسي غير صالح صالحًا دون فقدان أي رؤوس.
- ST_PixelAsCentroid - حُسّنت في: 3.2.0 أصبحت أسرع إذ باتت مُنفّذة بلغة C. تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) للمساحة التي يمثّلها بكسل.
- ST_PixelAsCentroids - حُسّنت في: 3.2.0 أصبحت أسرع إذ باتت مُنفّذة بلغة C. تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. الشكل الهندسي النقطي هو المركز الهندسي للمساحة التي يمثّلها البكسل.
- ST_Point - حُسّنت في: 3.2.0 أُضيف srid وسيطًا اختياريًا إضافيًا. تتطلب الإصدارات الأقدم دمجها مع ST_SetSRID لتعيين srid على الشكل الهندسي. تُنشئ نقطة بقيم X وY وSRID.
- ST_PointM - حُسّنت في: 3.2.0 أُضيف srid وسيطًا اختياريًا إضافيًا. تتطلب الإصدارات الأقدم دمجها مع ST_SetSRID لتعيين srid على الشكل الهندسي. تُنشئ نقطة بقيم X وY وM وSRID.
- ST_PointZ - حُسّنت في: 3.2.0 أُضيف srid وسيطًا اختياريًا إضافيًا. تتطلب الإصدارات الأقدم دمجها مع ST_SetSRID لتعيين srid على الشكل الهندسي. تُنشئ نقطة بقيم X وY وZ وSRID.
- ST_PointZM - حُسّنت في: 3.2.0 أُضيف srid وسيطًا اختياريًا إضافيًا. تتطلب الإصدارات الأقدم دمجها مع ST_SetSRID لتعيين srid على الشكل الهندسي. تُنشئ نقطة بقيم X وY وZ وM وSRID.
- ST_RemovePoint - حُسّنت في: 3.2.0 إزالة نقطة من خط.
- ST_RemoveRepeatedPoints - حُسّنت في: 3.2.0 تُعيد نسخة من الشكل الهندسي بعد إزالة النقاط المكررة.
- ST_StartPoint - حُسّنت في: 3.2.0 تُعيد نقطة لجميع الأشكال الهندسية. وكان السلوك السابق يُعيد NULL إذا لم يكن المُدخل خطًا. تُعيد النقطة الأولى من خط (LineString).
- ST_Value - حُسّنت في: 3.2.0 أُضيف الوسيط الاختياري resample. تُعيد قيمة نطاق معيّن في بكسل معيّن (columnx، rowy) أو عند نقطة هندسية معينة. يبدأ ترقيم النطاقات من 1 ويُفترض 1 إذا لم يُحدَّد. إذا ضُبط exclude_nodata_value على false، فإن جميع البكسلات بما فيها بكسلات nodata تُعدّ متقاطعة وتُعيد قيمة. وإذا لم يُمرَّر exclude_nodata_value، فتُقرأ قيمته من البيانات الوصفية للرستر.
- TopoGeo_AddLineString - حُسّنت في: 3.2.0 أُضيف دعم إعادة المعرّف ذي الإشارة. تضيف خطًا (LineString) إلى طوبولوجيا موجودة باستخدام تسامح، مع احتمال تقسيم حواف/أوجه موجودة.
الدوال المتغيّرة في PostGIS 3.2
- ST_Boundary - تغيّرت في: 3.2.0 دعم TIN، لا تستخدم GEOS، ولا تحوّل المنحنيات إلى خطوط تُعيد حدود الشكل الهندسي.
- ValidateTopology - تغيّرت في: 3.2.0 أُضيف الوسيط الاختياري bbox، وتُجرى فحوص تسمية الأوجه وربط الحواف. تُعيد مجموعة من كائنات validatetopology_returntype تفصّل المشكلات في الطوبولوجيا.
13.12.6. دوال PostGIS الجديدة أو المحسّنة في 3.1
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 3.1
- ST_Hexagon - متاحة منذ: 3.1.0 تُعيد سداسيًا واحدًا، باستخدام طول الحافة وإحداثي الخلية المُعطيين ضمن فضاء الشبكة السداسية.
- ST_HexagonGrid - متاحة منذ: 3.1.0 تُعيد مجموعة من السداسيات وفهارس الخلايا التي تغطي حدود الشكل الهندسي المُدخل تغطية كاملة.
- ST_MaximumInscribedCircle - متاحة منذ: 3.1.0. تحسب أكبر دائرة محتواة داخل شكل هندسي.
- ST_ReducePrecision - متاحة منذ: 3.1.0. تُعيد شكلاً هندسياً صالحاً بنقاط مقرّبة إلى تسامح شبكة.
- ST_Square - متاحة منذ: 3.1.0 تُعيد مربعًا واحدًا، باستخدام طول الحافة وإحداثي الخلية المُعطيين ضمن فضاء الشبكة المربعة.
- ST_SquareGrid - متاحة منذ: 3.1.0 تُعيد مجموعة من مربعات الشبكة وفهارس الخلايا التي تغطي حدود الشكل الهندسي المُدخل تغطية كاملة.
الدوال المحسّنة في PostGIS 3.1
- ST_AsEWKT - حُسّنت في: 3.1.0 دعم معامل الدقة الاختياري. تُعيد تمثيل النص المعروف (WKT) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_ClusterKMeans - حُسّنت في: 3.1.0 دعم الأشكال الهندسية ثلاثية الأبعاد والأوزان دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية K-means.
- ST_Difference - حُسّنت في: 3.1.0 قبول المعامل gridSize. تحسب شكلًا هندسيًا يمثّل جزء الشكل الهندسي A الذي لا يتقاطع مع الشكل الهندسي B.
- ST_Intersection - حُسّنت في: 3.1.0 أصبحت تقبل المعامل gridSize تحسب شكلاً هندسياً يمثّل الجزء المشترك بين الشكلين A وB.
- ST_MakeValid - حُسّنت في: 3.1.0، أُضيفت إزالة الإحداثيات ذات القيم NaN. تحاول جعل شكل هندسي غير صالح صالحًا دون فقدان أي رؤوس.
- ST_Subdivide - حُسّنت في: 3.1.0 قبول المعامل gridSize. تحسب تقسيماً متعامد الخطوط لشكل هندسي.
- ST_SymDifference - حُسّنت في: 3.1.0 قبول المعامل gridSize. تحسب شكلاً هندسياً يمثّل أجزاء الشكلين A وB التي لا تتقاطع.
- ST_TileEnvelope - حُسّنت في: 3.1.0 أُضيف المعامل margin. تُنشئ مضلعًا مستطيلًا في نظام Web Mercator (SRID:3857) باستخدام نظام البلاطات XYZ.
- ST_UnaryUnion - حُسّنت في: 3.1.0 قبول المعامل gridSize. تحسب اتحاد مكوّنات شكل هندسي واحد.
- ST_Union - حُسّنت في: 3.1.0 قبول المعامل gridSize. تحسب شكلاً هندسياً يمثّل اتحاد مجموعات نقاط الأشكال المُدخلة.
الدوال المتغيّرة في PostGIS 3.1
- ST_Count - تغيّرت في: 3.1.0 - أُزيلت الأشكال ST_Count(rastertable, rastercolumn, ...). استخدم بدلًا منها. تُعيد عدد البكسلات في نطاق معيّن من رستر أو تغطية رستر. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. إذا ضُبط exclude_nodata_value على true، فستُعدّ فقط البكسلات غير المساوية لقيمة nodata.
- ST_Force3D - تغيّرت في: 3.1.0. أُضيف دعم تمرير قيمة Z غير صفرية. فرض وضع XYZ على الأشكال الهندسية. وهي اسم بديل لـ ST_Force3DZ.
- ST_Force3DM - تغيّرت في: 3.1.0. أُضيف دعم تمرير قيمة M غير صفرية. فرض وضع XYM على الأشكال الهندسية.
- ST_Force3DZ - تغيّرت في: 3.1.0. أُضيف دعم تمرير قيمة Z غير صفرية. فرض وضع XYZ على الأشكال الهندسية.
- ST_Force4D - تغيّرت في: 3.1.0. أُضيف دعم تمرير قيمتي Z وM غير صفريتين. فرض وضع XYZM على الأشكال الهندسية.
- ST_Histogram - تغيّرت في: 3.1.0 أُزيل الشكل ST_Histogram(table_name, column_name). تُعيد مجموعة من السجلات تلخّص توزيع بيانات رستر أو تغطية رستر على فئات (bins) منفصلة. يُحسب عدد الفئات تلقائيًا إذا لم يُحدَّد.
- ST_Quantile - تغيّرت في: 3.1.0 أُزيل الشكل ST_Quantile(table_name, column_name). تحسب الكميّات (quantiles) لرستر أو لتغطية جدول رستر في سياق العينة أو المجتمع الإحصائي. وبذلك يمكن فحص ما إذا كانت قيمة ما تقع عند المئين 25% أو 50% أو 75% من الرستر.
- ST_SummaryStats - تغيّرت في: 3.1.0 أُزيلت الأشكال ST_SummaryStats(rastertable, rastercolumn, ...). استخدم بدلًا منها. تُعيد summarystats المكوّنة من count وsum وmean وstddev وmin وmax لنطاق رستر معيّن من رستر أو تغطية رستر. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
13.12.7. دوال PostGIS الجديدة أو المحسّنة في 3.0
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 3.0
- CG_ConstrainedDelaunayTriangles - متاحة منذ: 3.0.0 تُعيد تثليث ديلوني مقيّدًا حول الشكل الهندسي المُدخَل.
- ST_3DLineInterpolatePoint - متاحة منذ: 3.0.0 تُعيد نقطة مُستكمَلة على امتداد خط ثلاثي الأبعاد عند موقع كسري.
- ST_ConstrainedDelaunayTriangles - متاحة منذ: 3.0.0 تُعيد تثليث ديلوني مقيّدًا حول الشكل الهندسي المُدخَل.
- ST_TileEnvelope - متاحة منذ: 3.0.0 تُنشئ مضلعًا مستطيلًا في نظام Web Mercator (SRID:3857) باستخدام نظام البلاطات XYZ.
الدوال المحسّنة في PostGIS 3.0
- ST_AsMVT - حُسّنت في: 3.0 - أُضيف دعم معرّف المعلم (Feature ID). دالة تجميعية تُعيد تمثيل MVT لمجموعة من الصفوف.
- ST_Contains - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كانت كل نقطة من B تقع في A، وما إذا كان لداخليهما نقطة مشتركة
- ST_ContainsProperly - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كانت كل نقطة من B تقع في داخل A
- ST_CoveredBy - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كانت كل نقطة من A تقع في B
- ST_Covers - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كانت كل نقطة من B تقع في A
- ST_Crosses - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كان لشكلين هندسيين بعض النقاط الداخلية المشتركة، لا كلها
- ST_CurveToLine - حُسّنت في: 3.0.0 فُرض حد أدنى لعدد القطع لكل قوس مُحوَّل إلى خطي لمنع الانهيار الطوبولوجي. تحوّل شكلًا هندسيًا يحتوي على منحنيات إلى شكل خطي.
- ST_Disjoint - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كان شكلان هندسيان لا يشتركان في أي نقطة
- ST_Equals - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كان شكلان هندسيان يضمّان مجموعة النقاط نفسها
- ST_GeneratePoints - حُسّنت في: 3.0.0، أُضيف المعامل seed تُولّد نقاطاً متعددة (multipoint) من نقاط عشوائية واقعة داخل Polygon أو MultiPolygon.
- ST_GeomFromGeoJSON - حُسّنت في: 3.0.0 يكون SRID الافتراضي للشكل المُحلَّل هو 4326 ما لم يُحدَّد خلاف ذلك. تأخذ تمثيل GeoJSON لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_LocateBetween - حُسّنت في: 3.0.0 - أُضيف دعم POLYGON وTIN وTRIANGLE. تُعيد أجزاء الشكل الهندسي التي تطابق نطاق قياس معيّنًا.
- ST_LocateBetweenElevations - حُسّنت في: 3.0.0 - أُضيف دعم POLYGON وTIN وTRIANGLE. تُعيد أجزاء الشكل الهندسي الواقعة ضمن نطاق ارتفاع (Z).
- ST_Overlaps - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كان لشكلين هندسيين البعد نفسه ويتقاطعان، مع امتلاك كل منهما نقطة واحدة على الأقل ليست في الآخر
- ST_Relate - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كان لشكلين هندسيين علاقة طوبولوجية تطابق نمط مصفوفة تقاطع، أو تحسب مصفوفة التقاطع الخاصة بهما
- ST_Segmentize - حُسّنت في: 3.0.0 أصبح تقسيم geometry يُنتج قطعًا فرعية متساوية الطول تُعيد geometry/geography معدّلًا لا تزيد فيه أي قطعة عن مسافة مُعطاة.
- ST_Touches - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كان لشكلين هندسيين نقطة مشتركة واحدة على الأقل، دون أن يتقاطع داخلاهما
- ST_Within - حُسّنت في: 3.0.0 فُعّل دعم GEOMETRYCOLLECTION تختبر ما إذا كانت كل نقطة من A تقع في B، وكان لداخليهما نقطة مشتركة
الدوال المتغيّرة في PostGIS 3.0
- PostGIS_Extensions_Upgrade - تغيّرت في: 3.0.0 لإعادة حزم الامتدادات غير المحزومة ودعم postgis_raster. تحزم امتدادات PostGIS (مثل postgis_raster وpostgis_topology وpostgis_sfcgal) وتُرقّيها إلى الإصدار المحدد أو إلى أحدث إصدار.
- ST_3DDistance - تغيّرت في: 3.0.0 - أُزيلت نسخة SFCGAL تُعيد أقل مسافة ديكارتية ثلاثية الأبعاد (بناءً على النظام المرجعي المكاني) بين شكلين بوحدات الإسقاط.
- ST_3DIntersects - تغيّرت في: 3.0.0 أُزيلت الواجهة الخلفية SFCGAL، وأصبحت الواجهة الخلفية GEOS تدعم TIN. تختبر ما إذا كان شكلان هندسيان يتقاطعان مكانيًا في الأبعاد الثلاثية - فقط للنقاط والخطوط والمضلعات والأسطح متعددة الوجوه (المساحة)
- ST_Area - تغيّرت في: 3.0.0 - لم تعد تعتمد على SFCGAL. تُعيد مساحة شكل هندسي مضلعي.
- ST_AsGeoJSON - تغيّرت في: 3.0.0 دعم السجلات كمُدخلات تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_AsGeoJSON - تغيّرت في: 3.0.0 إخراج SRID إذا لم يكن EPSG:4326. تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_AsKML - تغيّرت في: 3.0.0 - أُزيلت صيغة التوقيع "ذات الإصدار" تُعيد الشكل الهندسي كعنصر KML.
- ST_Distance - تغيّرت في: 3.0.0 - لم تعد تعتمد على SFCGAL. تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_Intersection - تغيّرت في: 3.0.0 لم تعد تعتمد على SFCGAL. تحسب شكلاً هندسياً يمثّل الجزء المشترك بين الشكلين A وB.
- ST_Intersects - تغيّرت في: 3.0.0 أُزيل إصدار SFCGAL وأُضيف دعم أصلي لـ TINS ثنائية الأبعاد. تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- ST_Union - تغيّرت في: 3.0.0 لم تعد تعتمد على SFCGAL. تحسب شكلاً هندسياً يمثّل اتحاد مجموعات نقاط الأشكال المُدخلة.
13.12.8. دوال PostGIS الجديدة أو المحسّنة في 2.5
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 2.5
- PostGIS_Extensions_Upgrade - متاحة منذ: 2.5.0 تحزم امتدادات PostGIS (مثل postgis_raster وpostgis_topology وpostgis_sfcgal) وتُرقّيها إلى الإصدار المحدد أو إلى أحدث إصدار.
- ST_Angle - متاحة منذ: 2.5.0 تُعيد الزاوية بين متجهين معرّفين بـ 3 أو 4 نقاط، أو بخطين.
- ST_AsHexWKB - متاحة منذ: 2.5.0 تُعيد تمثيل Well-Known Binary (WKB) للرستر في صورة ست عشرية (Hex).
- ST_BandFileSize - متاحة منذ: 2.5.0 تُعيد حجم ملف نطاق مخزّن في نظام الملفات. إذا لم يُحدَّد bandnum، يُفترض 1.
- ST_BandFileTimestamp - متاحة منذ: 2.5.0 تُعيد الطابع الزمني لملف نطاق مخزّن في نظام الملفات. إذا لم يُحدَّد bandnum، يُفترض 1.
- ST_ChaikinSmoothing - متاحة منذ: 2.5.0 تُعيد نسخة منعّمة من شكل هندسي باستخدام خوارزمية Chaikin
- ST_FilterByM - متاحة منذ: 2.5.0 تُزيل الرؤوس بناءً على قيمة M الخاصة بها
- ST_Grayscale - متاحة منذ: 2.5.0 تُنشئ رسترًا جديدًا بنطاق 8BUI واحد من الرستر المصدر والنطاقات المحددة التي تمثل الأحمر والأخضر والأزرق
- ST_LineInterpolatePoints - متاحة منذ: 2.5.0 تُعيد نقاطًا مُستكمَلة على امتداد خط عند فاصل كسري.
- ST_OrientedEnvelope - متاحة منذ: 2.5.0. تُعيد مستطيلاً بأصغر مساحة يحتوي على شكل هندسي.
- ST_QuantizeCoordinates - متاحة منذ: 2.5.0 تعيّن البتات الأقل أهمية في الإحداثيات إلى صفر
- ST_RastFromHexWKB - متاحة منذ: 2.5.0 تُعيد قيمة رستر من تمثيل ست عشري (Hex) لرستر بصيغة Well-Known Binary (WKB).
- ST_RastFromWKB - متاحة منذ: 2.5.0 تُعيد قيمة رستر من رستر بصيغة Well-Known Binary (WKB).
- ST_SetBandIndex - متاحة منذ: 2.5.0 تحديث رقم النطاق الخارجي لنطاق out-db
- ST_SetBandPath - متاحة منذ: 2.5.0 تحديث المسار الخارجي ورقم النطاق لنطاق مخزَّن خارج قاعدة البيانات (out-db)
الدوال المحسّنة في PostGIS 2.5
- ST_AsBinary/ST_AsWKB - حُسّنت في: 2.5.0 إضافة ST_AsWKB تُعيد تمثيل Well-Known Binary (WKB) للرستر.
- ST_AsMVT - حُسّنت في: 2.5.0 - أُضيف دعم الاستعلام المتوازي. دالة تجميعية تُعيد تمثيل MVT لمجموعة من الصفوف.
- ST_AsText - حُسّنت في: 2.5 - أُضيف معامل الدقة الاختياري. تُعيد تمثيل النص المعروف (WKT) لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_BandMetaData - حُسّنت في: 2.5.0 لتتضمن outdbbandnum وfilesize وfiletimestamp للرسترات المخزّنة خارج قاعدة البيانات. تُعيد البيانات الوصفية الأساسية لنطاق رستر محدد. يُفترض النطاق رقم 1 إذا لم يُحدَّد.
- ST_Buffer - حُسّنت في: 2.5.0 - حُسّن دعم ST_Buffer لنوع geometry ليتيح تحديد جانب النطاق العازل side=both|left|right. تحسب شكلاً هندسياً يغطي جميع النقاط الواقعة ضمن مسافة معيّنة من شكل هندسي.
- ST_GeomFromGeoJSON - حُسّنت في: 2.5.0 أصبحت تقبل json وjsonb مدخلات. تأخذ تمثيل GeoJSON لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeometricMedian - حُسّنت في: 2.5.0 أُضيف دعم M بوصفها وزناً للنقاط. تُعيد الوسيط الهندسي لـ MultiPoint.
- ST_Intersects - حُسّنت في: 2.5.0 تدعم GEOMETRYCOLLECTION. تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- ST_OffsetCurve - حُسّنت في: 2.5 - أُضيف دعم GEOMETRYCOLLECTION وMULTILINESTRING تُعيد خطاً مُزاحاً على مسافة وجانب معيّنين من خط مُدخل.
- ST_Scale - حُسّنت في: 2.5.0 أُضيف دعم تغيير المقياس نسبةً إلى أصل محلي (المعامل origin). تغيّر مقياس شكل هندسي بمعاملات معيّنة.
- ST_Split - حُسّنت في: 2.5.0 أُضيف دعم تقسيم مضلع بخط متعدد. تُعيد مجموعة من الأشكال الهندسية الناتجة عن تقسيم شكل هندسي بشكل آخر.
- ST_Subdivide - حُسّنت في: 2.5.0 تُعيد استخدام النقاط الموجودة عند تقسيم المضلع، وخُفّض عدد الرؤوس من 8 إلى 5. تحسب تقسيماً متعامد الخطوط لشكل هندسي.
الدوال المتغيّرة في PostGIS 2.5
- ST_GDALDrivers - تغيّرت في: 2.5.0 - أُضيف العمودان can_read وcan_write. تُعيد قائمة بصيغ الرستر التي يدعمها PostGIS عبر GDAL. لا يمكن استخدام سوى الصيغ ذات can_write=True مع ST_AsGDALRaster
13.12.9. دوال PostGIS الجديدة أو المحسّنة في 2.4
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 2.4
- ST_AsGeobuf - متاحة منذ: 2.4.0 تُعيد تمثيل Geobuf لمجموعة من الصفوف.
- ST_AsMVT - متاحة منذ: 2.4.0 دالة تجميعية تُعيد تمثيل MVT لمجموعة من الصفوف.
- ST_AsMVTGeom - متاحة منذ: 2.4.0 تحوّل شكلًا هندسيًا إلى فضاء إحداثيات بلاطة MVT.
- ST_Centroid - متاحة منذ: 2.4.0 أُضيف دعم geography. تُعيد المركز الهندسي لشكل هندسي.
- ST_ForcePolygonCCW - متاحة منذ: 2.4.0 توجّه جميع الحلقات الخارجية عكس اتجاه عقارب الساعة وجميع الحلقات الداخلية مع اتجاه عقارب الساعة.
- ST_ForcePolygonCW - متاحة منذ: 2.4.0 توجّه جميع الحلقات الخارجية مع اتجاه عقارب الساعة وجميع الحلقات الداخلية عكس اتجاه عقارب الساعة.
- ST_FrechetDistance - متاحة منذ: 2.4.0 - تتطلب GEOS >= 3.7.0 تُعيد مسافة فريشيه (Fréchet) بين شكلين.
- ST_IsPolygonCCW - متاحة منذ: 2.4.0 تختبر ما إذا كانت الحلقات الخارجية للمضلعات موجهة عكس اتجاه عقارب الساعة والحلقات الداخلية موجهة مع اتجاه عقارب الساعة.
- ST_IsPolygonCW - متاحة منذ: 2.4.0 تختبر ما إذا كانت الحلقات الخارجية للمضلعات موجهة مع اتجاه عقارب الساعة والحلقات الداخلية موجهة عكس اتجاه عقارب الساعة.
- ST_MakeEmptyCoverage - متاحة منذ: 2.4.0 تغطي منطقة مُسندة جغرافيًا بشبكة من بلاطات رستر فارغة.
الدوال المحسّنة في PostGIS 2.4
- Loader_Generate_Nation_Script - حُسّنت في: 2.4.1 أُصلحت خطوة تحميل مناطق تبويب الرمز البريدي الخماسي (zcta5)، وعند تفعيلها تُحمَّل بيانات zcta5 كجدول واحد يُسمى zcta5_all ضمن تحميل سكربت الدولة. تولّد سكربت shell للمنصة المحددة يحمّل جداول البحث الخاصة بالمقاطعات والولايات.
- Normalize_Address - حُسّنت في: 2.4.0 يتضمن كائن norm_addy الحقلين الإضافيين zip4 وaddress_alphanumeric. تُعيد، بإعطائها عنوان شارع نصيًا، نوعًا مركبًا norm_addy تكون فيه لاحقة الطريق وبادئته ونوعه موحّدة، ويُقسَّم فيه الشارع واسم الشارع وغيرها إلى حقول منفصلة. تعمل هذه الدالة باستخدام بيانات البحث المرفقة مع tiger_geocoder فقط (دون الحاجة إلى بيانات تعداد tiger).
- Pagc_Normalize_Address - حُسّنت في: 2.4.0 يتضمن كائن norm_addy الحقلين الإضافيين zip4 وaddress_alphanumeric. تُعيد، بإعطائها عنوان شارع نصيًا، نوعًا مركبًا norm_addy تكون فيه لاحقة الطريق وبادئته ونوعه موحّدة، ويُقسَّم فيه الشارع واسم الشارع وغيرها إلى حقول منفصلة. تعمل هذه الدالة باستخدام بيانات البحث المرفقة مع tiger_geocoder فقط (دون الحاجة إلى بيانات تعداد tiger). تتطلب الامتداد address_standardizer.
- Reverse_Geocode - حُسّنت في: 2.4.1 إذا حُمّلت مجموعة البيانات الاختيارية zcta5، يمكن للدالة reverse_geocode تحديد الولاية والرمز البريدي حتى لو لم تُحمَّل بيانات الولاية المحددة. راجع للاطلاع على تفاصيل تحميل بيانات zcta5. تأخذ نقطة geometry في نظام مرجعي مكاني معروف وتُعيد سجلًا يحتوي على مصفوفة من العناوين الممكنة نظريًا ومصفوفة من الشوارع المتقاطعة. إذا كانت include_strnum_range = true فإنها تُدرج نطاق أرقام الشارع في الشوارع المتقاطعة.
- ST_AsTWKB - حُسّنت في: 2.4.0 تحسينات في الذاكرة والسرعة. تُعيد الشكل الهندسي بصيغة TWKB، أي "Tiny Well-Known Binary"
- ST_Covers - حُسّنت في: 2.4.0 أُضيف دعم مضلع داخل مضلع وخط داخل مضلع لنوع geography تختبر ما إذا كانت كل نقطة من B تقع في A
- ST_CurveToLine - حُسّنت في: 2.4.0 أُضيف دعم تسامح الحد الأقصى للانحراف والحد الأقصى للزاوية، ودعم الإخراج المتماثل. تحوّل شكلًا هندسيًا يحتوي على منحنيات إلى شكل خطي.
- ST_Project - حُسّنت في: 2.4.0 السماح بالمسافة السالبة والسمت غير المعيَّر. تُعيد نقطة مُسقطة من نقطة بداية بمسافة واتجاه (سمت).
- ST_Reverse - حُسّنت في: 2.4.0 أُضيف دعم المنحنيات. إعادة الشكل الهندسي مع عكس ترتيب رؤوسه.
الدوال المتغيّرة في PostGIS 2.4
- = - تغيّرت في: 2.4.0، في الإصدارات السابقة كان هذا اختبار تساوي المستطيلات المحيطة لا التساوي الهندسي. إذا احتجت إلى تساوي المستطيلات المحيطة، فاستخدم بدلًا منه. تُعيد TRUE إذا كانت إحداثيات geometry/geography A وترتيبها مطابقة لإحداثيات geometry/geography B وترتيبها.
- ST_Node - تغيّرت في: 2.4.0 تستخدم هذه الدالة GEOSNode داخلياً بدلاً من GEOSUnaryUnion. وقد يؤدي ذلك إلى اختلاف ترتيب الخطوط الناتجة واتجاهها مقارنة بإصدارات PostGIS < 2.4. تُنشئ العُقد لمجموعة من الخطوط.
13.12.10. دوال PostGIS الجديدة أو المحسّنة في 2.3
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 2.3
- &&&(geometry,gidx) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط متعدد الأبعاد بدقة float (GIDX).
- &&&(gidx,geometry) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا تقاطع مستطيل محيط متعدد الأبعاد (n-D) بدقة float (GIDX) مع المستطيل المحيط متعدد الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&&(gidx,gidx) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا تقاطع مستطيلان محيطان متعددا الأبعاد (n-D) بدقة float (GIDX) أحدهما مع الآخر.
- &&(box2df,box2df) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا تقاطع مستطيلان محيطان ثنائيا الأبعاد بدقة float (BOX2DF) أحدهما مع الآخر.
- &&(box2df,geometry) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا تقاطع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) مع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي.
- &&(geometry,box2df) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد (المخزَّن مؤقتًا) لشكل هندسي مع مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
- @(box2df,box2df) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في مستطيل محيط آخر ثنائي الأبعاد بدقة float.
- @(box2df,geometry) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) محتوًى في المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- @(geometry,box2df) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي محتوًى في مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF).
- Populate_Topology_Layer - متاحة منذ: 2.3.0 تضيف الإدخالات المفقودة إلى الجدول topology.layer بقراءة البيانات الوصفية من جداول الطوبولوجيا.
- ST_ClusterDBSCAN - متاحة منذ: 2.3.0 دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية DBSCAN.
- ST_ClusterKMeans - متاحة منذ: 2.3.0 دالة نافذة تُعيد معرّف عنقود لكل شكل هندسي مُدخل باستخدام خوارزمية K-means.
- ST_GeneratePoints - متاحة منذ: 2.3.0 تُولّد نقاطاً متعددة (multipoint) من نقاط عشوائية واقعة داخل Polygon أو MultiPolygon.
- ST_GeometricMedian - متاحة منذ: 2.3.0 تُعيد الوسيط الهندسي لـ MultiPoint.
- ST_MakeLine - متاحة منذ: 2.3.0 - أُضيف دعم عناصر الإدخال من نوع MultiPoint تُنشئ خطًا (LineString) من أشكال هندسية من نوع Point أو MultiPoint أو LineString.
- ST_MinimumBoundingRadius - متاحة منذ - 2.3.0 تُعيد النقطة المركزية ونصف القطر لأصغر دائرة تحتوي على شكل هندسي.
- ST_MinimumClearance - متاحة منذ: 2.3.0 تُعيد الخلوص الأدنى (minimum clearance) لشكل هندسي، وهو مقياس لمتانة الشكل الهندسي.
- ST_MinimumClearanceLine - متاحة منذ: 2.3.0 - تتطلب GEOS >= 3.6.0 تُعيد خطًا (LineString) من نقطتين يمتد عبر الخلوص الأدنى للشكل الهندسي.
- ST_Normalize - متاحة منذ: 2.3.0 إعادة الشكل الهندسي في صيغته القانونية.
- ST_Points - متاحة منذ: 2.3.0 تُعيد نقطة متعددة (MultiPoint) تحتوي على إحداثيات الشكل الهندسي.
- ST_VoronoiLines - متاحة منذ: 2.3.0 تُعيد حدود مخطط فورونوي (Voronoi) لرؤوس شكل هندسي.
- ST_VoronoiPolygons - متاحة منذ: 2.3.0 تُعيد خلايا مخطط فورونوي (Voronoi) لرؤوس شكل هندسي.
- ST_WrapX - متاحة منذ: 2.3.0 تتطلب GEOS التفاف شكل هندسي حول قيمة X.
- TopoGeom_addElement - متاحة منذ: 2.3 تضيف عنصرًا إلى تعريف TopoGeometry.
- TopoGeom_remElement - متاحة منذ: 2.3 تزيل عنصرًا من تعريف TopoGeometry.
- ~(box2df,box2df) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي مستطيلًا محيطًا آخر ثنائي الأبعاد بدقة float (BOX2DF).
- ~(box2df,geometry) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا كان مستطيل محيط ثنائي الأبعاد بدقة float (BOX2DF) يحتوي المستطيل المحيط ثنائي الأبعاد لشكل هندسي.
- ~(geometry,box2df) - متاحة منذ: 2.3.0 أُضيف دعم فهارس نطاقات الكتل (BRIN). يتطلب PostgreSQL 9.5+. تُعيد TRUE إذا كان المستطيل المحيط ثنائي الأبعاد لشكل هندسي يحتوي مستطيلًا محيطًا ثنائي الأبعاد بدقة float (GIDX).
الدوال المحسّنة في PostGIS 2.3
- ST_Contains - حُسّنت في: 2.3.0 وُسّع تحسين الاختصار في اختبار نقطة داخل مضلع (PIP) ليدعم MultiPoints ذات النقاط القليلة. كانت الإصدارات السابقة تدعم فقط نقطة داخل مضلع. تختبر ما إذا كانت كل نقطة من B تقع في A، وما إذا كان لداخليهما نقطة مشتركة
- ST_Covers - حُسّنت في: 2.3.0 وُسّع تحسين الاختصار في اختبار نقطة داخل مضلع (PIP) لنوع geometry ليدعم MultiPoints ذات النقاط القليلة. كانت الإصدارات السابقة تدعم فقط نقطة داخل مضلع. تختبر ما إذا كانت كل نقطة من B تقع في A
- ST_Expand - حُسّنت في: 2.3.0 أُضيف دعم توسيع المستطيل بمقادير مختلفة في الأبعاد المختلفة. تُعيد مستطيلًا محيطًا موسّعًا من مستطيل محيط آخر أو من شكل هندسي.
- ST_Intersects - حُسّنت في: 2.3.0 وُسّع تحسين الاختصار في اختبار نقطة داخل مضلع (PIP) ليدعم MultiPoints ذات النقاط القليلة. كانت الإصدارات السابقة تدعم فقط نقطة داخل مضلع. تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- ST_Segmentize - حُسّنت في: 2.3.0 أصبح تقسيم geography يُنتج قطعًا فرعية متساوية الطول تُعيد geometry/geography معدّلًا لا تزيد فيه أي قطعة عن مسافة مُعطاة.
- ST_Transform - حُسّنت في: 2.3.0 أُضيف دعم نص PROJ.4 المباشر. تُعيد شكلًا هندسيًا جديدًا بإحداثيات محوّلة إلى نظام مرجعي مكاني مختلف.
- ST_Within - حُسّنت في: 2.3.0 وُسّع تحسين الاختصار في اختبار نقطة داخل مضلع (PIP) لنوع geometry ليدعم MultiPoints ذات النقاط القليلة. كانت الإصدارات السابقة تدعم فقط نقطة داخل مضلع. تختبر ما إذا كانت كل نقطة من A تقع في B، وكان لداخليهما نقطة مشتركة
الدوال المتغيّرة في PostGIS 2.3
- ST_PointN - تغيّرت في: 2.3.0 : أصبحت الفهرسة السالبة متاحة (-1 هي النقطة الأخيرة) تُعيد النقطة رقم N في أول خط (LineString) أو خط دائري في الشكل الهندسي.
13.12.11. دوال PostGIS الجديدة أو المحسّنة في 2.2
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 2.2
- <<->> - متاحة منذ: 2.2.0 -- KNN متاح فقط في PostgreSQL 9.1+ تُعيد المسافة متعددة الأبعاد (n-D) بين الشكلين الهندسيين A وB أو بين مستطيليهما المحيطين
- ST_3DDifference - متاحة منذ: 2.2.0 تُجري فرقًا ثلاثي الأبعاد
- ST_3DUnion - متاحة منذ: 2.2.0 تُجري اتحادًا ثلاثي الأبعاد.
- ST_ApproximateMedialAxis - متاحة منذ: 2.2.0 تحسب المحور الوسطي التقريبي لشكل هندسي مساحي.
- ST_AsEncodedPolyline - متاحة منذ: 2.2.0 تُعيد خطًا متعدد الأجزاء مُرمَّزًا (Encoded Polyline) من شكل هندسي من نوع LineString.
- ST_AsTWKB - متاحة منذ: 2.2.0 تُعيد الشكل الهندسي بصيغة TWKB، أي "Tiny Well-Known Binary"
- ST_BoundingDiagonal - متاحة منذ: 2.2.0 تُعيد قطر المستطيل المحيط بالشكل الهندسي.
- ST_CPAWithin - متاحة منذ: 2.2.0 تختبر ما إذا كانت نقطة أقرب اقتراب بين مسارين ضمن المسافة المحددة.
- ST_ClipByBox2D - متاحة منذ: 2.2.0 تحسب جزء الشكل الهندسي الواقع داخل مستطيل.
- ST_ClosestPointOfApproach - متاحة منذ: 2.2.0 تُعيد القياس عند نقطة أقرب اقتراب بين مسارين.
- ST_ClusterIntersecting - متاحة منذ: 2.2.0 دالة تجميعية تُعنقد الأشكال الهندسية المُدخلة في مجموعات متصلة.
- ST_ClusterWithin - متاحة منذ: 2.2.0 دالة تجميعية تُعنقد الأشكال الهندسية حسب مسافة الفصل.
- ST_CountAgg - متاحة منذ: 2.2.0 دالة تجميعية. تُعيد عدد البكسلات في نطاق معيّن من مجموعة رسترات. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. إذا ضُبط exclude_nodata_value على true، فستُعدّ فقط البكسلات غير المساوية لقيمة NODATA.
- ST_CreateOverview - متاحة منذ: 2.2.0 تُنشئ نسخة منخفضة الدقة من تغطية رستر معينة.
- ST_DistanceCPA - متاحة منذ: 2.2.0 تُعيد المسافة عند نقطة أقرب اقتراب بين مسارين.
- ST_ForceCurve - متاحة منذ: 2.2.0 رفع الشكل الهندسي إلى نوعه المنحني، إن أمكن.
- ST_IsPlanar - متاحة منذ: 2.2.0: وُثّقت في 2.1.0 لكنها سقطت سهوًا من إصدار 2.1. تتحقق مما إذا كان السطح مستويًا أم لا
- ST_IsSolid - متاحة منذ: 2.2.0 تختبر ما إذا كان الشكل الهندسي مجسّمًا (solid). لا يُجرى أي فحص للصلاحية.
- ST_IsValidTrajectory - متاحة منذ: 2.2.0 تختبر ما إذا كان الشكل الهندسي مسارًا صالحًا.
- ST_LineFromEncodedPolyline - متاحة منذ: 2.2.0 تُنشئ LineString من خط متعدد مرمّز (Encoded Polyline).
- ST_MakeSolid - متاحة منذ: 2.2.0 تحوّل الشكل الهندسي إلى مجسّم (solid). لا يُجرى أي فحص. للحصول على مجسّم صالح، يجب أن يكون الشكل المُدخَل سطحًا متعدد الأوجه مغلقًا أو TIN مغلقًا.
- ST_MapAlgebra (callback function version) - متاحة منذ: 2.2.0: إمكانية إضافة قناع نسخة دالة الاستدعاء الراجع (callback) - تُعيد رسترًا بنطاق واحد انطلاقًا من رستر مُدخل واحد أو أكثر وفهارس نطاقات ودالة استدعاء راجع واحدة يحددها المستخدم.
- ST_MemSize - متاحة منذ: 2.2.0 تُعيد مقدار المساحة (بالبايت) التي يشغلها الرستر.
- ST_RemoveRepeatedPoints - متاحة منذ: 2.2.0 تُعيد نسخة من الشكل الهندسي بعد إزالة النقاط المكررة.
- ST_Retile - متاحة منذ: 2.2.0 تُعيد مجموعة من البلاطات المُهيّأة من تغطية رستر مقسّمة إلى بلاطات بشكل عشوائي.
- ST_SetEffectiveArea - متاحة منذ: 2.2.0 تضبط المساحة الفعّالة لكل رأس باستخدام خوارزمية Visvalingam-Whyatt.
- ST_SimplifyVW - متاحة منذ: 2.2.0 تُعيد تمثيلاً مبسّطاً لشكل هندسي باستخدام خوارزمية Visvalingam-Whyatt
- ST_Subdivide - متاحة منذ: 2.2.0 تحسب تقسيماً متعامد الخطوط لشكل هندسي.
- ST_SummaryStatsAgg - متاحة منذ: 2.2.0 دالة تجميعية. تُعيد summarystats المكوّنة من count وsum وmean وstddev وmin وmax لنطاق رستر معيّن من مجموعة رسترات. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_SwapOrdinates - متاحة منذ: 2.2.0 تُعيد نسخة من الشكل الهندسي المُعطى مع تبديل قيم الإحداثيات المحددة.
- ST_Volume - متاحة منذ: 2.2.0 تحسب حجم مجسّم ثلاثي الأبعاد. إذا طُبّقت على أشكال سطحية (حتى المغلقة منها) فستُعيد 0.
- parse_address - متاحة منذ: 2.2.0 تأخذ عنوانًا من سطر واحد وتقسّمه إلى أجزاء
- postgis.enable_outdb_rasters - متاحة منذ: 2.2.0 خيار إعداد منطقي (boolean) لتفعيل الوصول إلى نطاقات الرستر المخزّنة خارج قاعدة البيانات (out-db).
- postgis.gdal_datapath - متاحة منذ: 2.2.0 خيار إعداد لتعيين قيمة الخيار GDAL_DATA في GDAL. إذا لم يُضبط، فيُستخدم المتغير GDAL_DATA المضبوط في البيئة.
- postgis.gdal_enabled_drivers - متاحة منذ: 2.2.0 خيار إعداد لضبط مشغّلات GDAL المفعّلة في بيئة PostGIS. يؤثر في متغير إعداد GDAL GDAL_SKIP.
- standardize_address - متاحة منذ: 2.2.0 تُعيد صيغة stdaddr لعنوان مُدخل باستخدام جداول lex وgaz والقواعد.
- |=| - متاحة منذ: 2.2.0. دعم الفهرس متاح فقط في PostgreSQL 9.5+ تُعيد المسافة بين المسارين A وB عند نقطة اقترابهما الأقرب.
الدوال المحسّنة في PostGIS 2.2
- <-> - حُسّنت في: 2.2.0 -- سلوك KNN («أقرب K جار») الحقيقي لـ geometry وgeography في PostgreSQL 9.5+. لاحظ أن KNN في geography يعتمد على الكرة لا الإهليلج. في PostgreSQL 9.4 وما قبله، دعم geography جديد لكنه يدعم مراكز المستطيلات المحيطة فقط. تُعيد المسافة ثنائية الأبعاد بين A وB.
- AsTopoJSON - حُسّنت في: 2.2.1 أضيف دعم المدخلات النقطية تُعيد تمثيل TopoJSON لكائن TopoGeometry.
- ST_Area - حُسّنت في: 2.2.0 - يُجرى القياس على الشكل الإهليلجي باستخدام GeographicLib لتحسين الدقة والمتانة. يتطلب PROJ >= 4.9.0 للاستفادة من الميزة الجديدة. تُعيد مساحة شكل هندسي مضلعي.
- ST_AsX3D - حُسّنت في: 2.2.0: دعم GeoCoordinates وقلب المحاور (x/y، long/lat). راجع الخيارات للتفاصيل. تُعيد شكلًا هندسيًا بصيغة عنصر عقدة X3D xml: ISO-IEC-19776-1.2-X3DEncodings-XML
- ST_Azimuth - حُسّنت في: 2.2.0 يُجرى القياس على الشكل الإهليلجي باستخدام GeographicLib لتحسين الدقة والمتانة. يتطلب PROJ >= 4.9.0 للاستفادة من الميزة الجديدة. تُعيد السمت المرجعي إلى الشمال لخط بين نقطتين.
- ST_Distance - حُسّنت في: 2.2.0 - يُجرى القياس على الشكل الإهليلجي باستخدام GeographicLib لتحسين الدقة والمتانة. يتطلب PROJ >= 4.9.0 للاستفادة من الميزة الجديدة. تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_Scale - حُسّنت في: 2.2.0 أُضيف دعم تغيير مقياس جميع الأبعاد (المعامل factor). تغيّر مقياس شكل هندسي بمعاملات معيّنة.
- ST_Split - حُسّنت في: 2.2.0 أُضيف دعم تقسيم خط بخط متعدد أو بنقاط متعددة أو بحدود مضلع (متعدد). تُعيد مجموعة من الأشكال الهندسية الناتجة عن تقسيم شكل هندسي بشكل آخر.
- ST_Summary - حُسّنت في: 2.2.0 أُضيف دعم TIN والمنحنيات تُعيد ملخصًا نصيًا لمحتويات الشكل الهندسي.
الدوال المتغيّرة في PostGIS 2.2
- <-> - تغيّرت في: 2.2.0 -- لمستخدمي PostgreSQL 9.5، قد تكون الصيغة الهجينة القديمة أبطأ، لذا يُستحسن التخلص من هذا الالتفاف إذا كنت تشغّل شيفرتك على PostGIS 2.2+ مع 9.5+ فقط. انظر الأمثلة أدناه. تُعيد المسافة ثنائية الأبعاد بين A وB.
- Get_Geocode_Setting - تغيّرت في: 2.2.0: تُحفظ الإعدادات الافتراضية الآن في جدول يُسمى geocode_settings_default. أما الإعدادات المخصصة فتوجد في geocode_settings ولا تحتوي إلا على ما ضبطه المستخدم. تُعيد قيمة إعداد محدد مخزَّن في الجدول tiger.geocode_settings.
- ST_3DClosestPoint - تغيّرت في: 2.2.0 - إذا كان المُدخلان شكلين ثنائيي الأبعاد، تُعاد نقطة ثنائية الأبعاد (بدلًا من السلوك القديم الذي كان يفترض 0 لقيمة Z المفقودة). وفي حالة شكل ثنائي الأبعاد وآخر ثلاثي الأبعاد، لم يعد يُفترض أن Z المفقودة تساوي 0. تُعيد النقطة ثلاثية الأبعاد على g1 الأقرب إلى g2. وهي النقطة الأولى من أقصر خط ثلاثي الأبعاد.
- ST_3DDistance - تغيّرت في: 2.2.0 - في حالة شكل ثنائي الأبعاد وآخر ثلاثي الأبعاد، لم يعد يُفترض أن Z المفقودة تساوي 0. تُعيد أقل مسافة ديكارتية ثلاثية الأبعاد (بناءً على النظام المرجعي المكاني) بين شكلين بوحدات الإسقاط.
- ST_3DLongestLine - تغيّرت في: 2.2.0 - إذا كان المُدخلان شكلين ثنائيي الأبعاد، تُعاد نقطة ثنائية الأبعاد (بدلًا من السلوك القديم الذي كان يفترض 0 لقيمة Z المفقودة). وفي حالة شكل ثنائي الأبعاد وآخر ثلاثي الأبعاد، لم يعد يُفترض أن Z المفقودة تساوي 0. تُعيد أطول خط ثلاثي الأبعاد بين شكلين
- ST_3DMaxDistance - تغيّرت في: 2.2.0 - في حالة شكل ثنائي الأبعاد وآخر ثلاثي الأبعاد، لم يعد يُفترض أن Z المفقودة تساوي 0. تُعيد المسافة الديكارتية القصوى ثلاثية الأبعاد (بحسب النظام المرجعي المكاني) بين شكلين هندسيين بوحدات الإسقاط.
- ST_3DShortestLine - تغيّرت في: 2.2.0 - إذا كان المُدخلان شكلين ثنائيي الأبعاد، تُعاد نقطة ثنائية الأبعاد (بدلًا من السلوك القديم الذي كان يفترض 0 لقيمة Z المفقودة). وفي حالة شكل ثنائي الأبعاد وآخر ثلاثي الأبعاد، لم يعد يُفترض أن Z المفقودة تساوي 0. تُعيد أقصر خط ثلاثي الأبعاد بين شكلين هندسيين
- ST_DistanceSphere - تغيّرت في: 2.2.0 في الإصدارات السابقة كانت تُسمّى ST_Distance_Sphere تُعيد أقل مسافة بالمتر بين شكلين بإحداثيات خط الطول/خط العرض باستخدام نموذج كروي للأرض.
- ST_DistanceSpheroid - تغيّرت في: 2.2.0 في الإصدارات السابقة كانت تُسمّى ST_Distance_Spheroid تُعيد أقل مسافة بين شكلين بإحداثيات خط الطول/خط العرض باستخدام نموذج إهليلجي للأرض.
- ST_Equals - تغيّرت في: 2.2.0 تُعيد true حتى للأشكال الهندسية غير الصالحة إذا كانت متساوية ثنائيًا تختبر ما إذا كان شكلان هندسيان يضمّان مجموعة النقاط نفسها
- ST_LengthSpheroid - تغيّرت في: 2.2.0 في الإصدارات السابقة كانت تُسمّى ST_Length_Spheroid وكان لها الاسم البديل ST_3DLength_Spheroid تُعيد الطول/المحيط ثنائي أو ثلاثي الأبعاد لشكل بإحداثيات خط الطول/خط العرض على شكل إهليلجي.
- ST_MemSize - تغيّرت في: 2.2.0 تغيّر الاسم إلى ST_MemSize لاتباع اصطلاح التسمية. تُعيد مقدار مساحة الذاكرة التي يشغلها الشكل الهندسي.
- ST_PointInsideCircle - تغيّرت في: 2.2.0 كانت تُسمّى في الإصدارات السابقة ST_Point_Inside_Circle تختبر ما إذا كان شكل هندسي نقطي يقع داخل دائرة معرّفة بمركز ونصف قطر
- ValidateTopology - تغيّرت في: 2.2.0 تم تبديل قيمتي id1 وid2 في الخطأ 'edge crosses node' لتتسق مع وصف الخطأ. تُعيد مجموعة من كائنات validatetopology_returntype تفصّل المشكلات في الطوبولوجيا.
13.12.12. دوال PostGIS الجديدة أو المحسّنة في 2.1
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 2.1
- = - متاحة منذ: 2.1.0 تُعيد TRUE إذا كان المستطيل المحيط بـ A مطابقًا للمستطيل المحيط بـ B. تستخدم مستطيلًا محيطًا بدقة مضاعفة (double precision).
- AsTopoJSON - متاحة منذ: 2.1.0 تُعيد تمثيل TopoJSON لكائن TopoGeometry.
- Drop_Nation_Tables_Generate_Script - متاحة منذ: 2.1.0 تولّد سكربتًا يحذف جميع الجداول في المخطط المحدد التي تبدأ أسماؤها بـ county_all أو state_all أو برمز الولاية متبوعًا بـ county أو state.
- Get_Geocode_Setting - متاحة منذ: 2.1.0 تُعيد قيمة إعداد محدد مخزَّن في الجدول tiger.geocode_settings.
- Loader_Generate_Nation_Script - متاحة منذ: 2.1.0 تولّد سكربت shell للمنصة المحددة يحمّل جداول البحث الخاصة بالمقاطعات والولايات.
- Pagc_Normalize_Address - متاحة منذ: 2.1.0 تُعيد، بإعطائها عنوان شارع نصيًا، نوعًا مركبًا norm_addy تكون فيه لاحقة الطريق وبادئته ونوعه موحّدة، ويُقسَّم فيه الشارع واسم الشارع وغيرها إلى حقول منفصلة. تعمل هذه الدالة باستخدام بيانات البحث المرفقة مع tiger_geocoder فقط (دون الحاجة إلى بيانات تعداد tiger). تتطلب الامتداد address_standardizer.
- ST_3DArea - متاحة منذ: 2.1.0 تحسب مساحة الأشكال الهندسية السطحية الثلاثية الأبعاد. تُعيد 0 للمجسّمات.
- ST_3DIntersection - متاحة منذ: 2.1.0 تُجري تقاطعًا ثلاثي الأبعاد
- ST_Box2dFromGeoHash - متاحة منذ: 2.1.0 تُعيد BOX2D من سلسلة GeoHash.
- ST_ColorMap - متاحة منذ: 2.1.0 تُنشئ رسترًا جديدًا يضم حتى أربعة نطاقات من نوع 8BUI (تدرّج رمادي، RGB، RGBA) من الرستر المصدر ونطاق محدد. يُفترض النطاق 1 إذا لم يُحدَّد.
- ST_Contains - متاحة منذ: 2.1.0 تُعيد true إذا لم تقع أي نقطة من الرستر rastB خارج الرستر rastA، ووقعت نقطة واحدة على الأقل من داخل rastB في داخل rastA.
- ST_ContainsProperly - متاحة منذ: 2.1.0 تُعيد true إذا كان rastB يتقاطع مع داخل rastA وليس مع حدوده أو خارجه.
- ST_CoveredBy - متاحة منذ: 2.1.0 تُعيد true إذا لم تقع أي نقطة من الرستر rastA خارج الرستر rastB.
- ST_Covers - متاحة منذ: 2.1.0 تُعيد true إذا لم تقع أي نقطة من الرستر rastB خارج الرستر rastA.
- ST_DFullyWithin - متاحة منذ: 2.1.0 تُعيد true إذا كان الرستران rastA وrastB ضمن المسافة المحددة أحدهما من الآخر بالكامل.
- ST_DWithin - متاحة منذ: 2.1.0 تُعيد true إذا كان الرستران rastA وrastB ضمن المسافة المحددة أحدهما من الآخر.
- ST_DelaunayTriangles - متاحة منذ: 2.1.0 تُعيد تثليث ديلوناي (Delaunay) لرؤوس شكل هندسي.
- ST_Disjoint - متاحة منذ: 2.1.0 تُعيد true إذا كان الرستر rastA لا يتقاطع مكانيًا مع rastB.
- ST_DumpValues - متاحة منذ: 2.1.0 تحصل على قيم النطاق المحدد في صورة مصفوفة ثنائية الأبعاد.
- ST_Extrude - متاحة منذ: 2.1.0 تبثق (extrude) سطحًا إلى حجم مرتبط به
- ST_ForceLHR - متاحة منذ: 2.1.0 تفرض الاتجاه LHR
- ST_FromGDALRaster - متاحة منذ: 2.1.0 تُعيد رسترًا من ملف رستر مدعوم في GDAL.
- ST_GeomFromGeoHash - متاحة منذ: 2.1.0 تُعيد geometry من سلسلة GeoHash.
- ST_InvDistWeight4ma - متاحة منذ: 2.1.0 دالة معالجة رستر تستكمل قيمة بكسل من جوار ذلك البكسل.
- ST_MapAlgebra (callback function version) - متاحة منذ: 2.1.0 نسخة دالة الاستدعاء الراجع (callback) - تُعيد رسترًا بنطاق واحد انطلاقًا من رستر مُدخل واحد أو أكثر وفهارس نطاقات ودالة استدعاء راجع واحدة يحددها المستخدم.
- ST_MapAlgebra (expression version) - متاحة منذ: 2.1.0 نسخة التعبير - تُعيد رسترًا بنطاق واحد انطلاقًا من رستر مُدخل واحد أو اثنين وفهارس نطاقات وتعبير SQL واحد أو أكثر يحدده المستخدم.
- ST_MinConvexHull - متاحة منذ: 2.1.0 تُعيد الشكل الهندسي للغلاف المحدب للرستر مع استبعاد بكسلات NODATA.
- ST_MinDist4ma - متاحة منذ: 2.1.0 دالة معالجة رستر تُعيد أقصر مسافة (بعدد البكسلات) بين البكسل المعني وبكسل مجاور ذي قيمة.
- ST_MinkowskiSum - متاحة منذ: 2.1.0 تُجري جمع مينكوفسكي
- ST_NearestValue - متاحة منذ: 2.1.0 تُعيد أقرب قيمة غير NODATA لبكسل نطاق معيّن محدد بـ columnx وrowy أو بنقطة هندسية مُعبَّر عنها في نظام الإحداثيات المرجعي المكاني نفسه للرستر.
- ST_Neighborhood - متاحة منذ: 2.1.0 تُعيد مصفوفة ثنائية الأبعاد من نوع double precision تضم القيم غير NODATA المحيطة ببكسل نطاق معيّن محدد إما بـ columnX وrowY أو بنقطة هندسية مُعبَّر عنها في نظام الإحداثيات المرجعي المكاني نفسه للرستر.
- ST_NotSameAlignmentReason - متاحة منذ: 2.1.0 تُعيد نصًا يوضح ما إذا كانت الرسترات متحاذية، وإن لم تكن متحاذية فسبب ذلك.
- ST_Orientation - متاحة منذ: 2.1.0 تحدد اتجاه السطح
- ST_Overlaps - متاحة منذ: 2.1.0 تُعيد true إذا كان الرستران rastA وrastB يتقاطعان لكن أحدهما لا يحتوي الآخر احتواءً كاملًا.
- ST_PixelAsCentroid - متاحة منذ: 2.1.0 تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) للمساحة التي يمثّلها بكسل.
- ST_PixelAsCentroids - متاحة منذ: 2.1.0 تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. الشكل الهندسي النقطي هو المركز الهندسي للمساحة التي يمثّلها البكسل.
- ST_PixelAsPoint - متاحة منذ: 2.1.0 تُعيد شكلًا هندسيًا نقطيًا للزاوية العلوية اليسرى من البكسل.
- ST_PixelAsPoints - متاحة منذ: 2.1.0 تُعيد شكلًا هندسيًا نقطيًا لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. إحداثيات الشكل الهندسي النقطي هي إحداثيات الزاوية العلوية اليسرى من البكسل.
- ST_PixelOfValue - متاحة منذ: 2.1.0 تحصل على إحداثيَّي columnx وrowy للبكسل الذي تساوي قيمته قيمة البحث.
- ST_PointFromGeoHash - متاحة منذ: 2.1.0 تُعيد نقطة من سلسلة GeoHash.
- ST_RasterToWorldCoord - متاحة منذ: 2.1.0 تُعيد الزاوية العلوية اليسرى للرستر في صورة X وY هندسيين (خط الطول ودائرة العرض) بمعلومية عمود وصف. يبدأ ترقيم العمود والصف من 1.
- ST_Resize - متاحة منذ: 2.1.0 تتطلب GDAL 1.6.1+ تغيّر حجم رستر إلى عرض/ارتفاع جديد
- ST_Roughness - متاحة منذ: 2.1.0 تُعيد رسترًا يحتوي على «الخشونة» المحسوبة لنموذج ارتفاع رقمي DEM.
- ST_SetValues - متاحة منذ: 2.1.0 تُعيد الرستر المعدَّل الناتج عن ضبط قيم نطاق معيّن.
- ST_Simplify - متاحة منذ: 2.1.0 تُعيد نسخة geometry «مبسّطة» من TopoGeometry المعطى باستخدام خوارزمية Douglas-Peucker.
- ST_StraightSkeleton - متاحة منذ: 2.1.0 تحسب هيكلًا مستقيمًا (straight skeleton) من شكل هندسي
- ST_Summary - متاحة منذ: 2.1.0 تُعيد ملخصًا نصيًا لمحتويات الرستر.
- ST_TPI - متاحة منذ: 2.1.0 تُعيد رسترًا يحتوي على مؤشر الموقع الطبوغرافي (TPI) المحسوب.
- ST_TRI - متاحة منذ: 2.1.0 تُعيد رسترًا يحتوي على مؤشر وعورة التضاريس (TRI) المحسوب.
- ST_Tesselate - متاحة منذ: 2.1.0 تُجري تبليطًا (Tessellation) سطحيًا لمضلع أو سطح متعدد الأوجه وتُعيده على هيئة TIN أو مجموعة من TIN
- ST_Tile - متاحة منذ: 2.1.0 تُعيد مجموعة من الرسترات الناتجة عن تقسيم الرستر المُدخَل بناءً على الأبعاد المطلوبة للرسترات الناتجة.
- ST_Touches - متاحة منذ: 2.1.0 تُعيد true إذا كان للرسترين rastA وrastB نقطة مشتركة واحدة على الأقل لكن داخليهما لا يتقاطعان.
- ST_Union - متاحة منذ: 2.1.0 أُضيف الشكل ST_Union(rast, unionarg). تُعيد اتحاد مجموعة من بلاطات الرستر في رستر واحد يتكون من نطاق واحد أو أكثر.
- ST_Within - متاحة منذ: 2.1.0 تُعيد true إذا لم تقع أي نقطة من الرستر rastA خارج الرستر rastB، ووقعت نقطة واحدة على الأقل من داخل rastA في داخل rastB.
- ST_WorldToRasterCoord - متاحة منذ: 2.1.0 تُعيد الزاوية العلوية اليسرى في صورة عمود وصف بمعلومية X وY هندسيين (خط الطول ودائرة العرض) أو شكل هندسي نقطي مُعبَّر عنه في نظام الإحداثيات المرجعي المكاني للرستر.
- Set_Geocode_Setting - متاحة منذ: 2.1.0 تضبط إعدادًا يؤثر في سلوك دوال المُرمِّز الجغرافي.
- UpdateRasterSRID - متاحة منذ: 2.1.0 تغيّر SRID لجميع الرسترات في العمود والجدول اللذين يحددهما المستخدم.
- clearTopoGeom - متاحة منذ: 2.1 تمسح محتوى كائن TopoGeometry.
- postgis_sfcgal_version - متاحة منذ: 2.1.0 تُعيد إصدار SFCGAL المستخدم
الدوال المحسّنة في PostGIS 2.1
- ST_AddBand - حُسّنت في: 2.1.0 أُضيف دعم addbandarg. تُعيد رسترًا أُضيف إليه نطاق (أو نطاقات) جديد من النوع المحدد بالقيمة الأولية المحددة في موضع الفهرس المحدد. إذا لم يُحدَّد فهرس، يُضاف النطاق في النهاية.
- ST_AddBand - حُسّنت في: 2.1.0 أُضيف دعم النطاقات الجديدة المخزّنة خارج قاعدة البيانات (out-db). تُعيد رسترًا أُضيف إليه نطاق (أو نطاقات) جديد من النوع المحدد بالقيمة الأولية المحددة في موضع الفهرس المحدد. إذا لم يُحدَّد فهرس، يُضاف النطاق في النهاية.
- ST_AsBinary/ST_AsWKB - حُسّنت في: 2.1.0 إضافة outasin تُعيد تمثيل Well-Known Binary (WKB) للرستر.
- ST_AsGML - حُسّنت في: 2.1.0 أُضيف دعم id لـ GML 3. تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_Aspect - حُسّنت في: 2.1.0 تستخدم ST_MapAlgebra() وأُضيف معامل الدالة الاختياري interpolate_nodata تُعيد الاتجاه (Aspect) (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_Boundary - حُسّنت في: 2.1.0 أُضيف دعم المثلث (Triangle) تُعيد حدود الشكل الهندسي.
- ST_Clip - حُسّنت في: 2.1.0 أُعيدت كتابتها بلغة C تُعيد الرستر مقصوصًا بالشكل الهندسي المُدخل. إذا لم يُحدَّد رقم النطاق، فتُعالَج جميع النطاقات. إذا لم يُحدَّد crop أو كان TRUE، فيُقتطع الرستر الناتج. إذا ضُبط touched على TRUE، فتُضمَّن البكسلات الملامِسة، وإلا فلا يُضمَّن البكسل إلا إذا وقع مركزه داخل الشكل الهندسي.
- ST_DWithin - حُسّنت في: 2.1.0 تحسين سرعة geography. انظر جعل geography أسرع للتفاصيل. تختبر ما إذا كان شكلان هندسيان ضمن مسافة معيّنة
- ST_DWithin - حُسّنت في: 2.1.0 أُضيف دعم الأشكال الهندسية المنحنية. تختبر ما إذا كان شكلان هندسيان ضمن مسافة معيّنة
- ST_Distance - حُسّنت في: 2.1.0 تحسين سرعة geography. انظر جعل geography أسرع للتفاصيل. تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_Distance - حُسّنت في: 2.1.0 - أُضيف دعم الأشكال المنحنية. تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_Distinct4ma - حُسّنت في: 2.1.0 إضافة الشكل 2 دالة معالجة رستر تحسب عدد قيم البكسلات الفريدة في جوار.
- ST_DumpPoints - حُسّنت في: 2.1.0 سرعة أعلى. أُعيد تنفيذها بلغة C أصلية. تُعيد مجموعة من صفوف geometry_dump للإحداثيات في الشكل الهندسي.
- ST_HillShade - حُسّنت في: 2.1.0 تستخدم ST_MapAlgebra() وأُضيف معامل الدالة الاختياري interpolate_nodata تُعيد الإضاءة الافتراضية لنطاق رستر ارتفاعات باستخدام مُدخلات السمت والارتفاع والسطوع والمقياس المُعطاة.
- ST_MakeValid - حُسّنت في: 2.1.0، أُضيف دعم GEOMETRYCOLLECTION وMULTIPOINT. تحاول جعل شكل هندسي غير صالح صالحًا دون فقدان أي رؤوس.
- ST_Max4ma - حُسّنت في: 2.1.0 إضافة الشكل 2 دالة معالجة رستر تحسب القيمة العظمى للبكسلات في جوار.
- ST_Mean4ma - حُسّنت في: 2.1.0 إضافة الشكل 2 دالة معالجة رستر تحسب متوسط قيم البكسلات في جوار.
- ST_Min4ma - حُسّنت في: 2.1.0 إضافة الشكل 2 دالة معالجة رستر تحسب القيمة الدنيا للبكسلات في جوار.
- ST_PixelAsPolygons - حُسّنت في: 2.1.0 أُضيف الوسيط الاختياري exclude_nodata_value. تُعيد الشكل الهندسي المضلع الذي يحدّ كل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل.
- ST_Polygon - حُسّنت في: 2.1.0 تحسين السرعة (تنفيذ كامل بلغة C) وأصبح المضلع المتعدد المُعاد مضمون الصلاحية. تُعيد شكلًا هندسيًا من نوع multipolygon يتكوّن من اتحاد البكسلات التي لا تساوي قيمتها قيمة NODATA. إذا لم يُحدَّد رقم النطاق، فالقيمة الافتراضية لرقم النطاق هي 1.
- ST_Range4ma - حُسّنت في: 2.1.0 إضافة الشكل 2 دالة معالجة رستر تحسب مدى قيم البكسلات في جوار.
- ST_SameAlignment - حُسّنت في: 2.1.0 إضافة الشكل التجميعي تُعيد true إذا كان للرسترات الميل والمقياس والمرجع المكاني والإزاحة نفسها (بحيث يمكن وضع البكسلات على الشبكة نفسها دون قطع البكسلات)، وتُعيد false إذا لم تكن كذلك مع إشعار يوضح المشكلة.
- ST_Segmentize - حُسّنت في: 2.1.0 أُضيف دعم geography. تُعيد geometry/geography معدّلًا لا تزيد فيه أي قطعة عن مسافة مُعطاة.
- ST_SetGeoReference - حُسّنت في: 2.1.0 إضافة الصيغة ST_SetGeoReference(raster, double precision, ...) تضبط معاملات الإسناد الجغرافي الستة في استدعاء واحد. يجب فصل الأعداد بمسافات بيضاء. تقبل المُدخَلات بصيغة GDAL أو ESRI. القيمة الافتراضية GDAL.
- ST_SetValue - حُسّنت في: 2.1.0 أصبحت صيغة الشكل الهندسي من ST_SetValue() تدعم أي نوع من الأشكال الهندسية، وليس النقطة فقط. صيغة الشكل الهندسي غلاف حول صيغة geomval[] من ST_SetValues() تُعيد الرستر المعدَّل الناتج عن ضبط قيمة نطاق معيّن في بكسل معيّن (columnx، rowy) أو في البكسلات التي تتقاطع مع شكل هندسي معيّن. يبدأ ترقيم النطاقات من 1 ويُفترض 1 إذا لم يُحدَّد.
- ST_Slope - حُسّنت في: 2.1.0 تستخدم ST_MapAlgebra() وأُضيفت معاملات الدالة الاختيارية units وscale وinterpolate_nodata تُعيد الانحدار (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_StdDev4ma - حُسّنت في: 2.1.0 إضافة الشكل 2 دالة معالجة رستر تحسب الانحراف المعياري لقيم البكسلات في جوار.
- ST_Sum4ma - حُسّنت في: 2.1.0 إضافة الشكل 2 دالة معالجة رستر تحسب مجموع جميع قيم البكسلات في جوار.
- ST_Summary - حُسّنت في: 2.1.0 الراية S للدلالة على وجود نظام مرجعي مكاني معروف تُعيد ملخصًا نصيًا لمحتويات الشكل الهندسي.
- ST_Transform - حُسّنت في: 2.1.0 إضافة الشكل ST_Transform(rast, alignto) تُعيد إسقاط رستر من نظام مرجعي مكاني معروف إلى نظام مرجعي مكاني معروف آخر باستخدام خوارزمية إعادة اعتيان محددة. الخيارات هي NearestNeighbor وBilinear وCubic وCubicSpline وLanczos، والافتراضي NearestNeighbor.
- ST_Union - حُسّنت في: 2.1.0 تحسين السرعة (تنفيذ كامل بلغة C). تُعيد اتحاد مجموعة من بلاطات الرستر في رستر واحد يتكون من نطاق واحد أو أكثر.
- ST_Union - حُسّنت في: 2.1.0 يوحّد الشكل ST_Union(rast) (الشكل 1) جميع نطاقات جميع الرسترات المُدخلة. كانت الإصدارات السابقة من PostGIS تفترض النطاق الأول فقط. تُعيد اتحاد مجموعة من بلاطات الرستر في رستر واحد يتكون من نطاق واحد أو أكثر.
- ST_Union - حُسّنت في: 2.1.0 يوحّد الشكل ST_Union(rast, uniontype) (الشكل 4) جميع نطاقات جميع الرسترات المُدخلة. تُعيد اتحاد مجموعة من بلاطات الرستر في رستر واحد يتكون من نطاق واحد أو أكثر.
- toTopoGeom - حُسّنت في: 2.1.0 أضيفت الصيغة التي تأخذ كائن TopoGeometry موجودًا. تحوّل شكلًا هندسيًا بسيطًا إلى TopoGeometry.
الدوال المتغيّرة في PostGIS 2.1
- ST_Aspect - تغيّرت في: 2.1.0 في الإصدارات السابقة كانت القيم المُعادة بالراديان. أصبحت القيم المُعادة الآن بالدرجات افتراضيًا تُعيد الاتجاه (Aspect) (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_EstimatedExtent - تغيّرت في: 2.1.0. حتى 2.0.x كانت تُسمّى ST_Estimated_Extent. تُعيد الامتداد التقديري لجدول مكاني.
- ST_Force2D - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_2D. فرض "الوضع ثنائي الأبعاد" على الأشكال الهندسية.
- ST_Force3D - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_3D. فرض وضع XYZ على الأشكال الهندسية. وهي اسم بديل لـ ST_Force3DZ.
- ST_Force3DM - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_3DM. فرض وضع XYM على الأشكال الهندسية.
- ST_Force3DZ - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_3DZ. فرض وضع XYZ على الأشكال الهندسية.
- ST_Force4D - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_4D. فرض وضع XYZM على الأشكال الهندسية.
- ST_ForceCollection - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Force_Collection. تحويل الشكل الهندسي إلى GEOMETRYCOLLECTION.
- ST_HillShade - تغيّرت في: 2.1.0 في الإصدارات السابقة كان السمت والارتفاع يُعبَّر عنهما بالراديان. أصبح السمت والارتفاع الآن يُعبَّر عنهما بالدرجات تُعيد الإضاءة الافتراضية لنطاق رستر ارتفاعات باستخدام مُدخلات السمت والارتفاع والسطوع والمقياس المُعطاة.
- ST_LineInterpolatePoint - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Line_Interpolate_Point. تُعيد نقطة مُستكمَلة على امتداد خط عند موقع كسري.
- ST_LineLocatePoint - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Line_Locate_Point. تُعيد الموقع الكسري لأقرب نقطة على خط إلى نقطة.
- ST_LineSubstring - تغيّرت في: 2.1.0. حتى الإصدار 2.0.x كانت تُسمّى ST_Line_Substring. تُعيد جزء الخط الواقع بين موقعين كسريين.
- ST_PixelAsCentroids - تغيّرت في: 2.1.1 تغيّر سلوك exclude_nodata_value. تُعيد المركز الهندسي (شكلًا هندسيًا نقطيًا) لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. الشكل الهندسي النقطي هو المركز الهندسي للمساحة التي يمثّلها البكسل.
- ST_PixelAsPoints - تغيّرت في: 2.1.1 تغيّر سلوك exclude_nodata_value. تُعيد شكلًا هندسيًا نقطيًا لكل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل. إحداثيات الشكل الهندسي النقطي هي إحداثيات الزاوية العلوية اليسرى من البكسل.
- ST_PixelAsPolygons - تغيّرت في: 2.1.1 تغيّر سلوك exclude_nodata_value. تُعيد الشكل الهندسي المضلع الذي يحدّ كل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل.
- ST_Polygon - تغيّرت في: 2.1.0 في الإصدارات السابقة كانت تُعيد أحيانًا مضلعًا، وتغيّرت لتُعيد دائمًا مضلعًا متعددًا. تُعيد شكلًا هندسيًا من نوع multipolygon يتكوّن من اتحاد البكسلات التي لا تساوي قيمتها قيمة NODATA. إذا لم يُحدَّد رقم النطاق، فالقيمة الافتراضية لرقم النطاق هي 1.
- ST_RasterToWorldCoordX - تغيّرت في: 2.1.0 في الإصدارات السابقة كانت تُسمّى ST_Raster2WorldCoordX تُعيد الإحداثي الهندسي X للزاوية العلوية اليسرى لرستر وعمود وصف. يبدأ ترقيم الأعمدة والصفوف من 1.
- ST_RasterToWorldCoordY - تغيّرت في: 2.1.0 في الإصدارات السابقة كانت تُسمّى ST_Raster2WorldCoordY تُعيد الإحداثي الهندسي Y للزاوية العلوية اليسرى لرستر وعمود وصف. يبدأ ترقيم الأعمدة والصفوف من 1.
- ST_Rescale - تغيّرت في: 2.1.0 تعمل على الرسترات التي ليس لها SRID تُعيد تشكيل رستر بضبط مقياسه (أو حجم بكسله) فقط. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos أو Max أو Min. القيمة الافتراضية NearestNeighbor.
- ST_Reskew - تغيّرت في: 2.1.0 تعمل على الرسترات التي ليس لها SRID تُعيد تشكيل رستر بضبط انحرافه (أو معاملات دورانه) فقط. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos. القيمة الافتراضية NearestNeighbor.
- ST_Segmentize - تغيّرت في: 2.1.0 نتيجة لإضافة دعم geography، فإن الاستخدام ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5) يسبب خطأ دالة ملتبسة. يجب تحديد نوع المُدخل بشكل صحيح على أنه geometry أو geography. استخدم ST_GeomFromText أو ST_GeogFromText أو تحويلًا إلى النوع المطلوب (مثل ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) ) تُعيد geometry/geography معدّلًا لا تزيد فيه أي قطعة عن مسافة مُعطاة.
- ST_Slope - تغيّرت في: 2.1.0 في الإصدارات السابقة كانت القيم المُعادة بالراديان. أصبحت القيم المُعادة الآن بالدرجات افتراضيًا تُعيد الانحدار (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_SnapToGrid - تغيّرت في: 2.1.0 تعمل على الرسترات التي ليس لها SRID تُعيد تشكيل رستر بالتقاطه إلى شبكة. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos. القيمة الافتراضية NearestNeighbor.
- ST_WorldToRasterCoordX - تغيّرت في: 2.1.0 في الإصدارات السابقة كانت تُسمّى ST_World2RasterCoordX تُعيد العمود في الرستر المقابل للشكل الهندسي النقطي (pt) أو لإحداثيَّي العالم X وY (xw، yw) المُمثَّلين في النظام المرجعي المكاني العالمي للرستر.
- ST_WorldToRasterCoordY - تغيّرت في: 2.1.0 في الإصدارات السابقة كانت تُسمّى ST_World2RasterCoordY تُعيد الصف في الرستر المقابل للشكل الهندسي النقطي (pt) أو لإحداثيَّي العالم X وY (xw، yw) المُمثَّلين في النظام المرجعي المكاني العالمي للرستر.
13.12.13. دوال PostGIS الجديدة أو المحسّنة في 2.0
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 2.0
- && - متاحة منذ: 2.0.0 تُعيد TRUE إذا كان المستطيل المحيط بـ A يتقاطع مع المستطيل المحيط بـ B.
- &&& - متاحة منذ: 2.0.0 تُعيد TRUE إذا تقاطع المستطيل المحيط متعدد الأبعاد (n-D) لـ A مع المستطيل المحيط متعدد الأبعاد لـ B.
- <#> - متاحة منذ: 2.0.0 -- KNN متاح فقط في PostgreSQL 9.1+ تُعيد المسافة ثنائية الأبعاد بين المستطيلين المحيطين لـ A وB.
- <-> - متاحة منذ: 2.0.0 -- يوفّر KNN الضعيف أقرب الجيران اعتمادًا على المسافات بين مراكز الأشكال الهندسية بدلًا من المسافات الحقيقية. النتائج دقيقة للنقاط وغير دقيقة لكل الأنواع الأخرى. متاح في PostgreSQL 9.1+ تُعيد المسافة ثنائية الأبعاد بين A وB.
- @ - متاحة منذ: 2.0.0 أُضيف raster @ raster وraster @ geometry تُعيد TRUE إذا كان المستطيل المحيط بـ A محتوى داخل المستطيل المحيط بـ B. تستخدم مستطيلًا محيطًا بدقة مضاعفة (double precision).
- @ - متاحة منذ: 2.0.5 أُضيف geometry @ raster تُعيد TRUE إذا كان المستطيل المحيط بـ A محتوى داخل المستطيل المحيط بـ B. تستخدم مستطيلًا محيطًا بدقة مضاعفة (double precision).
- AddEdge - متاحة منذ: 2.0.0 تضيف حافة خطية (LineString) إلى جدول الحواف، ونقطتي البداية والنهاية المرتبطتين بها إلى جدول العقد النقطية في مخطط الطوبولوجيا المحدد، باستخدام الشكل الهندسي الخطي المحدد، وتُعيد معرّف الحافة (edgeid) الجديدة (أو الموجودة).
- AddFace - متاحة منذ: 2.0.0 تسجّل عنصرًا أوليًا من نوع وجه في طوبولوجيا وتحصل على معرّفه.
- AddNode - متاحة منذ: 2.0.0 تضيف عقدة نقطية إلى جدول العقد في مخطط الطوبولوجيا المحدد وتُعيد معرّف العقدة الجديدة (nodeid). إذا كانت النقطة موجودة بالفعل كعقدة، يُعاد معرّف العقدة الموجودة.
- AddOverviewConstraints - متاحة منذ: 2.0.0 توسم عمود رستر بأنه عرض مُصغَّر (overview) لعمود آخر.
- AddRasterConstraints - متاحة منذ: 2.0.0 تُضيف قيود الرستر إلى جدول رستر محمَّل لعمود محدد، تقيّد النظام المرجعي المكاني، والمقياس، وحجم الكتلة، والمحاذاة، والنطاقات، ونوع النطاق، وعلامةً تدل على ما إذا كان عمود الرستر مقسّمًا إلى كتل منتظمة. يجب أن يكون الجدول محمَّلًا بالبيانات لكي يمكن استنتاج القيود. تُعيد true إذا نجح ضبط القيود، وتُصدر إشعارًا خلاف ذلك.
- AsGML - متاحة منذ: 2.0.0 تُعيد تمثيل GML لكائن TopoGeometry.
- CopyTopology - متاحة منذ: 2.0.0 تنشئ نسخة من طوبولوجيا (العقد والحواف والأوجه والطبقات وكائنات TopoGeometry) في مخطط جديد
- DropOverviewConstraints - متاحة منذ: 2.0.0 تُزيل وسم عمود رستر بأنه عرض مُصغَّر لعمود آخر.
- DropRasterConstraints - متاحة منذ: 2.0.0 تحذف قيود رستر PostGIS التي تشير إلى عمود في جدول رستر. مفيدة إذا احتجت إلى إعادة تحميل البيانات أو تحديث بيانات عمود الرستر.
- Drop_Indexes_Generate_Script - متاحة منذ: 2.0.0 تولّد سكربتًا يحذف جميع الفهارس غير المفتاح الأساسي وغير الفريدة في المخطط tiger والمخطط الذي يحدده المستخدم. يكون المخطط الافتراضي tiger_data إذا لم يُحدَّد مخطط.
- Drop_State_Tables_Generate_Script - متاحة منذ: 2.0.0 تولّد سكربتًا يحذف جميع الجداول في المخطط المحدد التي تُسبق أسماؤها باختصار الولاية. يكون المخطط الافتراضي tiger_data إذا لم يُحدَّد مخطط.
- Geocode_Intersection - متاحة منذ: 2.0.0 تأخذ شارعين متقاطعين وولاية ومدينة ورمزًا بريديًا، وتُخرج مجموعة من المواقع المحتملة على الشارع المتقاطع الأول عند التقاطع، وتتضمن أيضًا geomout كموقع النقطة بخطَّي الطول والعرض وفق NAD 83، وnormalized_address (addy) لكل موقع، والتقييم. كلما انخفض التقييم زادت احتمالية التطابق. تُرتَّب النتائج بدءًا بأدنى تقييم. ويمكن اختياريًا تمرير الحد الأقصى للنتائج، وقيمته الافتراضية 10. تستخدم بيانات Tiger (edges وfaces وaddr) ومطابقة السلاسل النصية التقريبية في PostgreSQL (soundex وlevenshtein).
- GetEdgeByPoint - متاحة منذ: 2.0.0 تبحث عن معرّف الحافة (edge-id) لحافة تتقاطع مع نقطة معطاة.
- GetFaceByPoint - متاحة منذ: 2.0.0 تبحث عن الوجه الذي يتقاطع مع نقطة معطاة.
- GetNodeByPoint - متاحة منذ: 2.0.0 تبحث عن معرّف العقدة (node-id) لعقدة عند موقع نقطي.
- GetNodeEdges - متاحة منذ: 2.0 تُعيد مجموعة مرتّبة من الحواف الملاقية للعقدة المعطاة.
- GetRingEdges - متاحة منذ: 2.0.0 تُعيد المجموعة المرتّبة من معرّفات الحواف ذات الإشارة التي تُصادَف عند السير على جانب معطى من حافة.
- GetTopoGeomElements - متاحة منذ: 2.0.0 تُعيد مجموعة من كائنات topoelement تحتوي على element_id وelement_type الطوبولوجيين لكائن TopoGeometry المعطى (العناصر الأولية).
- GetTopologySRID - متاحة منذ: 2.0.0 تُعيد قيمة SRID لطوبولوجيا في الجدول topology.topology بإعطائها اسم الطوبولوجيا.
- Get_Tract - متاحة منذ: 2.0.0 تُعيد المنطقة الإحصائية (census tract) أو حقلًا من الجدول tract للمكان الذي يقع فيه الشكل الهندسي. تُعيد افتراضيًا الاسم المختصر للمنطقة الإحصائية.
- Install_Missing_Indexes - متاحة منذ: 2.0.0 تعثر على جميع الجداول ذات الأعمدة الرئيسية المستخدمة في عمليات الربط وشروط الترشيح في المُرمِّز الجغرافي والتي تفتقر إلى فهارس على تلك الأعمدة، وتضيفها.
- Loader_Generate_Census_Script - متاحة منذ: 2.0.0 تولّد سكربت shell للمنصة المحددة وللولايات المحددة ينزّل جداول بيانات Tiger الإحصائية tract وbg وtabblocks للولاية، ويجهّزها ويحمّلها في المخطط tiger_data. يُعاد سكربت كل ولاية كسجل منفصل.
- Loader_Generate_Script - متاحة منذ: 2.0.0 لدعم بيانات Tiger 2010 المهيكلة وتحميل جداول المناطق الإحصائية (tract) ومجموعات الكتل (bg) والكتل (tabblocks). تولّد سكربت shell للمنصة المحددة وللولايات المحددة ينزّل بيانات Tiger ويجهّزها ويحمّلها في المخطط tiger_data. يُعاد سكربت كل ولاية كسجل منفصل. يدعم أحدث إصدار التغييرات البنيوية في Tiger 2010، ويحمّل أيضًا جداول المناطق الإحصائية ومجموعات الكتل والكتل.
- Missing_Indexes_Generate_Script - متاحة منذ: 2.0.0 تعثر على جميع الجداول ذات الأعمدة الرئيسية المستخدمة في عمليات الربط في المُرمِّز الجغرافي والتي تفتقر إلى فهارس على تلك الأعمدة، وتُخرج تعليمات SQL DDL لتعريف الفهارس لتلك الجداول.
- Polygonize - متاحة منذ: 2.0.0 تبحث عن جميع الأوجه المعرّفة بحواف الطوبولوجيا وتسجّلها.
- Reverse_Geocode - متاحة منذ: 2.0.0 تأخذ نقطة geometry في نظام مرجعي مكاني معروف وتُعيد سجلًا يحتوي على مصفوفة من العناوين الممكنة نظريًا ومصفوفة من الشوارع المتقاطعة. إذا كانت include_strnum_range = true فإنها تُدرج نطاق أرقام الشارع في الشوارع المتقاطعة.
- ST_3DClosestPoint - متاحة منذ: 2.0.0 تُعيد النقطة ثلاثية الأبعاد على g1 الأقرب إلى g2. وهي النقطة الأولى من أقصر خط ثلاثي الأبعاد.
- ST_3DDFullyWithin - متاحة منذ: 2.0.0 تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد يقعان بالكامل ضمن مسافة ثلاثية الأبعاد معيّنة
- ST_3DDWithin - متاحة منذ: 2.0.0 تختبر ما إذا كان شكلان هندسيان ثلاثيا الأبعاد ضمن مسافة ثلاثية الأبعاد معيّنة
- ST_3DDistance - متاحة منذ: 2.0.0 تُعيد أقل مسافة ديكارتية ثلاثية الأبعاد (بناءً على النظام المرجعي المكاني) بين شكلين بوحدات الإسقاط.
- ST_3DIntersects - متاحة منذ: 2.0.0 تختبر ما إذا كان شكلان هندسيان يتقاطعان مكانيًا في الأبعاد الثلاثية - فقط للنقاط والخطوط والمضلعات والأسطح متعددة الوجوه (المساحة)
- ST_3DLongestLine - متاحة منذ: 2.0.0 تُعيد أطول خط ثلاثي الأبعاد بين شكلين
- ST_3DMaxDistance - متاحة منذ: 2.0.0 تُعيد المسافة الديكارتية القصوى ثلاثية الأبعاد (بحسب النظام المرجعي المكاني) بين شكلين هندسيين بوحدات الإسقاط.
- ST_3DShortestLine - متاحة منذ: 2.0.0 تُعيد أقصر خط ثلاثي الأبعاد بين شكلين هندسيين
- ST_AddEdgeModFace - متاحة منذ: 2.0 تضيف حافة جديدة، وإذا أدى ذلك إلى تقسيم وجه، تعدّل الوجه الأصلي وتضيف وجهًا جديدًا.
- ST_AddEdgeNewFaces - متاحة منذ: 2.0 تضيف حافة جديدة، وإذا أدى ذلك إلى تقسيم وجه، تحذف الوجه الأصلي وتستبدله بوجهين جديدين.
- ST_AsGDALRaster - متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0. تُعيد بلاطة الرستر بصيغة رستر GDAL المحددة. صيغ الرستر هي إحدى الصيغ التي تدعمها المكتبة المُترجَمة لديك. استخدم ST_GDALDrivers() للحصول على قائمة بالصيغ التي تدعمها مكتبتك.
- ST_AsJPEG - متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0. تُعيد النطاقات المحددة من بلاطة الرستر كصورة واحدة بصيغة Joint Photographic Exports Group (JPEG) (مصفوفة بايتات). إذا لم يُحدَّد نطاق وكان هناك نطاق واحد أو أكثر من 3 نطاقات، فيُستخدم النطاق الأول فقط. وإذا كانت هناك 3 نطاقات فقط فتُستخدم النطاقات الثلاثة جميعًا وتُربط بـ RGB.
- ST_AsLatLonText - متاحة منذ: 2.0 تُعيد تمثيل الدرجات والدقائق والثواني للنقطة المعطاة.
- ST_AsPNG - متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0. تُعيد النطاقات المحددة من بلاطة الرستر كصورة واحدة بصيغة Portable Network Graphics (PNG) (مصفوفة بايتات). إذا كان في الرستر 1 أو 3 أو 4 نطاقات ولم تُحدَّد نطاقات، فتُستخدم جميع النطاقات. وإذا كان هناك نطاقان أو أكثر من 4 نطاقات ولم تُحدَّد نطاقات، فيُستخدم النطاق 1 فقط. تُربط النطاقات بفضاء RGB أو RGBA.
- ST_AsRaster - متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0. تحوّل شكلًا هندسيًا (geometry) في PostGIS إلى رستر PostGIS.
- ST_AsTIFF - متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0. تُعيد النطاقات المحددة من الرستر كصورة TIFF واحدة (مصفوفة بايتات). إذا لم يُحدَّد نطاق أو كان أي من النطاقات المحددة غير موجود في الرستر، فستحاول استخدام جميع النطاقات.
- ST_AsX3D - متاحة منذ: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML تُعيد شكلًا هندسيًا بصيغة عنصر عقدة X3D xml: ISO-IEC-19776-1.2-X3DEncodings-XML
- ST_Aspect - متاحة منذ: 2.0.0 تُعيد الاتجاه (Aspect) (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_Band - متاحة منذ: 2.0.0 تُعيد نطاقًا أو أكثر من رستر موجود في صورة رستر جديد. مفيدة لبناء رسترات جديدة من رسترات موجودة.
- ST_BandIsNoData - متاحة منذ: 2.0.0 تُعيد true إذا كان النطاق ممتلئًا بقيم nodata فقط.
- ST_Clip - متاحة منذ: 2.0.0 تُعيد الرستر مقصوصًا بالشكل الهندسي المُدخل. إذا لم يُحدَّد رقم النطاق، فتُعالَج جميع النطاقات. إذا لم يُحدَّد crop أو كان TRUE، فيُقتطع الرستر الناتج. إذا ضُبط touched على TRUE، فتُضمَّن البكسلات الملامِسة، وإلا فلا يُضمَّن البكسل إلا إذا وقع مركزه داخل الشكل الهندسي.
- ST_CollectionHomogenize - متاحة منذ: 2.0.0 تُعيد أبسط تمثيل لمجموعة أشكال.
- ST_ConcaveHull - متاحة منذ: 2.0.0 تحسب شكلاً هندسياً قد يكون مقعّراً يحتوي على جميع رؤوس الشكل المُدخل
- ST_Count - متاحة منذ: 2.0.0 تُعيد عدد البكسلات في نطاق معيّن من رستر أو تغطية رستر. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. إذا ضُبط exclude_nodata_value على true، فستُعدّ فقط البكسلات غير المساوية لقيمة nodata.
- ST_CreateTopoGeo - متاحة منذ: 2.0 تضيف مجموعة من الأشكال الهندسية إلى طوبولوجيا فارغة معطاة وتُعيد رسالة توضّح نجاح العملية.
- ST_Distinct4ma - متاحة منذ: 2.0.0 دالة معالجة رستر تحسب عدد قيم البكسلات الفريدة في جوار.
- ST_FlipCoordinates - متاحة منذ: 2.0.0 تُعيد نسخة من الشكل الهندسي مع تبديل المحورين X وY.
- ST_GDALDrivers - متاحة منذ: 2.0.0 - تتطلب GDAL >= 1.6.0. تُعيد قائمة بصيغ الرستر التي يدعمها PostGIS عبر GDAL. لا يمكن استخدام سوى الصيغ ذات can_write=True مع ST_AsGDALRaster
- ST_GeomFromGeoJSON - متاحة منذ: 2.0.0 تتطلب JSON-C >= 0.9 تأخذ تمثيل GeoJSON لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GetFaceEdges - متاحة منذ: 2.0 تُعيد مجموعة مرتّبة من الحواف التي تحدّ aface.
- ST_HasNoBand - متاحة منذ: 2.0.0 تُعيد true إذا لم يوجد نطاق برقم النطاق المحدد. إذا لم يُحدَّد رقم نطاق، يُفترض رقم النطاق 1.
- ST_HillShade - متاحة منذ: 2.0.0 تُعيد الإضاءة الافتراضية لنطاق رستر ارتفاعات باستخدام مُدخلات السمت والارتفاع والسطوع والمقياس المُعطاة.
- ST_Histogram - متاحة منذ: 2.0.0 تُعيد مجموعة من السجلات تلخّص توزيع بيانات رستر أو تغطية رستر على فئات (bins) منفصلة. يُحسب عدد الفئات تلقائيًا إذا لم يُحدَّد.
- ST_InterpolatePoint - متاحة منذ: 2.0.0 تُعيد القياس المُستكمَل لشكل هندسي عند أقرب موقع إلى نقطة.
- ST_IsEmpty - متاحة منذ: 2.0.0 تُعيد true إذا كان الرستر فارغًا (العرض = 0 والارتفاع = 0)، وإلا تُعيد false.
- ST_IsValidDetail - متاحة منذ: 2.0.0 تُعيد صفًا من نوع valid_detail يبيّن ما إذا كان الشكل الهندسي صالحًا، وإن لم يكن فالسبب والموقع.
- ST_IsValidReason - متاحة منذ: 2.0 النسخة التي تأخذ flags. تُعيد نصًا يبيّن ما إذا كان الشكل الهندسي صالحًا، أو سبب عدم صلاحيته.
- ST_MakeLine - متاحة منذ: 2.0.0 - أُضيف دعم عناصر الإدخال من نوع LineString تُنشئ خطًا (LineString) من أشكال هندسية من نوع Point أو MultiPoint أو LineString.
- ST_MakeValid - متاحة منذ: 2.0.0 تحاول جعل شكل هندسي غير صالح صالحًا دون فقدان أي رؤوس.
- ST_MapAlgebraExpr - متاحة منذ: 2.0.0 نسخة نطاق رستر واحد: تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق عملية جبرية صالحة في PostgreSQL على نطاق الرستر المُدخل وبنوع البكسل المقدَّم. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_MapAlgebraExpr - متاحة منذ: 2.0.0 نسخة نطاقي رستر: تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق عملية جبرية صالحة في PostgreSQL على نطاقي الرسترين المُدخلين وبنوع البكسل المقدَّم. يُفترض النطاق 1 من كل رستر إذا لم تُحدَّد أرقام النطاقات. سيُحاذى الرستر الناتج (المقياس والانحراف وأركان البكسلات) على الشبكة التي يعرّفها الرستر الأول، ويتحدد امتداده بالمعامل «extenttype». يمكن أن تكون قيم «extenttype»: INTERSECTION وUNION وFIRST وSECOND.
- ST_MapAlgebraFct - متاحة منذ: 2.0.0 نسخة النطاق الواحد - تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق دالة PostgreSQL صالحة على نطاق الرستر المُدخل وبنوع البكسل المقدَّم. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_MapAlgebraFct - متاحة منذ: 2.0.0 نسخة النطاقين - تُنشئ رسترًا جديدًا بنطاق واحد يتكون بتطبيق دالة PostgreSQL صالحة على نطاقي الرسترين المُدخلين وبنوع البكسل المقدَّم. يُفترض النطاق 1 إذا لم يُحدَّد نطاق. نوع الامتداد الافتراضي هو INTERSECTION إذا لم يُحدَّد.
- ST_MapAlgebraFctNgb - متاحة منذ: 2.0.0 نسخة النطاق الواحد: جبر الخرائط بالجار الأقرب باستخدام دالة PostgreSQL يعرّفها المستخدم. تُعيد رسترًا تكون قيمه ناتج دالة مستخدم بلغة PLPGSQL تتضمن جوارًا من القيم من نطاق الرستر المُدخل.
- ST_Max4ma - متاحة منذ: 2.0.0 دالة معالجة رستر تحسب القيمة العظمى للبكسلات في جوار.
- ST_Mean4ma - متاحة منذ: 2.0.0 دالة معالجة رستر تحسب متوسط قيم البكسلات في جوار.
- ST_Min4ma - متاحة منذ: 2.0.0 دالة معالجة رستر تحسب القيمة الدنيا للبكسلات في جوار.
- ST_ModEdgeHeal - متاحة منذ: 2.0 تدمج حافتين بحذف العقدة التي تصل بينهما، مع تعديل الحافة الأولى وحذف الحافة الثانية. تُعيد معرّف العقدة المحذوفة.
- ST_MoveIsoNode - متاحة منذ: 2.0.0 تنقل عقدة معزولة في طوبولوجيا من نقطة إلى أخرى. إذا كان الشكل الهندسي apoint الجديد موجودًا كعقدة فسيُطلق خطأ. تُعيد وصفًا لعملية النقل.
- ST_NewEdgeHeal - متاحة منذ: 2.0 تدمج حافتين بحذف العقدة التي تصل بينهما، وحذف الحافتين كلتيهما، واستبدالهما بحافة اتجاهها مماثل لاتجاه الحافة الأولى المعطاة.
- ST_Node - متاحة منذ: 2.0.0 تُنشئ العُقد لمجموعة من الخطوط.
- ST_NumPatches - متاحة منذ: 2.0.0 تُعيد عدد الوجوه في سطح متعدد الوجوه. وتُعيد null للأشكال الهندسية غير متعددة الوجوه.
- ST_OffsetCurve - متاحة منذ: 2.0 تُعيد خطاً مُزاحاً على مسافة وجانب معيّنين من خط مُدخل.
- ST_PatchN - متاحة منذ: 2.0.0 تُعيد الشكل الهندسي (الوجه) رقم N من سطح متعدد الوجوه (PolyhedralSurface).
- ST_Perimeter - متاحة منذ 2.0.0: أُضيف دعم geography تُعيد طول حدود شكل مضلعي من نوع geometry أو geography.
- ST_PixelAsPolygon - متاحة منذ: 2.0.0 تُعيد الشكل الهندسي المضلع الذي يحدّ البكسل لصف وعمود معينين.
- ST_PixelAsPolygons - متاحة منذ: 2.0.0 تُعيد الشكل الهندسي المضلع الذي يحدّ كل بكسل في نطاق رستر مع القيمة وإحداثيَّي الرستر X وY لكل بكسل.
- ST_Project - متاحة منذ: 2.0.0 تُعيد نقطة مُسقطة من نقطة بداية بمسافة واتجاه (سمت).
- ST_Quantile - متاحة منذ: 2.0.0 تحسب الكميّات (quantiles) لرستر أو لتغطية جدول رستر في سياق العينة أو المجتمع الإحصائي. وبذلك يمكن فحص ما إذا كانت قيمة ما تقع عند المئين 25% أو 50% أو 75% من الرستر.
- ST_Range4ma - متاحة منذ: 2.0.0 دالة معالجة رستر تحسب مدى قيم البكسلات في جوار.
- ST_Reclass - متاحة منذ: 2.0.0 تُنشئ رسترًا جديدًا يتكون من أنواع نطاقات مُعاد تصنيفها من الأصل. nband هو النطاق المراد تغييره. إذا لم يُحدَّد nband فيُفترض أنه 1. تُعاد جميع النطاقات الأخرى دون تغيير. حالة الاستخدام: تحويل نطاق 16BUI إلى 8BUI وما إلى ذلك لتسهيل العرض بصيغ قابلة للعرض.
- ST_RelateMatch - متاحة منذ: 2.0.0 تختبر ما إذا كانت مصفوفة تقاطع DE-9IM تطابق نمط مصفوفة تقاطع
- ST_RemEdgeModFace - متاحة منذ: 2.0 تزيل حافة، وإذا كانت الحافة تفصل بين وجهين، تحذف أحد الوجهين وتعدّل الوجه الآخر ليغطي مساحة كليهما.
- ST_RemEdgeNewFace - متاحة منذ: 2.0 تزيل حافة، وإذا كانت الحافة المزالة تفصل بين وجهين، تحذف الوجهين الأصليين وتستبدلهما بوجه جديد.
- ST_Resample - متاحة منذ: 2.0.0 تتطلب GDAL 1.6.1+ تُعيد تشكيل (resample) رستر باستخدام خوارزمية إعادة تشكيل محددة، وأبعاد جديدة، وزاوية شبكة عشوائية، ومجموعة من سمات الإسناد الجغرافي للرستر معرَّفة أو مستعارة من رستر آخر.
- ST_Rescale - متاحة منذ: 2.0.0 تتطلب GDAL 1.6.1+ تُعيد تشكيل رستر بضبط مقياسه (أو حجم بكسله) فقط. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos أو Max أو Min. القيمة الافتراضية NearestNeighbor.
- ST_Reskew - متاحة منذ: 2.0.0 تتطلب GDAL 1.6.1+ تُعيد تشكيل رستر بضبط انحرافه (أو معاملات دورانه) فقط. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos. القيمة الافتراضية NearestNeighbor.
- ST_SameAlignment - متاحة منذ: 2.0.0 تُعيد true إذا كان للرسترات الميل والمقياس والمرجع المكاني والإزاحة نفسها (بحيث يمكن وضع البكسلات على الشبكة نفسها دون قطع البكسلات)، وتُعيد false إذا لم تكن كذلك مع إشعار يوضح المشكلة.
- ST_SetBandIsNoData - متاحة منذ: 2.0.0 تضبط علامة isnodata للنطاق على TRUE.
- ST_SharedPaths - متاحة منذ: 2.0.0 تُعيد مجموعة تحتوي على المسارات المشتركة بين الخطين/الخطين المتعددين المُدخلين.
- ST_Slope - متاحة منذ: 2.0.0 تُعيد الانحدار (بالدرجات افتراضيًا) لنطاق رستر ارتفاعات. مفيدة لتحليل التضاريس.
- ST_Snap - متاحة منذ: 2.0.0 التقاط قطع الشكل المُدخل ورؤوسه إلى رؤوس شكل مرجعي.
- ST_SnapToGrid - متاحة منذ: 2.0.0 تتطلب GDAL 1.6.1+ تُعيد تشكيل رستر بالتقاطه إلى شبكة. تُحسب قيم البكسلات الجديدة باستخدام خوارزمية إعادة التشكيل NearestNeighbor (بالتهجئة الإنجليزية أو الأمريكية) أو Bilinear أو Cubic أو CubicSpline أو Lanczos. القيمة الافتراضية NearestNeighbor.
- ST_Split - متاحة منذ: 2.0.0 تتطلب GEOS تُعيد مجموعة من الأشكال الهندسية الناتجة عن تقسيم شكل هندسي بشكل آخر.
- ST_StdDev4ma - متاحة منذ: 2.0.0 دالة معالجة رستر تحسب الانحراف المعياري لقيم البكسلات في جوار.
- ST_Sum4ma - متاحة منذ: 2.0.0 دالة معالجة رستر تحسب مجموع جميع قيم البكسلات في جوار.
- ST_SummaryStats - متاحة منذ: 2.0.0 تُعيد summarystats المكوّنة من count وsum وmean وstddev وmin وmax لنطاق رستر معيّن من رستر أو تغطية رستر. يُفترض النطاق 1 إذا لم يُحدَّد نطاق.
- ST_Transform - متاحة منذ: 2.0.0 تتطلب GDAL 1.6.1+ تُعيد إسقاط رستر من نظام مرجعي مكاني معروف إلى نظام مرجعي مكاني معروف آخر باستخدام خوارزمية إعادة اعتيان محددة. الخيارات هي NearestNeighbor وBilinear وCubic وCubicSpline وLanczos، والافتراضي NearestNeighbor.
- ST_UnaryUnion - متاحة منذ: 2.0.0 تحسب اتحاد مكوّنات شكل هندسي واحد.
- ST_Union - متاحة منذ: 2.0.0 تُعيد اتحاد مجموعة من بلاطات الرستر في رستر واحد يتكون من نطاق واحد أو أكثر.
- ST_ValueCount - متاحة منذ: 2.0.0 تُعيد مجموعة من السجلات تحتوي على قيمة نطاق البكسل وعدد البكسلات في نطاق معيّن من رستر (أو تغطية رستر) التي تملك مجموعة معيّنة من القيم. إذا لم يُحدَّد نطاق فالافتراضي هو النطاق 1. افتراضيًا لا تُعدّ البكسلات ذات قيمة nodata، وتُخرَج جميع القيم الأخرى في البكسل، وتُقرَّب قيم نطاق البكسل إلى أقرب عدد صحيح.
- TopoElementArray_Agg - متاحة منذ: 2.0.0 تُعيد topoelementarray لمجموعة من مصفوفات element_id وtype (عناصر طوبولوجية).
- TopoGeo_AddLineString - متاحة منذ: 2.0.0 تضيف خطًا (LineString) إلى طوبولوجيا موجودة باستخدام تسامح، مع احتمال تقسيم حواف/أوجه موجودة.
- TopoGeo_AddPoint - متاحة منذ: 2.0.0 تضيف نقطة إلى طوبولوجيا موجودة باستخدام تسامح، مع احتمال تقسيم حافة موجودة.
- TopoGeo_AddPolygon - متاحة منذ: 2.0.0 تضيف مضلعًا إلى طوبولوجيا موجودة باستخدام تسامح، مع احتمال تقسيم حواف/أوجه موجودة. تُعيد معرّفات الأوجه.
- TopologySummary - متاحة منذ: 2.0.0 تأخذ اسم طوبولوجيا وتقدّم مجاميع موجزة لأنواع الكائنات في الطوبولوجيا.
- Topology_Load_Tiger - متاحة منذ: 2.0.0 تحمّل منطقة محددة من بيانات tiger إلى طوبولوجيا PostGIS، مع تحويل بيانات tiger إلى النظام المرجعي المكاني للطوبولوجيا والتقاطها وفق تسامح الدقة الخاصة بالطوبولوجيا.
- toTopoGeom - متاحة منذ: 2.0 تحوّل شكلًا هندسيًا بسيطًا إلى TopoGeometry.
- ~ - متاحة منذ: 2.0.0 تُعيد TRUE إذا كان المستطيل المحيط بـ A يحتوي المستطيل المحيط بـ B. تستخدم مستطيلًا محيطًا بدقة مضاعفة (double precision).
- ~= - متاحة منذ: 2.0.0 تُعيد TRUE إذا كان المستطيل المحيط لـ A مطابقًا للمستطيل المحيط لـ B.
الدوال المحسّنة في PostGIS 2.0
- && - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد لـ A مع المستطيل المحيط ثنائي الأبعاد لـ B.
- AddGeometryColumn - حُسّنت في: 2.0.0 أُضيف الوسيط use_typmod. ويكون الافتراضي إنشاء عمود geometry بـ typmod بدلًا من العمود المعتمد على القيود. تضيف عمود geometry إلى جدول موجود.
- Box2D - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد BOX2D يمثل الامتداد ثنائي الأبعاد للشكل الهندسي.
- Box3D - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد BOX3D يمثل الامتداد ثلاثي الأبعاد للشكل الهندسي.
- CreateTopology - حُسّنت في: 2.0 أُضيفت الصيغة التي تقبل hasZ تُنشئ مخطط طوبولوجيا جديدًا وتسجّله في الجدول topology.topology.
- Geocode - حُسّنت في: 2.0.0 لدعم بيانات Tiger 2010 المهيكلة، ونُقّح بعض المنطق لتحسين سرعة الترميز الجغرافي ودقته، ولإزاحة النقطة من خط المنتصف إلى جانب الشارع الذي يقع عليه العنوان. والمعامل الجديد max_results مفيد لتحديد عدد أفضل النتائج أو لإعادة أفضل نتيجة فقط. تأخذ عنوانًا كسلسلة نصية (أو عنوانًا موحَّدًا آخر) وتُخرج مجموعة من المواقع المحتملة تتضمن شكلًا هندسيًا نقطيًا بخطَّي الطول والعرض وفق NAD 83، وعنوانًا موحَّدًا لكل موقع، والتقييم. كلما انخفض التقييم زادت احتمالية التطابق. تُرتَّب النتائج بدءًا بأدنى تقييم. ويمكن اختياريًا تمرير الحد الأقصى للنتائج، وقيمته الافتراضية 10، وrestrict_region (قيمته الافتراضية NULL)
- GeometryType - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد نوع الشكل الهندسي كنص.
- Populate_Geometry_Columns - حُسّنت في: 2.0.0 أُضيف الوسيط الاختياري use_typmod الذي يتيح التحكم في ما إذا كانت الأعمدة تُنشأ بمُعدِّلات نوع أو بقيود تحقق. تضمن تعريف أعمدة geometry بمُعدِّلات نوع أو احتواءها على قيود مكانية مناسبة.
- ST_3DExtent - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. دالة تجميعية تُعيد المستطيل المحيط ثلاثي الأبعاد بالأشكال الهندسية.
- ST_Affine - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تطبّق تحويلًا تآلفيًا ثلاثي الأبعاد على شكل هندسي.
- ST_Area - حُسّنت في: 2.0.0 - أُضيف دعم الأسطح متعددة الأوجه ثنائية الأبعاد. تُعيد مساحة شكل هندسي مضلعي.
- ST_AsBinary - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsBinary - حُسّنت في: 2.0.0 أُضيف دعم أبعاد الإحداثيات الأعلى. تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsBinary - حُسّنت في: 2.0.0 أُضيف دعم تحديد ترتيب البايتات (endian) مع geography. تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsEWKB - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد تمثيل الثنائي المعروف الموسَّع (EWKB) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsEWKT - حُسّنت في: 2.0.0 أُضيف دعم Geography والأسطح متعددة الوجوه (Polyhedral surfaces) والمثلثات (Triangles) وTIN. تُعيد تمثيل النص المعروف (WKT) للشكل الهندسي مع بيانات SRID الوصفية.
- ST_AsGML - حُسّنت في: 2.0.0 أُضيف دعم البادئة. وأُضيف الخيار 4 لـ GML3 للسماح باستخدام الوسم LineString بدلًا من Curve للخطوط. وأُضيف دعم GML3 للأسطح متعددة الوجوه (Polyhedral surfaces) وTINS. وأُضيف الخيار 32 لإخراج المستطيل المحيط. تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsKML - حُسّنت في: 2.0.0 - إضافة بادئة مساحة الأسماء، واستخدام الوسائط الافتراضية والمسمّاة تُعيد الشكل الهندسي كعنصر KML.
- ST_Azimuth - حُسّنت في: 2.0.0 أُضيف دعم geography. تُعيد السمت المرجعي إلى الشمال لخط بين نقطتين.
- ST_Dimension - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه وTIN. ولم تعد تُطلق استثناءً عند إعطائها شكلًا هندسيًا فارغًا. تُعيد البُعد الطوبولوجي للشكل الهندسي.
- ST_Dump - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد مجموعة من صفوف geometry_dump لمكونات الشكل الهندسي.
- ST_DumpPoints - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد مجموعة من صفوف geometry_dump للإحداثيات في الشكل الهندسي.
- ST_Expand - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد مستطيلًا محيطًا موسّعًا من مستطيل محيط آخر أو من شكل هندسي.
- ST_Extent - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. دالة تجميعية تُعيد المستطيل المحيط بالأشكال الهندسية.
- ST_Force2D - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. فرض "الوضع ثنائي الأبعاد" على الأشكال الهندسية.
- ST_Force3D - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. فرض وضع XYZ على الأشكال الهندسية. وهي اسم بديل لـ ST_Force3DZ.
- ST_Force3DZ - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. فرض وضع XYZ على الأشكال الهندسية.
- ST_ForceCollection - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. تحويل الشكل الهندسي إلى GEOMETRYCOLLECTION.
- ST_ForceRHR - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. فرض اتباع اتجاه رؤوس المضلع لقاعدة اليد اليمنى.
- ST_GMLToSQL - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه (Polyhedral surfaces) وTIN. تُعيد قيمة ST_Geometry محددة من تمثيل GML. هذه الدالة اسم بديل لـ ST_GeomFromGML
- ST_GMLToSQL - حُسّنت في: 2.0.0 أُضيف الوسيط الاختياري srid الافتراضي. تُعيد قيمة ST_Geometry محددة من تمثيل GML. هذه الدالة اسم بديل لـ ST_GeomFromGML
- ST_GeomFromEWKB - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه (Polyhedral surfaces) وTIN. تُعيد قيمة ST_Geometry محددة من تمثيل الثنائي المعروف الموسّع (EWKB).
- ST_GeomFromEWKT - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه (Polyhedral surfaces) وTIN. تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف الموسّع (EWKT).
- ST_GeomFromGML - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه (Polyhedral surfaces) وTIN. تأخذ تمثيل GML لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeomFromGML - حُسّنت في: 2.0.0 أُضيف الوسيط الاختياري srid الافتراضي. تأخذ تمثيل GML لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeometryN - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد عنصرًا من مجموعة أشكال هندسية.
- ST_GeometryType - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. تُعيد نوع SQL-MM للشكل الهندسي كنص.
- ST_IsClosed - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. تختبر ما إذا كانت نقطتا بداية الخط (LineString) ونهايته متطابقتين. وبالنسبة إلى السطح متعدد الوجوه (PolyhedralSurface) تختبر ما إذا كان مغلقًا (حجميًا).
- ST_MakeEnvelope - حُسّنت في: 2.0: أُضيفت إمكانية تحديد غلاف دون تحديد SRID. تُنشئ مضلعًا مستطيلًا من الإحداثيات الدنيا والقصوى.
- ST_MakeValid - حُسّنت في: 2.0.1، تحسينات في السرعة تحاول جعل شكل هندسي غير صالح صالحًا دون فقدان أي رؤوس.
- ST_NPoints - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. تُعيد عدد النقاط (الرؤوس) في الشكل الهندسي.
- ST_NumGeometries - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُعيد عدد العناصر في مجموعة أشكال هندسية.
- ST_Relate - حُسّنت في: 2.0.0 - أُضيف دعم تحديد قاعدة عُقد الحدود. تختبر ما إذا كان لشكلين هندسيين علاقة طوبولوجية تطابق نمط مصفوفة تقاطع، أو تحسب مصفوفة التقاطع الخاصة بهما
- ST_Rotate - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُدير شكلًا هندسيًا حول نقطة أصل.
- ST_Rotate - حُسّنت في: 2.0.0 أُضيفت معاملات إضافية لتحديد أصل الدوران. تُدير شكلًا هندسيًا حول نقطة أصل.
- ST_RotateX - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُدير شكلًا هندسيًا حول المحور X.
- ST_RotateY - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُدير شكلًا هندسيًا حول المحور Y.
- ST_RotateZ - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تُدير شكلًا هندسيًا حول المحور Z.
- ST_Scale - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN. تغيّر مقياس شكل هندسي بمعاملات معيّنة.
- ST_ShiftLongitude - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه (Polyhedral surfaces) وTIN. تُزيح إحداثيات خطوط الطول في شكل هندسي بين -180..180 و0..360.
- ST_Summary - حُسّنت في: 2.0.0 أُضيف دعم geography تُعيد ملخصًا نصيًا لمحتويات الشكل الهندسي.
- ST_Transform - حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه. تُعيد شكلًا هندسيًا جديدًا بإحداثيات محوّلة إلى نظام مرجعي مكاني مختلف.
- ST_Value - حُسّنت في: 2.0.0 أُضيف الوسيط الاختياري exclude_nodata_value. تُعيد قيمة نطاق معيّن في بكسل معيّن (columnx، rowy) أو عند نقطة هندسية معينة. يبدأ ترقيم النطاقات من 1 ويُفترض 1 إذا لم يُحدَّد. إذا ضُبط exclude_nodata_value على false، فإن جميع البكسلات بما فيها بكسلات nodata تُعدّ متقاطعة وتُعيد قيمة. وإذا لم يُمرَّر exclude_nodata_value، فتُقرأ قيمته من البيانات الوصفية للرستر.
- ValidateTopology - حُسّنت في: 2.0.0 كشف أكثر كفاءة لعبور الحواف، وإصلاحات للنتائج الإيجابية الخاطئة التي كانت موجودة في الإصدارات السابقة. تُعيد مجموعة من كائنات validatetopology_returntype تفصّل المشكلات في الطوبولوجيا.
الدوال المتغيّرة في PostGIS 2.0
- AddGeometryColumn - تغيّرت في: 2.0.0 لم تعد هذه الدالة تحدّث geometry_columns لأن geometry_columns أصبح عرضًا (view) يقرأ من فهارس النظام. كما أنها افتراضيًا لا تُنشئ قيودًا، بل تستخدم سلوك مُعدِّل النوع (type modifier) المضمّن في PostgreSQL. فمثلًا، أصبح بناء عمود POINT بنظام wgs84 بهذه الدالة مكافئًا لـ: ALTER TABLE some_table ADD COLUMN geom geometry(Point,4326); تضيف عمود geometry إلى جدول موجود.
- AddGeometryColumn - تغيّرت في: 2.0.0 إذا احتجت إلى السلوك القديم المعتمد على القيود، فاستخدم الوسيط الافتراضي use_typmod لكن اضبطه على false. تضيف عمود geometry إلى جدول موجود.
- AddGeometryColumn - تغيّرت في: 2.0.0 لم يعد بالإمكان تسجيل العروض (views) يدويًا في geometry_columns، لكن العروض المبنية على أشكال جداول ذات typmod والمستخدمة دون دوال تغليف ستسجّل نفسها تلقائيًا بشكل صحيح لأنها ترث سلوك typmod من عمود الجدول الأصلي. أما العروض التي تستخدم دوال هندسية تُخرج أشكالًا أخرى فستحتاج إلى تحويلها (cast) إلى أشكال typmod كي تُسجَّل أعمدة geometry في هذه العروض بشكل صحيح في geometry_columns. راجع . تضيف عمود geometry إلى جدول موجود.
- Box3D - تغيّرت في: 2.0.0 في الإصدارات السابقة لـ 2.0 كان يُستخدم box2d بدلًا من box3d. ولأن box2d نوع مهمل، فقد تغيّر إلى box3d. تُعيد تمثيل box3d للصندوق المحيط بالرستر.
- DropGeometryColumn - تغيّرت في: 2.0.0 هذه الدالة متوفرة للتوافق الرجعي. فبما أن geometry_columns أصبح الآن عرضًا (view) على فهارس النظام، يمكنك حذف عمود geometry مثل أي عمود آخر في الجدول باستخدام ALTER TABLE تحذف عمود geometry من جدول مكاني.
- DropGeometryTable - تغيّرت في: 2.0.0 هذه الدالة متوفرة للتوافق الرجعي. فبما أن geometry_columns أصبح الآن عرضًا (view) على فهارس النظام، يمكنك حذف جدول يحتوي على أعمدة geometry مثل أي جدول آخر باستخدام DROP TABLE تحذف جدولًا وجميع مراجعه في geometry_columns.
- Populate_Geometry_Columns - تغيّرت في: 2.0.0 أصبحت افتراضيًا تستخدم مُعدِّلات النوع بدلًا من قيود التحقق لتقييد أنواع الأشكال الهندسية. ولا يزال بإمكانك استخدام سلوك قيود التحقق بدلًا من ذلك باستخدام الوسيط الجديد use_typmod وضبطه على false. تضمن تعريف أعمدة geometry بمُعدِّلات نوع أو احتواءها على قيود مكانية مناسبة.
- ST_3DExtent - تغيّرت في: 2.0.0 في الإصدارات السابقة كانت تُسمّى ST_Extent3D دالة تجميعية تُعيد المستطيل المحيط ثلاثي الأبعاد بالأشكال الهندسية.
- ST_3DLength - تغيّرت في: 2.0.0 في الإصدارات السابقة كانت تُسمّى ST_Length3D تُعيد الطول ثلاثي الأبعاد لشكل هندسي خطي.
- ST_3DMakeBox - تغيّرت في: 2.0.0 في الإصدارات السابقة كانت تُسمّى ST_MakeBox3D تُنشئ BOX3D معرّفًا بنقطتين ثلاثيتي الأبعاد.
- ST_3DPerimeter - تغيّرت في: 2.0.0 كانت تُسمّى في الإصدارات السابقة ST_Perimeter3D تُعيد المحيط ثلاثي الأبعاد لشكل هندسي مضلعي.
- ST_AsBinary - تغيّرت في: 2.0.0 لا يمكن أن تكون مدخلات هذه الدالة من نوع غير معروف (unknown) -- يجب أن تكون geometry. لم تعد تراكيب مثل ST_AsBinary('POINT(1 2)') صالحة، وستحصل على الخطأ n st_asbinary(unknown) is not unique error. يجب تغيير شيفرة كهذه إلى ST_AsBinary('POINT(1 2)'::geometry);. وإن لم يكن ذلك ممكنًا، فثبّت legacy.sql. تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsGML - تغيّرت في: 2.0.0 استخدام الوسائط المسمّاة الافتراضية تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsGeoJSON - تغيّرت في: 2.0.0 دعم الوسائط الافتراضية والوسائط المسمّاة. تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_AsSVG - تغيّرت في: 2.0.0 لاستخدام الوسائط الافتراضية ودعم الوسائط المسمّاة تُعيد بيانات مسار SVG لشكل هندسي.
- ST_EndPoint - تغيّرت في: 2.0.0 لم تعد تعمل مع الخطوط المتعددة (MultiLineStrings) ذات الشكل الواحد. في الإصدارات الأقدم من PostGIS كان الخط المتعدد المكوّن من خط واحد يعمل مع هذه الدالة ويُعيد نقطة النهاية. أما في 2.0.0 فتُعيد NULL كأي خط متعدد آخر. كان السلوك القديم ميزة غير موثقة، لكن من افترضوا أن بياناتهم مخزنة كـ LINESTRING قد يجدون أنها تُعيد NULL في 2.0.0. تُعيد النقطة الأخيرة من خط (LineString) أو خط دائري (CircularLineString).
- ST_GDALDrivers - تغيّرت في: 2.0.6، 2.1.3 - افتراضيًا لا يُفعَّل أي برنامج تشغيل، ما لم يُضبط إعداد GUC أو متغير البيئة gdal_enabled_drivers. تُعيد قائمة بصيغ الرستر التي يدعمها PostGIS عبر GDAL. لا يمكن استخدام سوى الصيغ ذات can_write=True مع ST_AsGDALRaster
- ST_GeomFromText - تغيّرت في: 2.0.0 في الإصدارات السابقة من PostGIS كان ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') مسموحًا. وأصبح ذلك غير مسموح في PostGIS 2.0.0 لتحقيق توافق أفضل مع معايير SQL/MM. ويجب كتابته الآن على النحو ST_GeomFromText('GEOMETRYCOLLECTION EMPTY') تُعيد قيمة ST_Geometry محددة من تمثيل النص المعروف (WKT).
- ST_GeometryN - تغيّرت في: 2.0.0 كانت الإصدارات السابقة تُعيد NULL للأشكال الهندسية المفردة. وقد تغيّر ذلك لتُعيد الشكل الهندسي في حالة ST_GeometryN(..,1). تُعيد عنصرًا من مجموعة أشكال هندسية.
- ST_IsEmpty - تغيّرت في: 2.0.0 في الإصدارات السابقة من PostGIS كان التعبير ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') مسموحًا. وأصبح الآن غير مسموح في PostGIS 2.0.0 لتحقيق توافق أفضل مع معايير SQL/MM تختبر ما إذا كان الشكل الهندسي فارغًا.
- ST_Length - تغيّرت في: 2.0.0 تغيير غير متوافق -- في الإصدارات السابقة كان تطبيقها على MULTI/POLYGON من نوع geography يُعطيك محيط POLYGON/MULTIPOLYGON. وفي 2.0.0 تغيّر ذلك لتُعيد 0 انسجامًا مع سلوك geometry. يُرجى استخدام ST_Perimeter إذا أردت محيط مضلع تُعيد الطول ثنائي الأبعاد لشكل هندسي خطي.
- ST_LocateAlong - تغيّرت في: 2.0.0 في الإصدارات السابقة كانت تُسمّى ST_Locate_Along_Measure. تُعيد النقطة (أو النقاط) على شكل هندسي التي تطابق قيمة قياس معيّنة.
- ST_LocateBetween - تغيّرت في: 2.0.0 - في الإصدارات السابقة كانت تُسمّى ST_Locate_Between_Measures. تُعيد أجزاء الشكل الهندسي التي تطابق نطاق قياس معيّنًا.
- ST_ModEdgeSplit - تغيّرت في: 2.0 - في الإصدارات السابقة كانت تحمل اسمًا خاطئًا هو ST_ModEdgesSplit تقسّم حافة بإنشاء عقدة جديدة على امتداد حافة موجودة، مع تعديل الحافة الأصلية وإضافة حافة جديدة.
- ST_NumGeometries - تغيّرت في: 2.0.0 في الإصدارات السابقة كانت تُعيد NULL إذا لم يكن الشكل الهندسي من نوع مجموعة/MULTI. أما منذ 2.0.0 فتُعيد 1 للأشكال الهندسية المفردة مثل POLYGON وLINESTRING وPOINT. تُعيد عدد العناصر في مجموعة أشكال هندسية.
- ST_NumInteriorRings - تغيّرت في: 2.0.0 - في الإصدارات السابقة كانت تسمح بتمرير MULTIPOLYGON، وتُعيد عدد الحلقات الداخلية لأول POLYGON. تُعيد عدد الحلقات الداخلية (الثقوب) لمضلع.
- ST_PointN - تغيّرت في: 2.0.0 لم تعد تعمل مع الخطوط المتعددة ذات الشكل الواحد. في الإصدارات الأقدم من PostGIS -- كان الخط المتعدد المكوّن من خط واحد يعمل مع هذه الدالة دون مشكلة ويُعيد نقطة البداية. أما في 2.0.0 فتُعيد NULL ببساطة كأي خط متعدد آخر. تُعيد النقطة رقم N في أول خط (LineString) أو خط دائري في الشكل الهندسي.
- ST_ScaleX - تغيّرت في: 2.0.0. في إصدارات WKTRaster كانت تُسمّى ST_PixelSizeX. تُعيد المركّبة X لعرض البكسل بوحدات النظام المرجعي للإحداثيات.
- ST_ScaleY - تغيّرت في: 2.0.0. في إصدارات WKTRaster كانت تُسمّى ST_PixelSizeY. تُعيد المركّبة Y لارتفاع البكسل بوحدات النظام المرجعي للإحداثيات.
- ST_SetScale - تغيّرت في: 2.0.0 في إصدارات WKTRaster كانت تُسمّى ST_SetPixelSize. وقد تغيّر ذلك في 2.0.0. تضبط حجم البكسلات في الاتجاهين X وY بوحدات النظام المرجعي للإحداثيات. عدد الوحدات لكل بكسل عرضًا/ارتفاعًا.
- ST_StartPoint - تغيّرت في: 2.0.0 لم تعد تعمل مع الخطوط المتعددة (MultiLineStrings) ذات الشكل الواحد. في الإصدارات الأقدم من PostGIS كان الخط المتعدد المكوّن من خط واحد يعمل مع هذه الدالة دون مشكلة ويُعيد نقطة البداية. أما في 2.0.0 فتُعيد NULL ببساطة كأي خط متعدد آخر. كان السلوك القديم ميزة غير موثقة، لكن من افترضوا أن بياناتهم مخزنة كـ LINESTRING قد يجدون أنها تُعيد NULL في 2.0.0. تُعيد النقطة الأولى من خط (LineString).
13.12.14. دوال PostGIS الجديدة أو المحسّنة في 1.5
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 1.5
- && - متاحة منذ: 1.5.0 أُضيف دعم geography. تُعيد TRUE إذا تقاطع المستطيل المحيط ثنائي الأبعاد لـ A مع المستطيل المحيط ثنائي الأبعاد لـ B.
- PostGIS_LibXML_Version - متاحة منذ: 1.5 تُعيد رقم إصدار مكتبة libxml2.
- ST_AddMeasure - متاحة منذ: 1.5.0 تستكمل القياسات على امتداد شكل هندسي خطي.
- ST_AsBinary - متاحة منذ: 1.5.0 أُضيف دعم geography. تُعيد تمثيل الثنائي المعروف (WKB) وفق OGC/ISO لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_AsGML - متاحة منذ: 1.5.0 أُضيف دعم geography. تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsGeoJSON - متاحة منذ: 1.5.0 أُضيف دعم geography. تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_AsText - متاحة منذ: 1.5 - أُضيف دعم geography. تُعيد تمثيل النص المعروف (WKT) لقيمة geometry/geography دون بيانات SRID الوصفية.
- ST_Buffer - متاحة منذ: 1.5 - حُسّنت ST_Buffer لدعم أنماط مختلفة للأطراف والوصلات. وهذه مفيدة مثلاً لتحويل خطوط الطرق إلى طرق مضلّعة بحواف مسطّحة أو مربّعة بدلاً من الحواف المستديرة. وأُضيف غلاف رقيق لنوع geography. تحسب شكلاً هندسياً يغطي جميع النقاط الواقعة ضمن مسافة معيّنة من شكل هندسي.
- ST_ClosestPoint - متاحة منذ: 1.5.0 تُعيد النقطة ثنائية الأبعاد على g1 الأقرب إلى g2. وهي النقطة الأولى من أقصر خط من أحد الشكلين إلى الآخر.
- ST_CollectionExtract - متاحة منذ: 1.5.0 تُعيد، من مجموعة أشكال مُعطاة، شكلًا هندسيًا متعددًا يحتوي فقط على عناصر من نوع محدد.
- ST_Covers - متاحة منذ: 1.5 - أُضيف دعم geography. تختبر ما إذا كانت كل نقطة من B تقع في A
- ST_DFullyWithin - متاحة منذ: 1.5.0 تختبر ما إذا كان شكل هندسي يقع بالكامل ضمن مسافة معيّنة من شكل آخر
- ST_DWithin - متاحة منذ: 1.5.0 أُضيف دعم geography تختبر ما إذا كان شكلان هندسيان ضمن مسافة معيّنة
- ST_Distance - متاحة منذ: 1.5.0 أُضيف دعم geography في 1.5. وتحسينات في السرعة للحساب المستوي للتعامل بشكل أفضل مع الأشكال الكبيرة أو ذات الرؤوس الكثيرة تُعيد المسافة بين قيمتين من نوع geometry أو geography.
- ST_DistanceSphere - متاحة منذ: 1.5 - أُضيف دعم أنواع أشكال أخرى غير النقاط. وكانت الإصدارات السابقة تعمل مع النقاط فقط. تُعيد أقل مسافة بالمتر بين شكلين بإحداثيات خط الطول/خط العرض باستخدام نموذج كروي للأرض.
- ST_DistanceSpheroid - متاحة منذ: 1.5 - أُضيف دعم أنواع أشكال أخرى غير النقاط. وكانت الإصدارات السابقة تعمل مع النقاط فقط. تُعيد أقل مسافة بين شكلين بإحداثيات خط الطول/خط العرض باستخدام نموذج إهليلجي للأرض.
- ST_DumpPoints - متاحة منذ: 1.5.0 تُعيد مجموعة من صفوف geometry_dump للإحداثيات في الشكل الهندسي.
- ST_Envelope - متاحة منذ: 1.5.0 تغيّر السلوك لإخراج دقة مضاعفة (double precision) بدلًا من float4 تُعيد شكلًا هندسيًا يمثل المستطيل المحيط بالشكل الهندسي.
- ST_Expand - متاحة منذ: 1.5.0 تغيّر السلوك لإخراج إحداثيات بدقة مضاعفة (double precision) بدلًا من float4. تُعيد مستطيلًا محيطًا موسّعًا من مستطيل محيط آخر أو من شكل هندسي.
- ST_GMLToSQL - متاحة منذ: 1.5، تتطلب libxml2 1.6+ تُعيد قيمة ST_Geometry محددة من تمثيل GML. هذه الدالة اسم بديل لـ ST_GeomFromGML
- ST_GeomFromGML - متاحة منذ: 1.5، تتطلب libxml2 1.6+ تأخذ تمثيل GML لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_GeomFromKML - متاحة منذ: 1.5، تتطلب libxml2 2.6+ تأخذ تمثيل KML لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS
- ST_HausdorffDistance - متاحة منذ: 1.5.0 تُعيد مسافة هاوسدورف (Hausdorff) بين شكلين.
- ST_Intersection - متاحة منذ: 1.5 أُضيف دعم نوع البيانات geography. تحسب شكلاً هندسياً يمثّل الجزء المشترك بين الشكلين A وB.
- ST_Intersects - متاحة منذ: 1.5 أُضيف دعم geography. تختبر ما إذا كان شكلان هندسيان يتقاطعان (لهما نقطة مشتركة واحدة على الأقل)
- ST_Length - متاحة منذ: 1.5.0 أُضيف دعم geography في 1.5. تُعيد الطول ثنائي الأبعاد لشكل هندسي خطي.
- ST_LongestLine - متاحة منذ: 1.5.0 تُعيد أطول خط ثنائي الأبعاد بين شكلين.
- ST_MakeEnvelope - متاحة منذ: 1.5 تُنشئ مضلعًا مستطيلًا من الإحداثيات الدنيا والقصوى.
- ST_MaxDistance - متاحة منذ: 1.5.0 تُعيد أكبر مسافة ثنائية الأبعاد بين شكلين هندسيين بوحدات الإسقاط.
- ST_ShortestLine - متاحة منذ: 1.5.0 تُعيد أقصر خط ثنائي الأبعاد بين شكلين هندسيين
- ~= - متاحة منذ: 1.5.0 تغيّر السلوك تُعيد TRUE إذا كان المستطيل المحيط لـ A مطابقًا للمستطيل المحيط لـ B.
13.12.15. دوال PostGIS الجديدة أو المحسّنة في 1.4
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 1.4
- Populate_Geometry_Columns - متاحة منذ: 1.4.0 تضمن تعريف أعمدة geometry بمُعدِّلات نوع أو احتواءها على قيود مكانية مناسبة.
- ST_Collect - متاحة منذ: 1.4.0 - أُضيفت ST_Collect(geomarray). حُسّنت ST_Collect لمعالجة عدد أكبر من الأشكال الهندسية بسرعة أكبر. تُنشئ مجموعة أشكال GeometryCollection أو شكلًا هندسيًا متعددًا Multi* من مجموعة أشكال هندسية.
- ST_ContainsProperly - متاحة منذ: 1.4.0 تختبر ما إذا كانت كل نقطة من B تقع في داخل A
- ST_GeoHash - متاحة منذ: 1.4.0 تُعيد تمثيل GeoHash للشكل الهندسي.
- ST_IsValidReason - متاحة منذ: 1.4 تُعيد نصًا يبيّن ما إذا كان الشكل الهندسي صالحًا، أو سبب عدم صلاحيته.
- ST_LineCrossingDirection - متاحة منذ: 1.4 تُعيد رقمًا يشير إلى سلوك العبور بين خطين (LineString)
- ST_LocateBetweenElevations - متاحة منذ: 1.4.0 تُعيد أجزاء الشكل الهندسي الواقعة ضمن نطاق ارتفاع (Z).
- ST_MakeLine - متاحة منذ: 1.4.0 - أُضيفت ST_MakeLine(geomarray). حُسّنت الدوال التجميعية ST_MakeLine لمعالجة عدد أكبر من النقاط بسرعة أكبر. تُنشئ خطًا (LineString) من أشكال هندسية من نوع Point أو MultiPoint أو LineString.
- ST_MinimumBoundingCircle - متاحة منذ: 1.4.0 تُعيد أصغر مضلع دائري يحتوي على شكل هندسي.
- ST_Union - متاحة منذ: 1.4.0 - حُسّنت ST_Union. أُضيفت ST_Union(geomarray) وكذلك تجميع أسرع في PostgreSQL. تحسب شكلاً هندسياً يمثّل اتحاد مجموعات نقاط الأشكال المُدخلة.
13.12.16. دوال PostGIS الجديدة أو المحسّنة في 1.3
الدوال المذكورة أدناه هي دوال PostGIS أُضيفت أو حُسّنت.
الدوال الجديدة في PostGIS 1.3
- ST_AsGML - متاحة منذ: 1.3.2 تُعيد الشكل الهندسي كعنصر GML من الإصدار 2 أو 3.
- ST_AsGeoJSON - متاحة منذ: 1.3.4 تُعيد شكلًا هندسيًا أو معلمًا (feature) بصيغة GeoJSON.
- ST_CurveToLine - متاحة منذ: 1.3.0 تحوّل شكلًا هندسيًا يحتوي على منحنيات إلى شكل خطي.
- ST_LineToCurve - متاحة منذ: 1.3.0 تحوّل شكلًا هندسيًا خطيًا إلى شكل منحنٍ.
- ST_SimplifyPreserveTopology - متاحة منذ: 1.3.3 تُعيد تمثيلاً مبسّطاً وصالحاً لشكل هندسي باستخدام خوارزمية Douglas-Peucker.