すべてのプロダクト
Search
ドキュメントセンター

AnalyticDB:空間コンストラクタ関数

最終更新日:Jun 07, 2024

空間コンストラクタ関数を使用して、POINT、LINE、およびPOLYGON GEOMETRYデータ型のバイナリ表現を取得できます。 これらの関数を使用して、バイナリデータをテキストに変換し、既知のテキスト (WKT) として表されるバイナリジオメトリデータを取得することもできます。

  • ST_Point: 指定されたxおよびy座標値から点ジオメトリを返します。
  • ST_AsText: 指定したジオメトリのWKT表現を返します。
  • ST_GeometryFromTextまたはST_GeomFromText: 指定されたジオメトリのWKT表現からジオメトリオブジェクトを作成します。
  • ST_IsValidWKT: テキストがWKT形式で整形されているかどうかを返します。
  • ST_LineFromText: WKT表現を使用してLineStringオブジェクトを返します。
  • ST_PointFromText: WKT表現を使用してPointStringオブジェクトを返します。
  • ST_PolygonFromText: WKT表現を使用してPolygonStringオブジェクトを返します。
  • ST_LineString: 点の配列から形成されたLineStringジオメトリオブジェクトを返します。
  • ST_Multipoint: 点の配列から形成されたMultiPointジオメトリオブジェクトを返します。
  • ST_GeomFromBinary: WKB型オブジェクトからジオメトリオブジェクトを返します。
  • Geometry_from_hadoop_shape: Spatial Framework for Hadoop型オブジェクトからジオメトリオブジェクトを返します。
  • To_spherical_geography: ジオメトリオブジェクトから球形のgeographyオブジェクトを返します。 これは、2D空間で定義された識別子を3D空間で定義された識別子に変換する。
  • To_geometry: 球形のgeographyオブジェクトからgeometryオブジェクトを返します。 実際、各地理オブジェクトは合理的なジオメトリオブジェクトです。
  • ST_AsBinary: g1のWKB表現を含むVARBINARYデータ型を返します。
  • ST_Buffer: g1からの距離がd以下のすべての点を返します。

ST_Point

ST_Point(x, y)
  • 説明: この関数は、指定したx座標値とy座標値から点ジオメトリを返します。
  • 戻り値のデータ型: サブタイプPOINTのGEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。
  • 例:
    ST_Point(1,1) を選択します。
                
    返された結果:
    + ----------------------- +
    | ST_Point(1,1) |
    + ----------------------- +
    |? calm      �?   |        
    ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。 例:
    SELECT ST_AsText(ST_Point(1,1));
    返された結果:
    + ----------------------- +
    | ST_Point(1,1) |
    + ----------------------- +
    | ポイント (1 1) | 

ST_AsText

ST_AsText (ジオメトリ)
  • 説明: この関数は、指定したジオメトリのWKT表現を返します。
  • 戻り値のデータ型: WKT。
  • 例:
    SELECT ST_AsText(ST_Point(1,1));
    返された結果:
    + -------------------------- +
    | ST_AsText(ST_Point(1,1)) |
    + -------------------------- +
    | ポイント (1 1) | 

ST_GeometryFromTextまたはST_GeomFromText

ST_GeometryFromText(wkt)
  • 説明: この関数は、指定したジオメトリのWKT表現からジオメトリオブジェクトを作成します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(ST_GeometryFromText('Point(1 1)'));
    返された結果:
    + ---------------------------------------------- +
    | ST_AsText(ST_GeometryFromText('Point(1 1)')) |
    + ---------------------------------------------- +
    | ポイント (1 1) | 

ST_IsValidWKT

ST_IsValidWKT(wkt)
  • 説明: この関数は、テキストがWKT形式で整形されているかどうかを返します。 値1はtrueを示し、値0はfalseを示します。
  • 戻り値のデータ型: INT。
  • 例:
    SELECT ST_IsValidWKT('MULTIPOINT (1 2, 2 4, 3 6, 4 8)');
    返された結果:
    + ------------------------------------------------------------- +
    | ST_IsValidWKT('MULTIPOINT (1 2, 2 4, 3 6, 4 8)') |
    + ------------------------------------------------------------- +
    | 1 | 

ST_LineFromText

ST_LineFromText(wkt)
  • 説明: この関数は、WKT表現を使用してLineStringオブジェクトを返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(ST_LineFromText('LINESTRING (1 1, 2, 1 3)'));
    返された結果:
    + ----------------------------------------------------------------------- +
    | ST_AsText(ST_LineFromText('LINESTRING (1 1, 2, 1 3)')) |
    + ----------------------------------------------------------------------- +
    | LINESTRING (1 1, 2, 1 3) | 

ST_PointFromText

ST_PointFromText(wkt)
  • 説明: この関数は、WKT表現を使用してPointStringオブジェクトを返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(ST_PointFromText('POINT (1 2)'));
    返された結果:
    + ------------------------------------------------------------- +
    | ST_AsText(ST_PointFromText('POINT (1 2)')) |
    + ------------------------------------------------------------- +
    | ポイント (1 2) | 

ST_PolygonFromText

ST_PolygonFromText(wkt)
  • 説明: この関数は、WKT表現を使用してPolygonStringオブジェクトを返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(ST_PolygonFromText('POLYGON ((1 1, 1 4, 4 1))'));
    返された結果:
    + ------------------------------------------------------------------------ +
    | ST_AsText(ST_PolygonFromText('POLYGON ((1 1, 1 4, 4 4 1))')) |
    + ------------------------------------------------------------------------ +
    | POLYGON ((1 1, 1 4, 4 4 1)) | 

