Перейти к основному содержанию

WKT

Возвращает геометрический объект WKT (Well Known Text) из различных гео-типов данных. Поддерживаются следующие WKT-объекты:
  • POINT
  • POLYGON
  • MULTIPOLYGON
  • LINESTRING
  • MULTILINESTRING
Синтаксис
Параметры geo_data может иметь один из следующих гео-типов данных или их базовых примитивных типов: Возвращаемое значение
  • Для Point возвращается геометрический объект WKT POINT.
  • Для Polygon возвращается геометрический объект WKT POLYGON.
  • Для MultiPolygon возвращается геометрический объект WKT MULTIPOLYGON.
  • Для LineString возвращается геометрический объект WKT LINESTRING.
  • Для MultiLineString возвращается геометрический объект WKT MULTILINESTRING.
Примеры POINT из кортежа:
POLYGON из массива Tuple или массива массивов Tuple:
MULTIPOLYGON из массива многомерных массивов кортежей:

readWKTMultiPolygon

Преобразует MultiPolygon в формате WKT (Well Known Text) в тип MultiPolygon.

Пример

типрезультат
MultiPolygon[[[(2,0),(10,0),(10,10),(0,10),(2,0)],[(4,4),(5,4),(5,5),(4,5),(4,4)]],[[(-10,-10),(-10,-9),(-9,10),(-10,-10)]]]

Входные параметры

Строка, начинающаяся с MULTIPOLYGON

Возвращаемое значение

MultiPolygon

readWKTPolygon

Преобразует MultiPolygon в формате WKT (Well-Known Text) в тип Polygon.

Пример

типрезультат
Polygon[[(2,0),(10,0),(10,10),(0,10),(2,0)]]

Входные параметры

Строка, начинающаяся с POLYGON

Возвращаемое значение

Polygon

readWKTPoint

Функция readWKTPoint в ClickHouse разбирает геометрию Point, представленную в формате Well-Known Text (WKT), и возвращает точку во внутреннем формате ClickHouse.

Синтаксис

Аргументы

  • wkt_string: Входная строка WKT, описывающая геометрию Point.

Возвращаемое значение

Функция возвращает внутреннее представление геометрии Point, используемое в ClickHouse.

Пример

readWKTLineString

Разбирает геометрию LineString, представленную в формате Well-Known Text (WKT), и возвращает её во внутреннем формате ClickHouse.

Синтаксис

Аргументы

  • wkt_string: Входная строка WKT, представляющая геометрический объект LineString.

Возвращаемое значение

Функция возвращает внутреннее представление геометрии типа LineString в ClickHouse.

Пример

readWKTMultiLineString

Разбирает представление геометрии MultiLineString в формате Well-Known Text (WKT) и возвращает результат во внутреннем формате ClickHouse.

Синтаксис

Аргументы

  • wkt_string: Входная WKT-строка, представляющая геометрию MultiLineString.

Возвращаемое значение

Функция возвращает внутреннее представление геометрии MultiLineString в ClickHouse.

Пример

readWKTRing

Разбирает представление геометрии Polygon в формате Well-Known Text (WKT) и возвращает кольцо (замкнутую линию) во внутреннем формате ClickHouse.

Синтаксис

Аргументы

  • wkt_string: Входная строка WKT, представляющая геометрию типа Polygon.

Возвращаемое значение

Функция возвращает внутреннее представление ClickHouse для геометрии Ring (замкнутой линии).

Пример

polygonsWithinSpherical

Возвращает 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[[[(2,0),(10,0),(10,10),(0,10),(2,0)],[(4,4),(5,4),(5,5),(4,5),(4,4)]],[[(-10,-10),(-10,-9),(-9,10),(-10,-10)]]]

Входные параметры

Строка, начинающаяся с MULTIPOLYGON

Возвращаемое значение

MultiPolygon

readWKBPolygon

Преобразует WKB (Well Known Binary) MultiPolygon в тип Polygon.

Пример

типрезультат
Polygon[[(2,0),(10,0),(10,10),(0,10),(2,0)]]

Входные параметры

Строка, начинающаяся с POLYGON

Возвращаемое значение

Polygon

readWKBPoint

Функция readWKBPoint в ClickHouse разбирает представление геометрии Point в формате Well-Known Binary (WKB) и возвращает точку во внутреннем формате ClickHouse.

Синтаксис

Аргументы

  • wkb_string: Входная строка WKB, представляющая геометрию типа Point.

Возвращаемое значение

Функция возвращает внутреннее представление ClickHouse для геометрии Point.

Пример

readWKBLineString

