Функции для работы с Geohash

Geohash

Geohash — это система геокодов, которая подразделяет поверхность Земли на ячейки в форме сетки и кодирует каждую ячейку в короткую строку букв и цифр. Это иерархическая структура данных, поэтому чем длиннее строка geohash, тем точнее будет географическое положение.

Если вам нужно вручную преобразовать географические координаты в строки geohash, вы можете использовать geohash.org.

geohashEncode

Кодирует широту и долготу как строку geohash.

Синтаксис

Входные значения

• longitude — Долгота части координаты, которую вы хотите закодировать. Вещественное число в диапазоне [-180°, 180°]. Float.
• latitude — Широта части координаты, которую вы хотите закодировать. Вещественное число в диапазоне [-90°, 90°]. Float.
• precision (необязательный) — Длина результирующей закодированной строки. По умолчанию 12. Целое число в диапазоне [1, 12]. Int8.

примечание

• Все параметры координат должны быть одного типа: либо Float32, либо Float64.
• Для параметра precision любое значение менее 1 или более 12 будет беззвучно преобразовано в 12.

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

• Алфавитная строка закодированной координаты (используется измененная версия алфавита кодирования base32). String.

Пример

Запрос:

Результат:

geohashDecode

Декодирует любую строку, закодированную в geohash, в долготу и широту.

Синтаксис

Входные значения

• hash_str — Строка, закодированная в Geohash.

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

• Кортеж (longitude, latitude) из значений Float64 для долготы и широты. Tuple(Float64)

Пример

geohashesInBox

Возвращает массив строк, закодированных в geohash с заданной точностью, которые попадают внутрь и пересекают границы заданного квадрата, по сути представляющего собой 2D-сетку, сглаженную в массив.

Синтаксис

Аргументы

• longitude_min — Минимальная долгота. Диапазон: [-180°, 180°]. Float.
• latitude_min — Минимальная широта. Диапазон: [-90°, 90°]. Float.
• longitude_max — Максимальная долгота. Диапазон: [-180°, 180°]. Float.
• latitude_max — Максимальная широта. Диапазон: [-90°, 90°]. Float.
• precision — Точность Geohash. Диапазон: [1, 12]. UInt8.

примечание

Все параметры координат должны быть одного типа: либо Float32, либо Float64.

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

• Массив строк geohash-боксов заданной длины, покрывающих предоставленную область, на порядок элементов полагаться не следует. Array(String).
• [] - Пустой массив, если минимальные значения широты и долготы не меньше соответствующих максимальных значений.

примечание

Функция вызывает исключение, если результирующий массив превышает 10'000'000 элементов.

Пример

Запрос:

Результат: