Topik ini menjelaskan fungsi konstruktor untuk data spatio-temporal. Anda dapat menggunakan fungsi-fungsi ini untuk membuat objek geometri tertentu atau mengonversi string dan objek Well-known Text (WKT) yang sudah ada ke dalam format geometri lainnya.
Mesin dan versi
Fungsi konstruktor hanya berlaku untuk LindormTable.
Fungsi agregat yang dijelaskan dalam topik ini didukung oleh LindormTable versi 2.6.5 dan versi yang lebih baru. Untuk informasi selengkapnya tentang cara melihat atau melakukan upgrade versi LindormTable, lihat Catatan rilis LindormTable dan Upgrade versi mesin minor instans Lindorm.
Lindorm SQL harus menggunakan versi 2.6.8 atau lebih baru. Untuk informasi selengkapnya tentang cara melihat versi Lindorm SQL, lihat Versi SQL.
Fungsi
Tabel berikut mencantumkan fungsi konstruktor yang didukung oleh Lindorm GanosBase.
Fungsi | Deskripsi |
Mengembalikan objek Geometry yang sesuai dengan string WKT yang ditentukan. | |
Mengembalikan objek LineString yang sesuai dengan objek MultiPoint yang ditentukan. | |
Membuat objek Point. |
ST_GeomFromText
Mengembalikan objek Geometry yang sesuai dengan string WKT yang ditentukan.
Sintaks
geometry ST_GeomFromText(string wkt)Parameter
Parameter | Deskripsi |
wkt | String WKT yang ditentukan. |
Objek Geometry mendukung tipe berikut: Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, dan GeometryCollection.
String WKT yang berisi informasi sistem referensi spasial tidak didukung. Jika format WKT mencakup Spatial Reference Identifier (SRID), Anda harus menyimpan SRID tersebut dalam kolom terpisah. SRID hanya digunakan sebagai pengenal. SRID default adalah 4326.
Anda dapat membuat objek EMPTY dari tipe data apa pun.
Contoh
Contoh 1: Objek Geometry berupa Point.
SELECT ST_GeomFromText('POINT(1 1)') as geom;Hasil berikut dikembalikan:
+-------------+ | geom | +-------------+ | POINT (1 1) | +-------------+Contoh 2: Objek Geometry berupa Polygon.
SELECT ST_GeomFromText('POLYGON (( 1 1, 1 2, 2 2, 2 1, 1 1))') AS poly;Hasil berikut dikembalikan:
+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | poly | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 0020000003000010E600000001000000053FF00000000000003FF00000000000003FF000000000000040000000000000004000000000000000400000000000000040000000000000003FF00000000000003FF00000000000003FF0000000000000 | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+Contoh 3: Objek Geometry berupa EMPTY.
SELECT ST_GeomFromText('POLYGON EMPTY') as geom;Hasil berikut dikembalikan:
+---------------+ | geom | +---------------+ | POLYGON EMPTY | +---------------+
ST_LineFromMultiPoint
Mengembalikan objek LineString yang sesuai dengan objek MultiPoint yang ditentukan.
Sintaks
geometry ST_LineFromMultiPoint(geometry aMultiPoint)Parameter
Parameter | Deskripsi |
aMultiPoint | Objek MultiPoint yang ditentukan. Anda dapat menggunakan fungsi |
Contoh
SELECT ST_AsText(ST_LineFromMultiPoint(ST_Collect(ST_MakePoint(1,2),ST_MakePoint(3,4),ST_MakePoint(5,6)))) AS astext;Hasil berikut dikembalikan:
+-------------------------+
| astext |
+-------------------------+
| LINESTRING(1 2,3 4,5 6) |
+-------------------------+ST_MakePoint
Membuat objek Point.
Sintaks
geometry ST_MakePoint(double x, double y)Parameter
Parameter | Deskripsi |
x | Nilai bujur x. Nilai harus bertipe DOUBLE. Jika Anda memasukkan nilai bertipe INTEGER atau LONG, nilai tersebut akan secara otomatis dikonversi ke tipe DOUBLE. |
y | Nilai lintang y. Nilai harus bertipe DOUBLE. Jika Anda memasukkan nilai bertipe INTEGER atau LONG, nilai tersebut akan secara otomatis dikonversi ke tipe DOUBLE. |
Fungsi ini tidak mendukung pengaturan sistem referensi spasial atau pembuatan objek 3D.
Contoh
SELECT ST_AsText(ST_MakePoint(1, 2)) as text;Hasil berikut dikembalikan:
+-------------+
| text |
+-------------+
| POINT (1 2) |
+-------------+