Разбирает представление геометрии LineString в формате Well-Known Binary (WKB) и возвращает результат во внутреннем формате ClickHouse.

Синтаксис

Аргументы

  • wkb_string: Входная строка WKB, представляющая геометрию типа LineString.

Возвращаемое значение

Функция возвращает внутреннее представление геометрии LineString в ClickHouse.

Пример

readWKBMultiLineString

Разбирает геометрию MultiLineString, представленную в формате Well-Known Binary (WKB), и возвращает её во внутреннем формате ClickHouse.

Синтаксис

Аргументы

  • wkb_string: Входная строка WKB, представляющая геометрию типа MultiLineString.

Возвращаемое значение

Функция возвращает внутреннее представление геометрии multilinestring в ClickHouse.

Пример

Входные параметры

Возвращаемое значение

UInt8, 0 — для false, 1 — для true

polygonsDistanceSpherical

Вычисляет минимальное расстояние между двумя точками, одна из которых принадлежит первому полигону, а вторая — другому. Сферическое означает, что координаты интерпретируются как координаты на идеальной сфере, что для Земли неверно. Использование такой системы координат ускоряет вычисления, но, разумеется, не дает точного результата.

Пример

Входные параметры

Два полигона

Возвращаемое значение

Float64

polygonsDistanceCartesian

Вычисляет расстояние между двумя полигонами

Пример

Входные параметры

Два полигона

Возвращаемое значение

Float64

polygonsEqualsCartesian

Возвращает true, если два полигона равны

Пример

Входные параметры

Два многоугольника

Возвращаемое значение

UInt8: 0 — для false, 1 — для true

polygonsSymDifferenceSpherical

Вычисляет пространственную симметрическую разность (XOR) двух полигонов

Пример

Входные параметры

Полигоны

Возвращаемое значение

MultiPolygon

polygonsSymDifferenceCartesian

То же, что и polygonsSymDifferenceSpherical, но координаты заданы в декартовой системе координат, которая ближе к модели реальной Земли.

Пример

Входные параметры

Полигоны

Возвращаемое значение

MultiPolygon

polygonsIntersectionSpherical

Вычисляет пересечение (побитовое И) полигонов; координаты — сферические.

Пример

Входные параметры

Полигоны

Возвращаемое значение

MultiPolygon

polygonsWithinCartesian

Возвращает true, если второй полигон расположен внутри первого полигона.

Пример

Входные параметры

Два полигона

Возвращаемое значение

UInt8: 0 — для false, 1 — для true

polygonsIntersectCartesian

Возвращает true, если два полигона пересекаются (имеют общую область или общую границу).

Пример

Входные параметры

Два полигона

Возвращаемое значение

UInt8: 0 — false, 1 — true

polygonsIntersectSpherical

Возвращает true, если два полигона пересекаются (то есть имеют общую область или общую границу). Справка: https://www.boost.org/doc/libs/1_62_0/libs/geometry/doc/html/geometry/reference/algorithms/intersects.html

Пример

Входные параметры

Два многоугольника

Возвращаемое значение

UInt8: 0 — false, 1 — true

polygonConvexHullCartesian

Вычисляет выпуклую оболочку. Справочник Координаты заданы в декартовой системе координат.

Пример

Входные параметры

MultiPolygon

Возвращаемое значение

Polygon

polygonAreaSpherical

Вычисляет площадь поверхности полигона.

Пример

Входные параметры

Polygon

Возвращаемое значение

Float

polygonsUnionSpherical

Вычисляет объединение (операцию OR).

Пример

Входные параметры

Полигоны

Возвращаемое значение

MultiPolygon

polygonPerimeterSpherical

Вычисляет периметр полигона.

Пример

Полигон, представляющий Зимбабве

Вот полигон, представляющий Зимбабве:

Использование функции polygonPerimeterSpherical

Параметры

Возвращаемое значение

polygonsIntersectionCartesian

Вычисляет пересечение полигонов.

Пример

Входные параметры

Полигоны

Возвращаемое значение

MultiPolygon

polygonAreaCartesian

Вычисляет площадь полигона

Пример

Входные параметры

Polygon

Возвращаемое значение

Float64

polygonPerimeterCartesian

Вычисляет периметр полигона.

Пример

Входные параметры

Polygon

Возвращаемое значение

Float64

polygonsUnionCartesian

Вычисляет объединение полигонов.

Пример

Входные параметры

Полигоны

Возвращаемое значение

MultiPolygon Подробнее о геометрических системах см. в этой презентации о библиотеке Boost, которую использует ClickHouse.
Последнее изменение 2 июля 2026 г.