ST_ GeomFromText

ST_ GeomFromText membangun objek geometri dari representasi teks terkenal (WKT) dari geometri input.

ST_ GeomFromText menerima 3DZ, 3DM, dan 4D di mana tipe geometri diawali dengan Z, M, atau ZM, masing-masing.

Sintaks

ST_GeomFromText(wkt_string)

ST_GeomFromText(wkt_string, srid)

Argumen

wkt_string

Nilai tipe data VARCHAR yang merupakan representasi WKT dari geometri.

Anda dapat menggunakan kata kunci WKT EMPTY untuk menunjuk titik kosong, multipoint dengan titik kosong, atau koleksi geometri dengan titik kosong. Contoh berikut menciptakan multipoint dengan satu titik kosong dan satu titik nonempty.

ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');

srid

Nilai tipe data INTEGER yang merupakan pengidentifikasi referensi spasial (SRID). Jika nilai SRID disediakan, geometri yang dikembalikan memiliki nilai SRID ini. Jika tidak, nilai SRID dari geometri yang dikembalikan diatur ke nol (0).

Jenis pengembalian

GEOMETRY

Jika wkt_string atau srid adalah null, maka null dikembalikan.

Jika srid negatif, maka null dikembalikan.

Jika wkt_string tidak valid, maka kesalahan dikembalikan.

Jika srid tidak valid, maka kesalahan dikembalikan.

Contoh

SQL berikut membangun objek geometri dari representasi WKT dan nilai SRID.

SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);

st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000