ST_LineString

ST_LineString(array(g1,g2. ..))
  • 説明: この関数は、点の配列から形成されたLineStringジオメトリオブジェクトを返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(ST_LineString(array[ST_Point(1,2), ST_Point(3,4)]));
    返された結果:
    + ------------------------------------------------------------------------ +
    | 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. ..))
  • 説明: この関数は、点の配列から形成されたMultiPointジオメトリオブジェクトを返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(ST_MultiPoint(array[ST_GeometryFromText('POINT(1 2)'), ST_GeometryFromText('POINT (3 4)')));
    返された結果:
    + ---------------------------------------------------------------------------------------------------------- +
    | ST_AsText(ST_MultiPoint(array[ST_GeometryFromText('POINT(1 2)'), ST_GeometryFromText('POINT (3 4)')])) |
    + ---------------------------------------------------------------------------------------------------------- +
    | マルチポイント ((1 2) 、(3 4)) | 

ST_GeomFromBinary

ST_GeomFromBinary(wkb)
  • 説明: この関数は、WKB型オブジェクトからジオメトリオブジェクトを返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    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))')))) |
    + ------------------------------------------------------------------------------------------------ +
    | マルチポイント ((1 2) 、(3 4)) | 

Geometry_from_hadoop_shape

Geometry_from_hadoop_shape(wkb)
  • 説明: この関数は、Spatial Framework for Hadoop型オブジェクトからジオメトリオブジェクトを返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(Geometry_from_hadoop_shape(from_hex('000000000101000000000000000000F03F0000000000000040')));
    返された結果:
    + ------------------------------------------------------------------------------------------------------- +
    | ST_AsText(Geometry_from_hadoop_shape(from_hex('000000000101000000000000000000F03F0000000000000040'))) |
    + ------------------------------------------------------------------------------------------------------- +
    | ポイント (1 2) | 

To_spherical_geography

To_spherical_geography(g1)
  • 説明: この関数は、ジオメトリオブジェクトから球形のジオグラフィオブジェクトを返します。 これは、2D空間で定義された識別子を3D空間で定義された識別子に変換する。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。
  • 例:
    SELECT To_spherical_geography(ST_Point(-71.0882、42.3607));
    返された結果:
    + ----------------------------------------------------------- +
    | To_spherical_geography(ST_Point(-71.0882、42.3607)) |
    + ----------------------------------------------------------- +
    |? calm      �?                                      |

To_geometry

To_geometry(g1)
  • 説明: この関数は、球形の地理オブジェクトからジオメトリオブジェクトを返します。 実際、各地理オブジェクトは合理的なジオメトリオブジェクトです。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_ASText(To_geometry(To_spherical_geography(ST_Point(61.56、-58.54))));
    返された結果:
    + ---------------------------------------------------------------------------- +
    | ST_ASText(To_geometry(To_spherical_geography(ST_Point(61.56、-58.54)))) |
    + ---------------------------------------------------------------------------- +
    | POINT (61.56 -58.54) | 

ST_AsBinary

ST_AsBinary(g1)
  • 説明: この関数は、g1のWKB表現を含むVARBINARYデータ型を返します。
  • 戻り値のデータ型: VARBINARY。
  • 例:
    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))')))) |
    + -------------------------------------------------------------------------------------------------- +
    | マルチポイント ((1 2) 、(3 4)) | 

ST_Buffer

ST_Buffer(g1, d)
  • 説明: この関数は、g1からの距離がd以下のすべての点を返します。
  • 戻り値のデータ型: GEOMETRY。 SELECTステートメントを実行してこの関数の結果を照会すると、返された結果が破損します。 ST_AsText関数を呼び出して、結果を読みやすいテキストに変換できます。
  • 例:
    SELECT ST_AsText(ST_Buffer(ST_Point(0、0) 、0.5));
    返された結果:
    + ---------------------------------------------------------------------------------------------- +
    | ST_AsText(ST_Buffer(ST_Point (0,0), 0.5)) |
    + ---------------------------------------------------------------------------------------------- +
    | POLYGON ((0.5 0, 0.4989294616193014 0.03270156461507146,)
    0.4903926402016149 0.09754516100806403, 0.49572243068690486 0.0652630961100257,
    0.47346506474755257 0.16071973265158065, 0.4829629131445338 0.12940952255126026,
    0.4484363707663439 0.22114434510950046, 0.46193976625564315 0.19134171618254472,
    0.41573480615127245 0.2777851165098009, 0.43301270189221913 0.2499999999999998,
    0.3759199037394886 0.32967290755003426, 0.39667667014561747 0.30438071450436016,
    0.32967290755003437 0.3759199037394886, 0.3535533905932737 0.3535533905932736,
    0.2777851165098011 0.4157348061512725, 0.3043807145043603 0.39667667014561747,
    0.22114434510950062 0.4484363707663441, 0.24999999999999997 0.43301270189221924,
    0.16071973265158077 0.4734650647475528, 0.19134171618254486 0.4619397662556433,
    0.09754516100806412 0.4903926402016152, 0.12940952255126037 0.48296291314453416,
    0.03270156461507153 0.49892946161930174, 0.06526309611002579 0.4957224306869052,
    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.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) |