الاسم
ST_AsEWKB — تُعيد تمثيل الثنائي المعروف الموسَّع (EWKB) للشكل الهندسي مع بيانات SRID الوصفية.
المختصر
bytea ST_AsEWKB(geometry g1);
bytea ST_AsEWKB(geometry g1, text NDR_or_XDR);
الوصف
تُعيد تمثيل الثنائي المعروف الموسَّع (EWKB) للشكل الهندسي مع بيانات SRID الوصفية. الصيغة الأولى للدالة تُرمِّز افتراضيًا باستخدام ترتيب البايتات (endian) لجهاز الخادم. أما الصيغة الثانية فتأخذ وسيطًا نصيًا يحدد ترتيب البايتات: إما 'NDR' للترتيب الصغير (little-endian)، أو 'XDR' للترتيب الكبير (big-endian). يؤدي تمرير وسائط غير معروفة إلى إخراج بترتيب little-endian.
صيغة WKB مفيدة لقراءة بيانات الأشكال الهندسية من قاعدة البيانات مع الحفاظ على الدقة العددية الكاملة. وهذا يتجنّب تقريب الدقة الذي قد يحدث مع الصيغ النصية مثل WKT.
لإجراء التحويل العكسي من EWKB إلى geometry في PostGIS استخدم ST_GeomFromEWKB.
![[ملاحظة]](../images/note.png)
|
|
|
للحصول على صيغة OGC/ISO WKB استخدم ST_AsBinary. لاحظ أن صيغة OGC/ISO WKB لا تتضمن SRID. |
حُسّنت في: 2.0.0 أُضيف دعم الأسطح متعددة الوجوه والمثلثات وTIN.
تدعم هذه الدالة الأبعاد الثلاثية ولا تُسقط قيمة Z.
تدعم هذه الدالة الأقواس الدائرية (Circular Strings) والمنحنيات.
تدعم هذه الدالة الأسطح متعددة الوجوه (Polyhedral surfaces).
تدعم هذه الدالة المثلثات وأسطح الشبكات المثلثية غير المنتظمة (TIN).
أمثلة
SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_asewkb
--------------------------------
\x0103000020e610000001000000050000000000000000000000000000000000000000000000000000
00000000000000f03f000000000000f03f000000000000f03f000000000000f03f00000000000000
0000000000000000000000000000000000
SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), 'XDR');
st_asewkb
--------------------------------
\x0020000003000010e600000001000000050000000000000000000000000000000000000000000000
003ff00000000000003ff00000000000003ff00000000000003ff000000000000000000000000000
0000000000000000000000000000000000