Skip to main content

WKT

さまざまなGeo データ型から、WKT (Well Known Text) 形式のジオメトリオブジェクトを返します。サポートされている WKT オブジェクトは次のとおりです。
  • POINT
  • MULTIPOINT
  • POLYGON
  • MULTIPOLYGON
  • LINESTRING
  • MULTILINESTRING
構文
パラメータ geo_data には、次のいずれかの Geoデータ型 またはそれらの基になるプリミティブ型を指定できます。 戻り値
  • Point の場合は、WKT 幾何オブジェクト POINT が返されます。
  • MultiPoint の場合は、WKT 幾何オブジェクト MULTIPOINT が返されます。
  • Polygon の場合は、WKT 幾何オブジェクト POLYGON が返されます。
  • MultiPolygon の場合は、WKT 幾何オブジェクト MULTIPOLYGON が返されます。
  • LineString の場合は、WKT 幾何オブジェクト LINESTRING が返されます。
  • MultiLineString の場合は、WKT 幾何オブジェクト MULTILINESTRING が返されます。
例 Tuple からの POINT:
タプルの配列、またはタプル配列の配列から作成するPOLYGON:
多次元のTuple配列の配列から作成するMULTIPOLYGON:

readWKTMultiPolygon

WKT (Well Known Text) 形式のMultiPolygonをMultiPolygon型に変換します。

例

入力パラメータ

MULTIPOLYGON で始まる文字列

戻り値

MultiPolygon

readWKTPolygon

WKT (Well Known Text) 形式のMultiPolygonをPolygon型に変換します。

例

入力パラメータ

POLYGON で始まる文字列

戻り値

Polygon

readWKTPoint

ClickHouse の readWKTPoint 関数は、Point ジオメトリの Well-Known Text (WKT) 表現を解析し、ClickHouse の内部フォーマットのPointを返します。

構文

引数

  • wkt_string: Point ジオメトリを表す WKT 形式の入力文字列。

戻り値

この関数は、Point ジオメトリの ClickHouse における内部表現を返します。

例

readWKTLineString

LineString ジオメトリの Well-Known Text (WKT) 表現をパースし、ClickHouse の内部フォーマットで返します。

構文

引数

  • wkt_string: LineString ジオメトリを表す入力 WKT 文字列。

戻り値

この関数は、LineString ジオメトリの ClickHouse 内部表現を返します。

例

readWKTMultiLineString

MultiLineStringジオメトリのWell-Known Text (WKT) 表現をパースし、ClickHouseの内部フォーマットで返します。

構文

引数

  • wkt_string: MultiLineString ジオメトリを表す入力 WKT 文字列。

戻り値

この関数は、MultiLineString ジオメトリの ClickHouse における内部表現を返します。

例

readWKTMultiPoint

MultiPoint ジオメトリの Well-Known Text (WKT) 表現を解析し、ClickHouse の内部フォーマットで返します。

構文

引数

  • wkt_string: MultiPoint ジオメトリを表す入力WKT文字列。

戻り値

この関数は、マルチポイントジオメトリの ClickHouse 内部表現を返します。

例

readWKTRing

Polygon ジオメトリの Well-Known Text (WKT) 表現を解析し、ClickHouse の内部形式の ring (閉じた linestring) を返します。

構文

引数

  • wkt_string: Polygon ジオメトリを表す入力 WKT 文字列。

戻り値

この関数は、ring (閉じたラインストリング) ジオメトリの ClickHouse 内部表現を返します。

例

polygonsWithinSpherical

ある Polygon が別の Polygon の完全に内側にあるかどうかに応じて、true または false を返します。参考 https://www.boost.org/doc/libs/1_62_0/libs/geometry/doc/html/geometry/reference/algorithms/within/within_2.html

例

readWKBMultiPolygon

WKB (Well Known Binary) 形式のMultiPolygonをMultiPolygon型に変換します。

例

入力パラメータ

先頭が MULTIPOLYGON のString

戻り値

MultiPolygon

readWKBPolygon

WKB (Well Known Binary) 形式のMultiPolygonをPolygon型に変換します。

例

入力パラメータ

POLYGON で始まる文字列

戻り値

Polygon

readWKBPoint

ClickHouse の readWKBPoint 関数は、Point ジオメトリの Well-Known Binary (WKB) 表現を解析し、ClickHouse の内部形式の Point を返します。

構文

引数

  • wkb_string: Point ジオメトリを表す入力 WKB 文字列。

戻り値

この関数は、Pointジオメトリの ClickHouse 内部表現を返します。

例

readWKBLineString

LineString ジオメトリの Well-Known Binary (WKB) 表現をパースし、ClickHouse の内部フォーマットで返します。

構文

引数

  • wkb_string: LineString ジオメトリを表す WKB 形式の入力文字列。

戻り値

この関数は、LineString ジオメトリの ClickHouse 内部表現を返します。

例

readWKBMultiLineString

MultiLineString ジオメトリの Well-Known Binary (WKB) 表現をパースし、ClickHouse の内部フォーマットで返します。

構文

引数

  • wkb_string: MultiLineString ジオメトリを表す入力用の WKB 文字列。

戻り値

この関数は、MultiLineString ジオメトリの ClickHouse における内部表現を返します。

例

