ST_LocateAlong · دليل PostGIS 3.6

الاسم

ST_LocateAlong — تُعيد النقطة (أو النقاط) على شكل هندسي التي تطابق قيمة قياس معيّنة.

المختصر

geometry ST_LocateAlong(geometry geom_with_measure, float8 measure, float8 offset = 0);

الوصف

تُعيد الموقع (أو المواقع) على امتداد شكل هندسي ذي قياس (M) التي لها قيم القياس المعطاة. يكون الناتج Point أو MultiPoint. ولا تُدعم المُدخلات المضلعية.

إذا قُدِّم offset، يُزاح الناتج إلى يسار الخط المُدخل أو يمينه بالمسافة المحددة. تكون الإزاحة الموجبة إلى اليسار، والسالبة إلى اليمين.


	استخدم هذه الدالة فقط مع الأشكال الخطية التي تحتوي على مكوّن M

الدلالة محددة في معيار ISO/IEC 13249-3 SQL/MM Spatial.

متاحة منذ: 1.1.0 بالاسم القديم ST_Locate_Along_Measure.

تغيّرت في: 2.0.0 في الإصدارات السابقة كانت تُسمّى ST_Locate_Along_Measure.

تدعم هذه الدالة إحداثيات M.

تطبّق هذه الدالة مواصفة SQL/MM. SQL-MM IEC 13249-3: 5.1.13

أمثلة

SELECT ST_AsText(
  ST_LocateAlong(
    'MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 3),(1 2 3, 5 4 5))'::geometry,
    3 ));

----------------------------------
 MULTIPOINT M ((1 2 3),(9 4 3),(1 2 3))

انظر أيضًا

ST_LocateBetween, ST_LocateBetweenElevations, ST_InterpolatePoint