GISarabia.org
PostGIS › الدليل الرسمي › 7. مرجع PostGIS › 7.9.1. النص المعروف (WKT)
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_AsEWKT

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

الاسم

ST_AsEWKT — تُعيد تمثيل النص المعروف (WKT) للشكل الهندسي مع بيانات SRID الوصفية.

المختصر

text ST_AsEWKT(geometry g1);

text ST_AsEWKT(geometry g1, integer maxdecimaldigits=15);

text ST_AsEWKT(geography g1);

text ST_AsEWKT(geography g1, integer maxdecimaldigits=15);

الوصف

تُعيد تمثيل النص المعروف للشكل الهندسي مسبوقًا بـ SRID. يمكن استخدام الوسيط الاختياري maxdecimaldigits لتقليل الحد الأقصى لعدد الخانات العشرية بعد الفاصلة في الإخراج (القيمة الافتراضية 15).

لإجراء التحويل العكسي من تمثيل EWKT إلى geometry في PostGIS استخدم ST_GeomFromEWKT.

[تنبيه]

قد يؤدي استخدام المعامل maxdecimaldigits إلى أن يصبح الشكل الهندسي الناتج غير صالح. لتجنّب ذلك استخدم أولًا ST_ReducePrecision بحجم شبكة مناسب.

[ملاحظة]

لا تتضمن مواصفة WKT قيمة SRID. للحصول على صيغة OGC WKT استخدم ST_AsText.
[تنبيه]

لا تحافظ صيغة WKT على الدقة، لذا لتجنّب اقتطاع الأعداد العشرية استخدم صيغة ST_AsBinary أو ST_AsEWKB للنقل.

حُسّنت في: 3.1.0 دعم معامل الدقة الاختياري.

حُسّنت في: 2.0.0 أُضيف دعم Geography والأسطح متعددة الوجوه (Polyhedral surfaces) والمثلثات (Triangles) وTIN.

تدعم هذه الدالة الأبعاد الثلاثية ولا تُسقط قيمة Z.

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

تدعم هذه الدالة الأسطح متعددة الوجوه (Polyhedral surfaces).

تدعم هذه الدالة المثلثات وأسطح الشبكات المثلثية غير المنتظمة (TIN).

أمثلة

SELECT ST_AsEWKT('0103000020E61000000100000005000000000000
      000000000000000000000000000000000000000000000000000000
      F03F000000000000F03F000000000000F03F000000000000F03
      F000000000000000000000000000000000000000000000000'::geometry);

       st_asewkt
--------------------------------
SRID=4326;POLYGON((0 0,0 1,1 1,1 0,0 0))
(1 row)

SELECT ST_AsEWKT('0108000080030000000000000060E30A4100000000785C0241000000000000F03F0000000018
E20A4100000000485F024100000000000000400000000018
E20A4100000000305C02410000000000000840')

--st_asewkt---
CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)