入力パラメータ

戻り値

UInt8。false の場合は 0、true の場合は 1

readWKBMultiPoint

MultiPoint ジオメトリの Well-Known Binary (WKB) 表現を解析し、ClickHouse の内部フォーマットで返します。

構文

引数

  • wkb_string: MultiPointジオメトリを表す入力WKB文字列。

戻り値

この関数は、マルチポイントジオメトリの ClickHouse 内部表現を返します。

例

polygonsDistanceSpherical

一方の点が最初の Polygon に属し、もう一方の点が別の Polygon に属するような2点間の最小距離を計算します。Spherical は、座標を純粋で理想的な球面上の座標として解釈することを意味しますが、これは地球には当てはまりません。この種類の座標系を使用すると実行速度は向上しますが、もちろん精度は高くありません。

例

入力パラメータ

2 つのPolygon

戻り値

Float64

polygonsDistanceCartesian

2つのPolygon間の距離を計算します

例

入力パラメータ

2つのPolygon

戻り値

Float64

polygonsEqualsCartesian

2 つのPolygonが等しい場合に true を返します

例

入力パラメータ

2 つのPolygon

戻り値

UInt8。false の場合は 0、true の場合は 1

polygonsSymDifferenceSpherical

2 つのPolygonの空間的な集合論上の対称差 (XOR) を計算します

例

入力パラメータ

Polygons

戻り値

MultiPolygon

polygonsSymDifferenceCartesian

polygonsSymDifferenceSpherical と同じですが、座標はデカルト座標系で表されており、現実の地球のモデルにより近くなります。

例

入力パラメータ

Polygons

戻り値

MultiPolygon

polygonsIntersectionSpherical

Polygon同士の積集合 (AND) を計算します。座標は球面座標です。

例

入力パラメータ

Polygons

戻り値

MultiPolygon

polygonsWithinCartesian

2番目のPolygonが1番目のPolygonの内側にある場合に true を返します。

例

入力パラメータ

2つのPolygon

戻り値

UInt8。false の場合は 0、true の場合は 1

polygonsIntersectCartesian

2 つの Polygon が交差している (共通の領域または境界を持つ) 場合に true を返します。

例

入力パラメータ

2つのPolygon

戻り値

UInt8。false の場合は 0、true の場合は 1

polygonsIntersectSpherical

2 つの Polygon が交差している (共通の領域または境界を持つ) 場合に true を返します。Reference https://www.boost.org/doc/libs/1_62_0/libs/geometry/doc/html/geometry/reference/algorithms/intersects.html

例

入力パラメータ

2つのPolygon

戻り値

UInt8。false の場合は 0、true の場合は 1

geometryIntersectCartesian

2 つのジオメトリが交差し、共通の Point、線、または領域を持つ場合に true を返します。 polygonsIntersectCartesian とは異なり、任意の ジオメトリデータ型 (Point、MultiPoint、LineString、MultiLineString、Ring、Polygon、MultiPolygon) を受け付け、共通の Geometry 型も含まれます。さらに、2 つの 引数 は異なる型でもかまいません。 座標はデカルト座標系です。

例

入力パラメータ

任意のジオメトリデータ型 (または Geometry) のジオメトリを2つ指定します。

戻り値

UInt8。false の場合は 0、true の場合は 1

geometryIntersectSpherical

2 つのジオメトリが交差し (共通の Point、線、または領域を持つ場合) 、true を返します。 polygonsIntersectSpherical とは異なり、任意のジオメトリデータ型 (Point、MultiPoint、LineString、MultiLineString、Ring、Polygon、MultiPolygon) を受け付け、共通の Geometry 型も含まれます。また、2 つの引数は異なる型でもかまいません。 座標は理想的な球面上にあるものとして解釈されます。

例

入力パラメータ

任意の ジオメトリデータ型 (または Geometry) に属する 2 つのジオメトリ。

戻り値

UInt8。false の場合は 0、true の場合は 1

polygonConvexHullCartesian

凸包を計算します。参考 座標はデカルト座標系です。

例

入力パラメータ

MultiPolygon

戻り値

Polygon

polygonAreaSpherical

Polygonの面積を計算します。

例

入力パラメータ

Polygon

戻り値

Float

polygonsUnionSpherical

和集合 (OR) を計算します。

例

入力パラメータ

Polygons

戻り値

MultiPolygon

polygonPerimeterSpherical

Polygon の周囲長を計算します。

例

ジンバブエを表すPolygon

これはジンバブエを表すPolygonです。

polygonPerimeterSpherical関数の使用

入力パラメータ

戻り値

polygonsIntersectionCartesian

Polygonの交差部分を計算します。

例

入力パラメータ

Polygons

戻り値

MultiPolygon

polygonAreaCartesian

ポリゴンの面積を計算します

例

入力パラメータ

Polygon

戻り値

Float64

polygonPerimeterCartesian

Polygon の周囲長を計算します。

例

入力パラメータ

Polygon

戻り値

Float64

polygonsUnionCartesian

Polygonの和集合を計算します。

例

入力パラメータ

Polygons

戻り値

MultiPolygon ジオメトリシステムの詳細については、ClickHouse が使用している Boost ライブラリに関するこのプレゼンテーションをご覧ください。
最終更新日 2026年8月14日