ST_ LineInterpolatePoint

ST_ LineInterpolatePoint mengembalikan titik sepanjang garis pada jarak pecahan dari awal garis.

Untuk menentukan kesetaraan titik, ST_ LineInterpolatePoint beroperasi pada proyeksi 2D dari geometri input. Jika geometri input kosong, salinannya dikembalikan dalam dimensi yang sama dengan input. Untuk geometri 3DZ, 3DM, dan 4D, m koordinat z atau adalah rata-rata z atau m koordinat segmen tempat titik berada.

Sintaks

ST_LineInterpolatePoint(geom, fraction)

Argumen

geom

Nilai tipe data GEOMETRY atau ekspresi yang mengevaluasi GEOMETRY tipe. Subtipe adalahLINESTRING.

fraksi

Nilai tipe data DOUBLE PRECISION yang mewakili posisi titik di sepanjang linestring untuk garis. Nilainya adalah pecahan dalam kisaran 0-1, inklusif.

Jenis pengembalian

GEOMETRYdari subtipePOINT.

Jika geom atau fraksi adalah nol, maka null dikembalikan.

Jika geom kosong, maka titik kosong dikembalikan.

Nilai pengidentifikasi sistem referensi spasial (SRID) dari geometri yang dikembalikan adalah nilai SRID dari geometri input.

Jika pecahan di luar jangkauan, maka kesalahan dikembalikan.

Jika geom bukan linestring, maka kesalahan dikembalikan.

Contoh

SQL berikut mengembalikan titik setengah jalan sepanjang linestring.

SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.50));

st_asewkt
-----------
 POINT(5 5)      

SQL berikut mengembalikan titik 90 persen dari jalan sepanjang linestring.

SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.90));

st_asewkt
-----------
 POINT(9 9)