bcab45b3fc
* Update of english version of descriprion of the table function `file`. * New syntax for ReplacingMergeTree. Some improvements in text. * Significantly change article about SummingMergeTree. Article is restructured, text is changed in many places of the document. New syntax for table creation is described. * Descriptions of AggregateFunction and AggregatingMergeTree are updated. Russian version. * New syntax for new syntax of CREATE TABLE * Added english docs on Aggregating, Replacing and SummingMergeTree. * CollapsingMergeTree docs. English version. * 1. Update of CollapsingMergeTree. 2. Minor changes in markup * Update aggregatefunction.md * Update aggregatefunction.md * Update aggregatefunction.md * Update aggregatingmergetree.md * GraphiteMergeTree docs update. New syntax for creation of Replicated* tables. Minor changes in *MergeTree tables creation syntax. * Markup fix * Markup and language fixes * Clarification in the CollapsingMergeTree article * DOCAPI-4821. Sync between ru and en versions of docs. * Fixed the ambiguity in geo functions description. * Example of JOIN in ru docs * Deleted misinforming example.
5.0 KiB
Функции для работы с географическими координатами
greatCircleDistance
Вычисляет расстояние между двумя точками на поверхности Земли по формуле большого круга.
greatCircleDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg)
Входные параметры
lon1Deg— долгота первой точки в градусах. Диапазон —[-180°, 180°].lat1Deg— широта первой точки в градусах. Диапазон —[-90°, 90°].lon2Deg— долгота второй точки в градусах. Диапазон —[-180°, 180°].lat2Deg— широта второй точки в градусах. Диапазон —[-90°, 90°].
Положительные значения соответствуют северной широте и восточной долготе, отрицательные — южной широте и западной долготе.
Возвращаемое значение
Расстояние между двумя точками на поверхности Земли в метрах.
Генерирует исключение, когда значения входных параметров выходят за границы диапазонов.
Пример
SELECT greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)
┌─greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)─┐
│ 14132374.194975413 │
└───────────────────────────────────────────────────────────────────┘
pointInEllipses
Проверяет, принадлежит ли точка хотя бы одному из эллипсов.
pointInEllipses(x, y, x₀, y₀, a₀, b₀,...,xₙ, yₙ, aₙ, bₙ)
Входные параметры
x, y— координаты точки на плоскости.xᵢ, yᵢ— координаты центраi-го эллипса.aᵢ, bᵢ— полуосиi-го эллипса в метрах.
Входных параметров должно быть 2+4⋅n, где n — количество эллипсов.
Возвращаемые значения
1, если точка внутри хотя бы одного из эллипсов, 0, если нет.
Пример
SELECT pointInEllipses(55.755831, 37.617673, 55.755831, 37.617673, 1.0, 2.0)
┌─pointInEllipses(55.755831, 37.617673, 55.755831, 37.617673, 1., 2.)─┐
│ 1 │
└─────────────────────────────────────────────────────────────────────┘
pointInPolygon
Проверяет, принадлежит ли точка многоугольнику на плоскости.
pointInPolygon((x, y), [(a, b), (c, d) ...], ...)
Входные значения
(x, y)— координаты точки на плоскости. Тип данных — Tuple - кортеж из двух чисел.[(a, b), (c, d) ...]— вершины многоугольника. Тип данных — Array. Каждая вершина представлена парой координат(a, b). Вершины следует указывать в порядке обхода по или против часовой стрелки. Минимальное количество вершин — 3. Многоугольник должен быть константным.- функция поддерживает также многоугольники с дырками (вырезанными кусками). Для этого случая, добавьте многоугольники, описывающие вырезанные куски, дополнительными аргументами функции. Функция не поддерживает неодносвязные многоугольники.
Возвращаемые значения
1, если точка внутри многоугольника, 0, если нет.
Если точка находится на границе многоугольника, функция может возвращать как 0, так и 1.
Пример
SELECT pointInPolygon((3., 3.), [(6, 0), (8, 4), (5, 8), (0, 2)]) AS res
┌─res─┐
│ 1 │
└─────┘