全部产品
Search
文档中心

AnalyticDB:Fungsi konstruktor spasial

更新时间:Jun 26, 2025

Fungsi konstruktor spasial digunakan untuk mendapatkan representasi biner dari tipe data GEOMETRY POINT, LINE, dan POLYGON. Fungsi ini juga dapat mengonversi data biner menjadi teks serta menghasilkan data geometri biner dalam format Well-Known Text (WKT).

  • ST_Point: Mengembalikan geometri titik berdasarkan nilai koordinat x dan y yang ditentukan.
  • ST_AsText: Mengembalikan representasi WKT dari geometri yang diberikan.
  • ST_GeometryFromText atau ST_GeomFromText: Membangun objek geometri dari representasi WKT geometri yang diberikan.
  • ST_IsValidWKT: Memeriksa apakah teks memiliki format WKT yang valid.
  • ST_LineFromText: Mengembalikan objek LineString berdasarkan representasi WKT-nya.
  • ST_PointFromText: Mengembalikan objek Point berdasarkan representasi WKT-nya.
  • ST_PolygonFromText: Mengembalikan objek Polygon berdasarkan representasi WKT-nya.
  • ST_LineString: Mengembalikan objek geometri LineString yang dibentuk dari array titik.
  • ST_MultiPoint: Mengembalikan objek geometri MultiPoint yang dibentuk dari array titik.
  • ST_GeomFromBinary: Mengembalikan objek geometri dari objek tipe WKB.
  • Geometry_from_hadoop_shape: Mengembalikan objek geometri dari objek tipe Spatial Framework for Hadoop.
  • To_spherical_geography: Mengembalikan objek geografi bola dari objek geometri dengan mengonversi pengenal 2D ke 3D.
  • To_geometry: Mengembalikan objek geometri dari objek geografi bola.
  • ST_AsBinary: Mengembalikan tipe data VARBINARY yang berisi representasi WKB dari g1.
  • ST_Buffer: Mengembalikan semua titik yang jaraknya dari g1 kurang dari atau sama dengan d.

ST_Point

ST_Point(x, y)
  • Deskripsi: Mengembalikan geometri titik dari nilai koordinat x dan y yang ditentukan.
  • Tipe data nilai kembali: GEOMETRY subtipe POINT. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak.
  • Contoh:
    SELECT ST_Point(1,1);
                
    Hasil yang dikembalikan:
    +-----------------------+
    | ST_Point(1,1)         |
    +-----------------------+
    |        �?      �?   |        
    Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca. Contoh:
    SELECT ST_AsText(ST_Point(1,1));
    Hasil yang dikembalikan:
    +-----------------------+
    | ST_Point(1,1)         |
    +-----------------------+
    |        POINT (1 1)    | 

ST_AsText

ST_AsText(geometry)
  • Deskripsi: Mengembalikan representasi WKT dari geometri yang diberikan.
  • Tipe data nilai kembali: WKT.
  • Contoh:
    SELECT ST_AsText(ST_Point(1,1));                
    Hasil yang dikembalikan:
    +--------------------------+
    | ST_AsText(ST_Point(1,1)) |
    +--------------------------+
    | POINT (1 1)              |   

ST_GeometryFromText atau ST_GeomFromText

ST_GeometryFromText(wkt)
  • Deskripsi: Membangun objek geometri dari representasi WKT geometri yang diberikan.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_GeometryFromText('Point(1 1)'));      
    Hasil yang dikembalikan:
    +----------------------------------------------+
    | ST_AsText(ST_GeometryFromText('Point(1 1)')) |
    +----------------------------------------------+
    | POINT (1 1)                                  |    

ST_IsValidWKT

ST_IsValidWKT(wkt)
  • Deskripsi: Memeriksa apakah teks memiliki format WKT yang valid. Nilai 1 menunjukkan benar, dan nilai 0 menunjukkan salah.
  • Tipe data nilai kembali: INT.
  • Contoh:
    SELECT ST_IsValidWKT('MULTIPOINT (1 2, 2 4, 3 6, 4 8)');
    Hasil yang dikembalikan:
    +-------------------------------------------------------------+
    |        ST_IsValidWKT('MULTIPOINT (1 2, 2 4, 3 6, 4 8)')     |
    +-------------------------------------------------------------+
    |                        1                                    |

