mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-09-28 20:50:49 +00:00
71 lines
3.1 KiB
Markdown
71 lines
3.1 KiB
Markdown
|
# Функции для работы с географическими координатами
|
|||
|
|
|
|||
|
|
## greatCircleDistance
|
|||
|
|
|
|||
|
|
Вычисляет расстояние между двумя точками на поверхности Земли по [формуле большого круга](https://en.wikipedia.org/wiki/Great-circle_distance).
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
greatCircleDistance(lon1Deg, lat1Deg, lon2Deg, lat2Deg)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Входные параметры**
|
|||
|
|
|
|||
|
|
- `lon1Deg` — широта первой точки в градусах. Диапазон — `[-90°, 90°]`.
|
|||
|
|
- `lat1Deg` — долгота первой точки в градусах. Диапазон — `[-180°, 180°]`.
|
|||
|
|
- `lon2Deg` — широта второй точки в градусах. Диапазон — `[-90°, 90°]`.
|
|||
|
|
- `lat2Deg` — долгота второй точки в градусах. Диапазон — `[-180°, 180°]`.
|
|||
|
|
|
|||
|
|
Положительные значения соответствуют северной широте и восточной долготе, отрицательные — южной широте и западной долготе.
|
|||
|
|
|
|||
|
|
**Возвращаемое значение**
|
|||
|
|
|
|||
|
|
Расстояние между двумя точками на поверхности Земли в метрах.
|
|||
|
|
|
|||
|
|
Генерирует исключение, когда значения входных параметров выходят за границы диапазонов.
|
|||
|
|
|
|||
|
|
**Пример**
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
SELECT greatCircleDistance(55.755831, 37.617673, -55.755831, -37.617673)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
┌─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`, если нет.
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Примеры**
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
SELECT pointInEllipses(55.755831, 37.617673, 55.755831, 37.617673, 1.0, 2.0)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
┌─pointInEllipses(55.755831, 37.617673, 55.755831, 37.617673, 1., 2.)─┐
|
|||
|
|
│ 1 │
|
|||
|
|
└─────────────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|