全部产品
Search

搜索本产品

    Hologres：Fungsi spasial PostGIS

    文档中心

    Hologres：Fungsi spasial PostGIS

    更新时间：Jun 26, 2025

    PostGIS adalah ekstensi spasial dari PostgreSQL yang menyediakan fitur seperti objek spasial, indeks spasial, fungsi spasial, dan operator spasial. Artikel ini menjelaskan cara menggunakan PostGIS di Hologres.

    Batasan

    • Kolom dengan tipe data geometri atau geografi tidak dapat diatur sebagai kunci utama dalam tabel Hologres.

    • Hologres tidak mendukung indeks spasial.

    • Mulai Hologres V1.3 ke atas, sebagian besar fungsi PostGIS didukung oleh Hologres Query Engine (HQE) yang dikembangkan oleh Alibaba Cloud. HQE menawarkan performa lebih baik. Jika versi instance Hologres Anda lebih lama dari V1.3, PostgreSQL Query Engine (PQE) digunakan, namun performanya lebih rendah.

    Instal ekstensi PostGIS

    Sebelum menggunakan PostGIS dalam database, Anda harus mengeksekusi pernyataan berikut sebagai superuser untuk menginstal ekstensi PostGIS pada database tersebut. Instalasi dilakukan pada tingkat database. Untuk setiap database, instalasi hanya diperlukan sekali. Jika Anda membuat database baru, Anda harus mengeksekusi pernyataan ini lagi:

    -- Instal ekstensi PostGIS.
CREATE EXTENSION if not exists postgis;
    Catatan

    Anda tidak dapat menginstal ekstensi PostGIS di skema pg_catalog.

    Setelah ekstensi PostGIS terpasang, Anda dapat mengeksekusi pernyataan berikut untuk melihat versi PostGIS. Dalam contoh ini, PostGIS 3.0.0 digunakan di Hologres.

    SELECT postgis_full_version();

    Untuk menghapus ekstensi PostGIS, gunakan pernyataan berikut:

    DROP EXTENSION postgis;
    Penting

    Kami merekomendasikan agar Anda tidak mengeksekusi pernyataan DROP EXTENSION <extension_name> CASCADE; untuk menghapus ekstensi. Pernyataan CASCADE tidak hanya menghapus ekstensi yang ditentukan tetapi juga data ekstensi dan objek yang bergantung pada ekstensi tersebut. Data ekstensi mencakup data PostGIS, data bitmap yang menderu, data Proxima, data log biner, dan data BSI. Objek mencakup metadata, tabel, tampilan, dan data server.

    Buat dan kueri tabel yang berisi data tipe data spasial

    PostGIS mendukung dua tipe data spasial di Hologres: geometri dan geografi.

    Tipe data geometri lebih sering digunakan. Bagian ini menjelaskan cara membuat tabel dengan data geometri dan melakukan kueri data spasial. Untuk informasi lebih lanjut tentang parameter dan instruksi tipe data geografi, lihat Tipe Data Geografi.

    1. Buat tabel yang berisi data tipe data geometri.

      Catatan

      Saat membuat tabel dengan data geometri, Anda dapat menentukan sub-tipe objek geometri. Sub-tipe yang didukung meliputi Point, MultiPoint, Linestring, MultiLinestring, Polygon, dan MultiPolygon.

      • Buat tabel tanpa menentukan sub-tipe.

        CREATE TABLE holo_gis_1 ( id INT, geom geometry, PRIMARY KEY (id)) ;

        Dalam contoh ini, tabel dengan data geometri dibuat tanpa menentukan sub-tipe.

      • Buat tabel dengan sub-tipe dan pengenal sistem referensi spasial (SRID).

        CREATE TABLE holo_gis_2 ( id INT, geom geometry(point, 4326), PRIMARY KEY (id)) ;

        Dalam contoh ini, sub-tipe geometri adalah Point, dan SRID adalah 4326. Jika SRID tidak ditentukan, nilai default 0 digunakan. Untuk informasi lebih lanjut tentang SRID, lihat Dokumentasi Resmi PostGIS.

    2. Masukkan data ke dalam tabel.

      Anda dapat memasukkan data ke dalam tabel menggunakan salah satu pernyataan berikut. Untuk informasi lebih lanjut tentang penggunaan fungsi spasial, lihat Fungsi Spasial. Untuk detail tentang SRID, lihat Dokumentasi Resmi PostGIS.

      • Pernyataan tanpa menentukan SRID.

        INSERT INTO holo_gis_1 VALUES (1, ST_GeomFromText('point(116 39)'));

      • Pernyataan dengan SRID tertentu.

        INSERT INTO holo_gis_2 VALUES (1, ST_GeomFromText('point(116 39)', 4326));

    3. Kueri data.

      Setelah membuat tabel dan memasukkan data, Anda dapat mengkueri data spasial dalam dua skenario umum: kueri rentang persegi panjang dan pemeriksaan persimpangan poligon. Untuk informasi lebih lanjut tentang penggunaan fungsi spasial, lihat Fungsi Spasial.

      • Lakukan kueri rentang persegi panjang.

        • Pernyataan tanpa menentukan SRID.

          SELECT st_astext(geom) FROM holo_gis_1