ST_LineFromText

ST_LineFromText(wkt)
  • Deskripsi: Mengembalikan objek LineString berdasarkan representasi WKT-nya.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_LineFromText('LINESTRING (1 1, 2 2, 1 3)'));
    Hasil yang dikembalikan:
    +-----------------------------------------------------------------------+
    |        ST_AsText(ST_LineFromText('LINESTRING (1 1, 2 2, 1 3)'))       |
    +-----------------------------------------------------------------------+
    |                        LINESTRING (1 1, 2 2, 1 3)                     |

ST_PointFromText

ST_PointFromText(wkt)
  • Deskripsi: Mengembalikan objek Point berdasarkan representasi WKT-nya.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_PointFromText('POINT (1 2)'));
    Hasil yang dikembalikan:
    +-------------------------------------------------------------+
    |        ST_AsText(ST_PointFromText('POINT (1 2)'))           |
    +-------------------------------------------------------------+
    |                       POINT (1 2)                           |

ST_PolygonFromText

ST_PolygonFromText(wkt)
  • Deskripsi: Mengembalikan objek Polygon berdasarkan representasi WKT-nya.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_PolygonFromText('POLYGON ((1 1, 1 4, 4 4, 4 1))'));
    Hasil yang dikembalikan:
    +------------------------------------------------------------------------+
    |        ST_AsText(ST_PolygonFromText('POLYGON ((1 1, 1 4, 4 4, 4 1))')) |
    +------------------------------------------------------------------------+
    |                        POLYGON ((1 1, 1 4, 4 4, 4 1))                  | 

ST_LineString

ST_LineString(array(g1,g2...))
  • Deskripsi: Mengembalikan objek geometri LineString yang dibentuk dari array titik.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_LineString(array[ST_Point(1,2), ST_Point(3,4)]));
    Hasil yang dikembalikan:
    +------------------------------------------------------------------------+
    | ST_AsText(ST_LineString(array[ST_Point(1,2), ST_Point(3,4)]))          |
    +------------------------------------------------------------------------+
    |           LINESTRING (1 2, 3 4)                                        |    

ST_MultiPoint

ST_MultiPoint(array(g1,g2...))
  • Deskripsi: Mengembalikan objek geometri MultiPoint yang dibentuk dari array titik.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_MultiPoint(array[ST_GeometryFromText('POINT(1 2)'), ST_GeometryFromText('POINT (3 4)')]));
    Hasil yang dikembalikan:
    +----------------------------------------------------------------------------------------------------------+
    |  ST_AsText(ST_MultiPoint(array[ST_GeometryFromText('POINT(1 2)'), ST_GeometryFromText('POINT (3 4)')]))  |
    +----------------------------------------------------------------------------------------------------------+
    |          MULTIPOINT ((1 2), (3 4))                                                                       | 

ST_GeomFromBinary

ST_GeomFromBinary(wkb)
  • Deskripsi: Mengembalikan objek geometri dari objek tipe WKB.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_GeomFromBinary(ST_AsBinary(ST_GeometryFromText('MULTIPOINT ((1 2), (3 4))'))));
    +------------------------------------------------------------------------------------------------+
    |  ST_AsText(ST_GeomFromBinary(ST_AsBinary(ST_GeometryFromText('MULTIPOINT ((1 2), (3 4))'))))   |
    +------------------------------------------------------------------------------------------------+
    |          MULTIPOINT ((1 2), (3 4))                                                             |

Geometry_from_hadoop_shape

