الاسم
ST_PointFromText — تُنشئ geometry من نوع نقطة من WKT باستخدام SRID المعطى. وإذا لم يُعطَ SRID فقيمته الافتراضية غير معروفة.
المختصر
geometry ST_PointFromText(text WKT);
geometry ST_PointFromText(text WKT, integer srid);
الوصف
تُنشئ كائن نقطة ST_Geometry في PostGIS من تمثيل النص المعروف الخاص بـ OGC. وإذا لم يُعطَ SRID فقيمته الافتراضية غير معروفة (حاليًا 0). وإذا لم يكن الشكل تمثيل WKT لنقطة، تُعاد null. وإذا كان WKT غير صالح كليًا، يُطلق خطأ.
![[ملاحظة]](../images/note.png)
|
|
|
توجد صيغتان للدالة ST_PointFromText، الأولى لا تأخذ SRID وتُعيد geometry دون نظام مرجعي مكاني محدد. والثانية تأخذ معرّف النظام المرجعي المكاني وسيطًا ثانيًا وتُعيد ST_Geometry يتضمن هذا srid ضمن بياناته الوصفية. ويجب أن يكون srid معرّفًا في الجدول spatial_ref_sys. |
|
|
|
|
إذا كنت متأكدًا تمامًا من أن جميع أشكالك بصيغة WKT هي نقاط، فلا تستخدم هذه الدالة. فهي أبطأ من ST_GeomFromText لأنها تضيف خطوة تحقق إضافية. وإذا كنت تبني نقاطًا من إحداثيات خط الطول وخط العرض وتهتم بالأداء والدقة أكثر من التوافق مع OGC، فاستخدم ST_MakePoint أو الاسم البديل المتوافق مع OGC ST_Point. |
تطبّق هذه الدالة مواصفة OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 - الخيار SRID مأخوذ من حزمة اختبارات المطابقة.
تطبّق هذه الدالة مواصفة SQL/MM. SQL-MM 3: 6.1.8
أمثلة
SELECT ST_PointFromText('POINT(-71.064544 42.28787)');
SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);