GISarabia.org
PostGIS › الدليل الرسمي › 7. مرجع PostGIS › 7.8.3. صيغ أخرى
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_GeomFromGeoJSON

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

الاسم

ST_GeomFromGeoJSON — تأخذ تمثيل GeoJSON لشكل هندسي مدخلًا وتُخرج كائن geometry في PostGIS

المختصر

geometry ST_GeomFromGeoJSON(text geomjson);

geometry ST_GeomFromGeoJSON(json geomjson);

geometry ST_GeomFromGeoJSON(jsonb geomjson);

الوصف

تُنشئ كائن geometry في PostGIS من تمثيل GeoJSON.

تعمل ST_GeomFromGeoJSON فقط مع أجزاء الأشكال الهندسية في JSON (JSON Geometry fragments). وتُطلق خطأً إذا حاولت استخدامها على مستند JSON كامل.

حُسّنت في: 3.0.0 يكون SRID الافتراضي للشكل المُحلَّل هو 4326 ما لم يُحدَّد خلاف ذلك.

حُسّنت في: 2.5.0 أصبحت تقبل json وjsonb مدخلات.

متاحة منذ: 2.0.0 تتطلب JSON-C >= 0.9

[ملاحظة]

إذا لم يكن دعم JSON-C مفعّلًا، فستحصل على إشعار خطأ بدلًا من رؤية الناتج. لتفعيل JSON-C، شغّل configure --with-jsondir=/path/to/json-c. انظر قسم 2.2.3, “تهيئة البناء” للتفاصيل.

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

أمثلة

SELECT ST_AsText(ST_GeomFromGeoJSON('{"type":"Point","coordinates":[-48.23456,20.12345]}')) As wkt;
wkt
------
POINT(-48.23456 20.12345)
-- a 3D linestring
SELECT ST_AsText(ST_GeomFromGeoJSON('{"type":"LineString","coordinates":[[1,2,3],[4,5,6],[7,8,9]]}')) As wkt;

wkt
-------------------
LINESTRING(1 2,4 5,7 8)