Geometry_from_hadoop_shape(wkb)
  • Deskripsi: Mengembalikan objek geometri dari objek tipe Spatial Framework for Hadoop.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(Geometry_from_hadoop_shape(from_hex('000000000101000000000000000000F03F0000000000000040')));
    Hasil yang dikembalikan:
    +-------------------------------------------------------------------------------------------------------+
    | ST_AsText(Geometry_from_hadoop_shape(from_hex('000000000101000000000000000000F03F0000000000000040'))) |
    +-------------------------------------------------------------------------------------------------------+
    |                         POINT (1 2)                                                                   |

To_spherical_geography

To_spherical_geography(g1)
  • Deskripsi: Mengembalikan objek geografi bola dari objek geometri dengan mengonversi pengenal 2D ke 3D.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak.
  • Contoh:
    SELECT To_spherical_geography(ST_Point(-71.0882, 42.3607));
    Hasil yang dikembalikan:
    +-----------------------------------------------------------+
    | To_spherical_geography(ST_Point(-71.0882, 42.3607))       |
    +-----------------------------------------------------------+
    |          �?      �?                                      |

To_geometry

To_geometry(g1)
  • Deskripsi: Mengembalikan objek geometri dari objek geografi bola.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_ASText(To_geometry(To_spherical_geography(ST_Point(61.56, -58.54))));
    Hasil yang dikembalikan:
    +----------------------------------------------------------------------------+
    | ST_ASText(To_geometry(To_spherical_geography(ST_Point(61.56, -58.54))))    |
    +----------------------------------------------------------------------------+
    |           POINT (61.56 -58.54)                                             |

ST_AsBinary

ST_AsBinary(g1)
  • Deskripsi: Mengembalikan tipe data VARBINARY yang berisi representasi WKB dari g1.
  • Tipe data nilai kembali: VARBINARY.
  • Contoh:
    SELECT ST_AsText(ST_GeomFromBinary(ST_AsBinary(ST_GeometryFromText('MULTIPOINT ((1 2), (3 4))'))));
    Hasil yang dikembalikan:
    +--------------------------------------------------------------------------------------------------+
    |  ST_AsText(ST_GeomFromBinary(ST_AsBinary(ST_GeometryFromText('MULTIPOINT ((1 2), (3 4))'))))     |
    +--------------------------------------------------------------------------------------------------+
    |          MULTIPOINT ((1 2), (3 4))                                                               |

ST_Buffer