WHERE ST_Covers(ST_MakeBox2D(ST_Point(116, 39),ST_Point(117, 40)), geom);

          Hasil berikut dikembalikan:

          st_astext
-------------
POINT(116 39)

        • Pernyataan dengan SRID tertentu.

          SELECT st_astext(geom) FROM holo_gis_2 
WHERE ST_Covers(ST_SetSRID(ST_MakeBox2D(ST_Point(116, 39),ST_Point(117, 40)), 4326), geom);

          Hasil berikut dikembalikan:

          st_astext
-------------
POINT(116 39)

      • Periksa persimpangan poligon di dalam atau pada batas.

        • Pernyataan tanpa menentukan SRID.

          SELECT st_astext(geom) FROM holo_gis_1
WHERE ST_Covers(ST_MakeBox2D(ST_Point(116, 39),ST_Point(117, 40)), geom);

          Hasil berikut dikembalikan:

          st_astext
-------------
POINT(116 39)

        • Pernyataan dengan SRID tertentu.

          SELECT st_astext(geom) FROM holo_gis_2 
WHERE ST_Covers(ST_SetSRID(ST_MakeBox2D(ST_Point(116, 39),ST_Point(117, 40)), 4326), geom);

          Hasil berikut dikembalikan:

          st_astext
-------------
POINT(116 39)

    Fungsi spasial

    PostGIS menyediakan fungsi spasial yang dapat mengonversi nilai dari satu tipe data ke tipe lainnya. Tabel berikut menjelaskan fungsi-fungsi tersebut. Sintaks fungsi mencakup parameter berikut:

    • geom: Nilai tipe data geometri atau ekspresi yang hasilnya adalah tipe data geometri.

    • presisi: Nilai tipe data INTEGER. Dalam sistem koordinat, presisi nilai geometri berada dalam rentang 1 hingga 20. Jika tidak ditentukan, nilai default 15 digunakan.

    • indeks: Nilai tipe data INTEGER yang menentukan indeks.

    • srid: Nilai tipe data INTEGER yang menentukan SRID.

    Untuk informasi lebih lanjut tentang fungsi spasial, lihat Dokumentasi Resmi PostGIS.

    • Konstruktor geometri

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_LineFromMultiPoint

      ST_LineFromMultiPoint(geom)

      GEOMETRY

      Fungsi ini membuat linestring dari geometri multipoint input. Urutan titik dipertahankan. SRID geometri yang dikembalikan sama dengan geometri input.

      HQE di Hologres V1.3

      ST_MakeEnvelope

      ST_MakeEnvelope(xmin, ymin, xmax, ymax)ST_MakeEnvelope(xmin, ymin, xmax, ymax, srid)

      Geometri subtipe POINT, LINESTRING, atau POLYGON

      Fungsi ini membuat geometri. Jika koordinat input menentukan titik, geometri yang dikembalikan adalah titik. Jika koordinat input menentukan garis, geometri yang dikembalikan adalah linestring. Jika tidak, geometri yang dikembalikan adalah poligon, di mana koordinat input menentukan sudut kiri bawah dan kanan atas poligon. Jika SRID disediakan, SRID geometri yang dikembalikan diatur ke yang disediakan.

      HQE di Hologres V1.3

      ST_MakeLine

      ST_MakeLine(geom1, geom2)

      Geometri subtipe LINESTRING

      Fungsi ini membuat linestring dari geometri input.

      HQE di Hologres V1.3

      ST_MakePoint

      ST_MakePoint(x, y)

      Geometri subtipe POINT

      Fungsi ini membuat titik yang nilai koordinatnya adalah nilai input.

      HQE di Hologres V1.3

      ST_Point

      ST_Point(x, y)

      GEOMETRY subtipe POINT

      Fungsi ini membuat titik dari nilai koordinat input.

      HQE di Hologres V1.3

      ST_Polygon

      ST_Polygon(linestring, srid)

      Geometri subtipe POLYGON

      Fungsi ini membuat poligon yang cincin luarnya adalah linestring input. Jika SRID disediakan, SRID poligon diatur ke yang disediakan.

      HQE di Hologres V1.3

    • Akses geometri

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      GeometryType

      GeometryType(geom)

      VARCHAR

      Fungsi ini mengembalikan sub-tipe geometri input sebagai string.

      HQE di Hologres V1.3

      ST_Boundary

      ST_Boundary(geom)

      GEOMETRY

      Fungsi ini mengembalikan batas geometri input. Jika geometri input kosong, yang tidak berisi titik, geometri input dikembalikan apa adanya. Jika geometri input adalah titik atau multipoint yang tidak kosong, koleksi geometri kosong dikembalikan. Jika geometri input adalah linestring atau multilinestring, multipoint yang berisi semua titik pada batas dikembalikan. Multipoint mungkin kosong. Jika geometri input adalah poligon yang tidak memiliki cincin interior, linestring tertutup yang mewakili batasnya dikembalikan. Jika geometri input adalah poligon yang memiliki cincin interior atau multipolygon, multilinestring dikembalikan. Multilinestring berisi semua batas semua cincin dalam geometri areal sebagai linestring tertutup.

      HQE di Hologres V1.3

      ST_Dimension

      ST_Dimension(geom)

      INTEGER

      Fungsi ini mengembalikan dimensi intrinsik geometri input. Dimensi intrinsik adalah nilai dimensi sub-tipe yang didefinisikan dalam geometri.

      HQE di Hologres V1.3

      ST_Envelope

      ST_Envelope(geom)

      GEOMETRY

      Fungsi ini mengembalikan kotak pembatas minimum geometri input. Jika geometri input kosong, geometri yang dikembalikan adalah salinan geometri input. Jika kotak pembatas minimum geometri input merosot menjadi titik, geometri yang dikembalikan adalah titik. Jika kotak pembatas minimum geometri input satu dimensi, linestring dua titik dikembalikan. Jika tidak ada kondisi sebelumnya yang benar, fungsi ini mengembalikan poligon berorientasi searah jarum jam yang simpulnya adalah sudut kotak pembatas minimum. SRID geometri yang dikembalikan sama dengan geometri input.

      HQE di Hologres V1.3

      ST_ExteriorRing

      ST_ExteriorRing(geom)

      Geometri subtipe LINESTRING

      Fungsi ini mengembalikan linestring tertutup yang mewakili cincin luar poligon input.

      HQE di Hologres V1.3

      ST_GeometryN

      ST_GeometryN(geom, index)

      GEOMETRY

      Fungsi ini mengembalikan geometri ke mana indeks input geometri input menunjuk. Jika input adalah titik, linestring, atau poligon, dan indeks adalah 1, geometri input dikembalikan. Jika indeks bukan 1, null dikembalikan. Jika input adalah multipoint, multilinestring, multipolygon, atau koleksi geometri, titik, linestring, poligon, atau geometri ke mana indeks input menunjuk dikembalikan. Indeks input dimulai dari 1. SRID geometri yang dikembalikan sama dengan geometri input.

      HQE di Hologres V1.3

      ST_GeometryType

      ST_GeometryType(geom)

      VARCHAR

      Fungsi ini mengembalikan sub-tipe geometri input sebagai string.

      HQE di Hologres V1.3

      ST_InteriorRingN

      ST_InteriorRingN(geom, index)

      Geometri subtipe LINESTRING

      Fungsi ini mengembalikan linestring tertutup yang mewakili cincin interior poligon input pada posisi indeks.

      HQE di Hologres V1.3

      ST_IsClosed

      ST_IsClosed(geom)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input tertutup. Aturan berikut mendefinisikan geometri tertutup: Geometri input adalah titik atau multipoint. Geometri input adalah linestring, dan titik awal dan akhir linestring bertepatan. Geometri input adalah multilinestring yang tidak kosong, dan semua linestringnya tertutup. Geometri input adalah poligon yang tidak kosong, semua cincin poligon tidak kosong, dan titik awal dan akhir semua cincinnya bertepatan. Geometri input adalah multipolygon yang tidak kosong, dan semua poligonya tertutup. Geometri input adalah koleksi geometri yang tidak kosong, dan semua elemennya tertutup.

      HQE di Hologres V1.3

      ST_IsCollection

      ST_IsCollection(geom)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input adalah salah satu sub-tipe berikut: GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, atau MULTIPOLYGON.

      HQE di Hologres V1.3

      ST_IsEmpty

      ST_IsEmpty(geom)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input kosong. Jika geometri tidak berisi titik, geometri tersebut kosong.

      HQE di Hologres V1.3

      ST_IspolyGonCW

      ST_IsPolygonCCW(geom)

      BOOLEAN

      Fungsi ini mengembalikan true jika poligon input berlawanan arah jarum jam. Fungsi ini mengembalikan true jika geometri input adalah titik, linestring, multipoint, atau multilinestring. Fungsi ini mengembalikan true jika semua geometri dalam koleksi geometri input berlawanan arah jarum jam.

      HQE di Hologres V1.3

      ST_IsSimple

      ST_IsSimple(geom)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input sederhana.

      HQE di Hologres V1.3

      ST_NPoints

      ST_NPoints(geom)

      INTEGER

      Fungsi ini mengembalikan jumlah titik dalam geometri input.

      HQE di Hologres V1.3

      ST_NRings

      ST_NRings(geom)

      INTEGER

      Fungsi ini mengembalikan jumlah cincin dalam geometri input.

      HQE di Hologres V1.3

      ST_NumGeometries

      ST_NumGeometries(geom)

      INTEGER

      Fungsi ini mengembalikan jumlah geometri dalam koleksi geometri input.

      HQE di Hologres V1.3

      ST_NumInteriorRings

      ST_NumInteriorRings(geom)

      INTEGER

      Fungsi ini mengembalikan jumlah cincin dalam poligon input.

      HQE di Hologres V1.3

      ST_NumPoints

      ST_NumPoints(geom)

      INTEGER

      Fungsi ini mengembalikan jumlah titik dalam geometri input.

      HQE di Hologres V1.3

      ST_PointN

      ST_PointN(geom, index)

      Geometri subtipe POINT

      Fungsi ini mengembalikan titik dalam linestring seperti yang ditentukan oleh nilai indeks. Nilai indeks negatif dihitung mundur dari akhir linestring sehingga -1 menunjukkan titik terakhir.

      HQE di Hologres V1.3

      ST_Points

      ST_Points(geom)

      Geometri subtipe MULTIPOINT

      Fungsi ini mengembalikan geometri multipoint yang berisi semua titik non-kosong dalam geometri input. Fungsi ini tidak menghapus titik duplikat dalam geometri input, termasuk titik awal dan akhir geometri cincin.

      HQE di Hologres V1.3

      ST_StartPoint

      ST_StartPoint(geom)

      GEOMETRY

      Fungsi ini mengembalikan titik pertama dari linestring input. SRID geometri yang dikembalikan sama dengan geometri input.

      HQE di Hologres V1.3

      ST_X

      ST_X(point)

      DOUBLE

      Fungsi ini mengembalikan koordinat X dari titik input.

      HQE di Hologres V1.3

      ST_Y

      ST_Y(point)

      DOUBLE

      Fungsi ini mengembalikan koordinat Y dari titik input.

      HQE di Hologres V1.3

    • Editor geometri

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_AddPoint

      ST_AddPoint(geom1, geom2)

      GEOMETRY

      Fungsi ini mengembalikan linestring yang sama dengan geometri input dengan titik tambahan.

      HQE di Hologres V1.3

      ST_Multi

      ST_Multi(geom)

      Geometri subtipe MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, atau GEOMETRYCOLLECTION

      Fungsi ini mengonversi geometri ke tipe multi yang sesuai. Jika geometri input adalah multitype atau koleksi geometri, salinan geometri input dikembalikan. Jika geometri input adalah titik, linestring, atau poligon, multipoint, multilinestring, atau multipolygon yang berisi geometri input dikembalikan.

      HQE di Hologres V1.3

      ST_RemovePoint

      ST_RemovePoint(geom, index)

      GEOMETRY

      Fungsi ini mengembalikan linestring yang memiliki titik geometri input pada posisi indeks dihapus. Indeks dimulai dari nol. SRID geometri yang dikembalikan sama dengan geometri input.

      HQE di Hologres V1.3

      ST_Reverse

      ST_Reverse(geom)

      GEOMETRY

      Fungsi ini membalikkan urutan simpul untuk geometri linear atau areal. Untuk titik atau multipoint, salinan geometri input dikembalikan. Untuk koleksi geometri, fungsi ini membalikkan urutan simpul untuk setiap geometri dalam koleksi.

      HQE di Hologres V1.3

      ST_setPoint

      ST_SetPoint(geom1, index, geom2)

      GEOMETRY

      Fungsi ini mengembalikan linestring yang sama dengan linestring input dengan titik yang ditentukan oleh nilai indeks diganti dengan koordinat baru. Koordinat baru adalah koordinat titik input.

      HQE di Hologres V1.3

    • Fungsi validasi geometri

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_IsValid

      ST_IsValid(geom)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input valid.

      Catatan

      Fungsi ini didukung oleh PQE.

      PQE

    • Fungsi sistem referensi spasial

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_SetSRID

      ST_SetSRID(geom, srid)

      GEOMETRY

      Fungsi ini mengembalikan geometri yang sama dengan geometri input, kecuali bahwa geometri yang dikembalikan diperbarui menggunakan SRID geometri input.

      HQE di Hologres V1.3

      ST_SRID

      ST_SRID(geom)

      INTEGER

      Fungsi ini mengembalikan SRID geometri input.

      HQE di Hologres V1.3

    • Fungsi input geometri

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_GeomFromText

      • ST_GeomFromText(wkt_string)

      • ST_GeomFromText(wkt_string, srid)

      Geometri

      Fungsi ini membuat objek geometri dari representasi teks terkenal (WKT) geometri input.

      Catatan

      PQE

      PQE

    • Fungsi output geometri

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_AsBinary

      ST_AsBinary(geom)

      BYTEA

      Fungsi ini mengembalikan representasi biner terkenal (WKB) heksadesimal geometri input menggunakan karakter ASCII 0 hingga 9 dan A hingga F.

      HQE di Hologres V1.3

      ST_AsEWKB

      ST_AsEWKB(geom)

      BYTEA

      Fungsi ini mengembalikan representasi biner terkenal diperluas (EWKB) geometri input menggunakan karakter ASCII 0 hingga 9 dan A hingga F.

      HQE di Hologres V1.3

      ST_AsEWKT

      ST_AsEWKT(geom)

      VARCHAR

      Fungsi ini mengembalikan representasi teks terkenal diperluas (EWKT) geometri input.

      HQE di Hologres V1.3

      ST_AsGeoJSON

      ST_AsGeoJSON(geom)ST_AsGeoJSON(geom, precision)

      VARCHAR

      Fungsi ini mengembalikan representasi GeoJSON geometri input. Untuk informasi lebih lanjut tentang GeoJSON, kunjungi halaman GeoJSON di Wikipedia.

      HQE di Hologres V1.3

      ST_AsText

      ST_AsText(geom)ST_AsText(geom, precision)

      VARCHAR

      Fungsi ini mengembalikan representasi WKT geometri input.

      HQE di Hologres V1.3

    • Fungsi hubungan spasial

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_Contains

      ST_Contains(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input pertama berisi geometri input kedua. Geometri A berisi Geometri B jika setiap titik dalam B adalah titik dalam A dan interior mereka memiliki irisan non-kosong. ST_Contains(A, B) setara dengan ST_Within(B, A).

      Catatan

      PQE

      PQE

      ST_ContainsProperly

      ST_ContainsProperly(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika dua geometri input tidak kosong dan semua titik geometri kedua berada di interior geometri pertama.

      Catatan

      PQE

      PQE

      ST_CoveredBy

      ST_CoveredBy(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input pertama tertutupi oleh geometri input kedua. Geometri A tertutupi oleh Geometri B jika keduanya tidak kosong dan setiap titik dalam A adalah titik dalam B. ST_CoveredBy(A, B) setara dengan ST_Covers(B, A).

      Catatan

      PQE

      PQE

      ST_Covers

      ST_Covers(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input pertama menutupi geometri input kedua. Geometri A menutupi Geometri B jika keduanya tidak kosong dan setiap titik dalam B adalah titik dalam A. ST_Covers(A, B) setara dengan ST_CoveredBy(B, A).

      Catatan

      PQE

      PQE

      ST_Crosses

      ST_Crosses(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika dua geometri input berpotongan.

      N/A

      ST_Disjoint

      ST_Disjoint(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika dua geometri input tidak memiliki titik yang sama.

      N/A

      ST_DWithin

      ST_DWithin(geom1, geom2, threshold)

      BOOLEAN

      Fungsi ini mengembalikan true jika jarak Euclidean antara dua geometri input tidak melebihi ambang batas.

      Catatan

      PQE

      PQE

      ST_DWithin_S2

      ST_DWithin_S2(x1, y1, x2, y2, threshold)

      BOOLEAN

      Fungsi ini mengembalikan true jika jarak bola antara dua lokasi geografis kurang dari atau sama dengan nilai yang ditentukan oleh threshold (satuan: meter).

      Parameter input adalah bujur dan lintang Lokasi 1, bujur dan lintang Lokasi 2, dan ambang batas jarak bola secara berurutan.

      Catatan

      Fungsi ini didukung di Hologres V2.0.8. Nilai input tidak dapat berupa konstanta.

      HQE

      ST_Equals

      ST_Equals(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika dua geometri input secara geometris sama. Geometri secara geometris sama jika mereka memiliki himpunan titik yang sama dan interior mereka memiliki irisan non-kosong.

      PQE

      ST_Intersects

      ST_Intersects(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika dua geometri input memiliki setidaknya satu titik yang sama.

      Catatan

      PQE

      PQE

      ST_Touches

      ST_Touches(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika dua geometri input bersentuhan. Dua geometri bersentuhan jika keduanya tidak kosong, berpotongan, dan tidak memiliki titik interior yang sama.

      PQE

      ST_Within

      ST_Within(geom1, geom2)

      BOOLEAN

      Fungsi ini mengembalikan true jika geometri input pertama berada dalam geometri input kedua. Geometri A berada dalam Geometri B jika setiap titik dalam A adalah titik dalam B dan interior mereka memiliki irisan non-kosong. ST_Within(A, B) setara dengan ST_Contains(B, A).

      Catatan

      PQE

      PQE

    • Fungsi pengukuran

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_Angle

      • ST_Angle(geom1, geom2, geom3)

      • ST_Angle(geom1, geom2, geom3, geom4)

      DOUBLE

      Fungsi ini mengembalikan sudut dalam radian antara titik-titik yang diukur searah jarum jam. Nilai kembali dalam radian dan dalam rentang [0, 2π). Contoh:

      • Jika tiga titik ditentukan, sudut yang dikembalikan diukur dengan memutar dari P1 ke P3 di sekitar P2 searah jarum jam.

      • Jika empat titik ditentukan, sudut yang dikembalikan dibentuk oleh garis terarah P1-P2 dan P3-P4 searah jarum jam. Jika dua garis paralel di mana P1 sama dengan P2 atau P3 sama dengan P4 ditentukan, null dikembalikan.

      PQE

      ST_Area

      ST_Area(geom)

      DOUBLE

      Fungsi ini mengembalikan luas Cartesian geometri input. Satuan luas sama dengan satuan di mana koordinat geometri input dinyatakan. Untuk titik, linestring, multipoint, dan multilinestring, 0 dikembalikan. Untuk koleksi geometri, jumlah luas semua geometri dalam koleksi dikembalikan.

      HQE di Hologres V1.3

      ST_Azimuth

      ST_Azimuth(point1, point2)

      DOUBLE

      Fungsi ini mengembalikan azimuth Cartesian berbasis utara yang didefinisikan oleh dua titik input.

      HQE di Hologres V1.3

      ST_Distance

      ST_Distance(geom1, geom2)

      DOUBLE

      Fungsi ini mengembalikan sudut pusat bola antara dua nilai geometri input.

      HQE di Hologres V1.3

      ST_Distance_Sphere_S2

      ST_Distance_Sphere_S2(x1, y1, x2, y2)

      DOUBLE

      Fungsi ini mengembalikan jarak bola antara dua lokasi geografis. Satuan: meter.

      Parameter input adalah bujur dan lintang Lokasi 1 dan bujur dan lintang Lokasi 2 secara berurutan. Nilai valid untuk lintang: [-90,+90]. Nilai valid untuk bujur: [-180,+180].

      Catatan

      Fungsi ini didukung di Hologres V2.0.8. Nilai input tidak dapat berupa konstanta.

      HQE

      ST_Length

      ST_Length(geom)

      DOUBLE

      Fungsi ini mengembalikan panjang Cartesian geometri linear input. Satuan panjang sama dengan satuan di mana koordinat geometri input dinyatakan. Fungsi ini mengembalikan 0 untuk titik, multipoint, dan geometri areal. Jika input adalah koleksi geometri, fungsi ini mengembalikan total panjang geometri dalam koleksi.

      HQE di Hologres V1.3

      ST_Perimeter

      ST_Perimeter(geom)

      DOUBLE

      Fungsi ini mengembalikan perimeter Cartesian geometri areal input, yang menunjukkan panjang batasnya. Satuan perimeter sama dengan satuan di mana koordinat geometri input dinyatakan. Fungsi ini mengembalikan 0 untuk titik, multipoint, dan geometri linear. Jika input adalah koleksi geometri, fungsi ini mengembalikan jumlah perimeter geometri dalam koleksi.

      HQE di Hologres V1.3

    • Fungsi overlay

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_Intersection

      ST_Intersection(geom1, geom2)

      GEOMETRY

      Fungsi ini mengembalikan irisan antara dua geometri input.

      HQE di Hologres V1.3

    • Fungsi pemrosesan geometri

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_Buffer

      ST_Buffer(geography,float8)

      GEOMETRY

      Fungsi ini mengembalikan jarak dari geometri ke buffer.

      Catatan

      PQE

      PQE

      ST_Convexhull

      ST_ConvexHull(geom)

      GEOMETRY

      Fungsi ini mengembalikan geometri yang mewakili cangkang cembung titik non-kosong dalam geometri input.

      HQE di Hologres V1.3

      ST_Simplify

      ST_Simplify(geom, tolerance)

      GEOMETRY

      Fungsi ini mengembalikan salinan geometri input yang disederhanakan menggunakan algoritma Ramer-Douglas-Peucker dengan toleransi tertentu. Topologi geometri input mungkin tidak dipertahankan. Untuk informasi lebih lanjut tentang algoritma Ramer-Douglas-Peucker, kunjungi halaman Ramer-Douglas-Peucker di Wikipedia.

      HQE di Hologres V1.3

    • Fungsi kotak pembatas

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_XMax

      ST_XMax(geom)

      DOUBLE

      Fungsi ini mengembalikan koordinat X maksimum geometri input.

      Catatan

      PQE

      PQE

      ST_XMin

      ST_XMin(geom)

      DOUBLE

      Fungsi ini mengembalikan koordinat X minimum geometri input.

      Catatan

      PQE

      PQE

      ST_YMax

      ST_YMax(geom)

      DOUBLE

      Fungsi ini mengembalikan koordinat Y maksimum geometri input.

      Catatan

      PQE

      PQE

      ST_YMin

      ST_YMin(geom)

      DOUBLE

      Fungsi ini mengembalikan koordinat Y minimum geometri input.

      Catatan

      PQE

      PQE

    • Fungsi referensi linier

      Fungsi

      Sintaks

      Tipe nilai kembali

      Deskripsi

      Mesin yang diperlukan

      ST_LineInterpolatePoint

      ST_LineInterpolatePoint(geom, fraction)

      Geometri subtipe POINT

      Fungsi ini mengembalikan titik interpolasi, yaitu titik sepanjang garis pada jarak fraksional dari awal garis.

      HQE di Hologres V1.3

    Praktik terbaik untuk menggunakan fungsi spasial

    Alibaba Cloud menyediakan praktik terbaik untuk menggunakan fungsi spasial. Untuk informasi lebih lanjut, lihat Gunakan Fungsi Spasial untuk Mengkueri Data.