الاسم
ST_AsKML — تُعيد الشكل الهندسي كعنصر KML.
المختصر
text ST_AsKML(geometry geom, integer maxdecimaldigits=15, text nprefix=NULL);
text ST_AsKML(geography geog, integer maxdecimaldigits=15, text nprefix=NULL);
الوصف
تُعيد الشكل الهندسي كعنصر بلغة Keyhole Markup Language (KML). الحد الأقصى الافتراضي لعدد المنازل العشرية 15، ومساحة الأسماء الافتراضية بلا بادئة.
![[تنبيه]](../images/warning.png)
|
|
|
قد يؤدي استخدام المعامل |
![[ملاحظة]](../images/note.png)
|
|
|
يتطلب أن يكون PostGIS مُترجَمًا بدعم Proj. استخدم PostGIS_Full_Version للتأكد من أن دعم proj مُضمَّن. |
|
|
|
|
متاحة منذ: 1.2.2 - الصيغ اللاحقة التي تتضمن معامل الإصدار جاءت في 1.3.2 |
|
|
|
|
حُسّنت في: 2.0.0 - إضافة بادئة مساحة الأسماء، واستخدام الوسائط الافتراضية والمسمّاة |
|
|
|
|
تغيّرت في: 3.0.0 - أُزيلت صيغة التوقيع "ذات الإصدار" |
|
|
|
|
لن يعمل إخراج AsKML مع الأشكال الهندسية التي ليس لها SRID |
تدعم هذه الدالة الأبعاد الثلاثية ولا تُسقط قيمة Z.
أمثلة
SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_askml
--------
<Polygon
><outerBoundaryIs
><LinearRing
><coordinates
>0,0 0,1 1,1 1,0 0,0</coordinates
></LinearRing
></outerBoundaryIs
></Polygon>
--3d linestring
SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3, 4 5 6)');
<LineString
><coordinates
>1,2,3 4,5,6</coordinates
></LineString>