ST_Buffer(g1, d)
  • Deskripsi: Mengembalikan semua titik yang jaraknya dari g1 kurang dari atau sama dengan d.
  • Tipe data nilai kembali: GEOMETRY. Jika Anda menjalankan pernyataan SELECT untuk menanyakan hasil fungsi ini, hasil yang dikembalikan mungkin rusak. Anda dapat memanggil fungsi ST_AsText untuk mengonversi hasil menjadi teks yang dapat dibaca.
  • Contoh:
    SELECT ST_AsText(ST_Buffer(ST_Point(0, 0), 0.5));
    Hasil yang dikembalikan:
    +----------------------------------------------------------------------------------------------+
    |  ST_AsText(ST_Buffer(ST_Point(0, 0), 0.5))                                                   |
    +----------------------------------------------------------------------------------------------+
    |          POLYGON ((0.5 0, 0.4989294616193014 0.03270156461507146, 
    0.49572243068690486 0.0652630961100257, 0.4903926402016149 0.09754516100806403,
    0.4829629131445338 0.12940952255126026, 0.47346506474755257 0.16071973265158065, 
    0.46193976625564315 0.19134171618254472, 0.4484363707663439 0.22114434510950046, 
    0.43301270189221913 0.2499999999999998, 0.41573480615127245 0.2777851165098009, 
    0.39667667014561747 0.30438071450436016, 0.3759199037394886 0.32967290755003426, 
    0.3535533905932737 0.3535533905932736, 0.32967290755003437 0.3759199037394886, 
    0.3043807145043603 0.39667667014561747, 0.2777851165098011 0.4157348061512725, 
    0.24999999999999997 0.43301270189221924, 0.22114434510950062 0.4484363707663441, 
    0.19134171618254486 0.4619397662556433, 0.16071973265158077 0.4734650647475528, 
    0.12940952255126037 0.48296291314453416, 0.09754516100806412 0.4903926402016152, 
    0.06526309611002579 0.4957224306869052, 0.03270156461507153 0.49892946161930174, 
    0 0.5, -0.03270156461507146 0.4989294616193014, -0.0652630961100257 
    0.49572243068690486, -0.09754516100806403 0.4903926402016149, -0.12940952255126026 
    0.4829629131445338, -0.16071973265158065 0.47346506474755257, -0.19134171618254472 
    0.46193976625564315, -0.22114434510950046 0.4484363707663439, -0.2499999999999998 
    0.43301270189221913, -0.2777851165098009 0.41573480615127245, -0.30438071450436016 
    0.39667667014561747, -0.32967290755003426 0.3759199037394886, -0.3535533905932736 
    0.3535533905932737, -0.3759199037394886 0.32967290755003437, -0.39667667014561747 
    0.3043807145043603, -0.4157348061512725 0.2777851165098011, -0.43301270189221924 
    0.24999999999999997, -0.4484363707663441 0.22114434510950062, -0.4619397662556433 
    0.19134171618254486, -0.4734650647475528 0.16071973265158077, -0.48296291314453416 
    0.12940952255126037, -0.4903926402016152 0.09754516100806412, -0.4957224306869052 
    0.06526309611002579, -0.49892946161930174 0.03270156461507153, -0.5 0, 
    -0.4989294616193014 -0.032700156461507146, -0.49572243068690486 -0.0652630961100257, 
    -0.4903926402016149 -0.09754516100806403, -0.4829629131445338 -0.12940952255126026, 
    -0.47346506474755257 -0.16071973265158065, -0.46193976625564315 
    -0.19134171618254472, -0.4484363707663439 -0.22114434510950046, 
    -0.43301270189221913 -0.2499999999999998, -0.41573480615127245 -0.2777851165098009, 
    -0.39667667014561747 -0.30438071450436016, -0.3759199037394886 -0.32967290755003426, 
    -0.3535533905932737 -0.3535533905932736, -0.32967290755003437 -0.3759199037394886, 
    -0.3043807145043603 -0.39667667014561747, -0.2777851165098011 -0.4157348061512725, 
    -0.24999999999999997 -0.43301270189221924, -0.22114434510950062 -0.4484363707663441, 
    -0.19134171618254486 -0.4619397662556433, -0.16071973265158077 -0.4734650647475528, 
    -0.12940952255126037 -0.48296291314453416, -0.09754516100806412 -0.4903926402016152, 
    -0.06526309611002579 -0.4957224306869052, -0.03270156461507153 -0.49892946161930174, 
    0 -0.5, 0.03270156461507146 -0.4989294616193014, 0.0652630961100257 
    -0.49572243068690486, 0.09754516100806403 -0.4903926402016149, 0.12940952255126026 
    -0.4829629131445338, 0.16071973265158065 -0.47346506474755257, 0.19134171618254472 
    -0.46193976625564315, 0.22114434510950046 -0.4484363707663439, 0.2499999999999998 
    -0.43301270189221913, 0.2777851165098009 -0.41573480615127245, 0.30438071450436016 
    -0.39667667014561747, 0.32967290755003426 -0.3759199037394886, 0.3535533905932736 
    -0.3535533905932737, 0.3759199037394886 -0.32967290755003437, 0.39667667014561747 
    -0.3043807145043603, 0.4157348061512725 -0.2777851165098011, 0.43301270189221924 
    -0.24999999999999997, 0.4484363707663441 -0.22114434510950062, 0.4619397662556433 
    -0.19134171618254486, 0.4734650647475528 -0.16071973265158077, 0.48296291314453416 
    -0.12940952255126037, 0.4903926402016152 -0.09754516100806412, 0.4957224306869052 
    -0.06526309611002579, 0.49892946161930174 -0.03270156461507153, 0.5 0))                          |