earthdistance. Вычисление расстояния между точками на поверхности Земли#

В исходном дистрибутиве установлено по умолчанию: нет.

Связанные компоненты: cube.

Схема размещения: ext.

Модуль реализует два разных варианта вычисления ортодромии:

первый вариант зависит от модуля cube;
второй вариант основан на встроенном типе данных point, в котором в качестве координат задаются широта и долгота.

Примечание:

Ортодромия – расстояние между точками на поверхности Земли, кратчайшее расстояние между двумя точками на поверхности земного шара, наименьший из отрезков дуги большого круга, проходящей через эти точки.

В этом модуле планета Земля считается идеальной сферой.

В модуле реализованы функции земных расстояний по кубам:

для ввода данных, выражающих широту и долготу в градусах;
для вывода ширины и долготы, для вычисления ортодромии между двумя точками и простого указания окружающего прямоугольника, что полезно для поиска по индексу.

Предоставляемые функции:

Функция	Результат	Описание
`earth ()`	`float8`	Возвращает предполагаемый радиус Земли в метрах
`sec_to_gc (float8)`	`float8`	Переводит расстояние по обычной прямой (по секущей) между двумя точками на поверхности Земли в расстояние между ними по сфере
`gc_to_sec (float8)`	`float8`	Переводит расстояние по сфере между двумя точками на поверхности Земли в расстояние по обычной прямой (по секущей) между ними
`ll_to_earth (float8, float8)`	`earth`	Возвращает положение точки на поверхности Земли по заданной широте (первый аргумент) и долготе (второй аргумент) в градусах
`latitude (earth)`	`float8`	Возвращает широту точки на поверхности Земли в градусах
`longitude (earth)`	`float8`	Возвращает долготу точки на поверхности Земли в градусах
`earth_distance (earth, earth)`	`float8`	Возвращает расстояние по сфере между двумя точками на поверхности Земли
`earth_box (earth, float8)`	`cube`	Выдает охватывающий куб, подходящий для поиска по индексу с применением реализованного для типа `cube` оператора `@>` для точек в пределах заданной ортодромии от цели. Некоторые точки в этом кубе будут отстоять от цели дальше, чем на заданную ортодромию, поэтому в запрос нужно включить вторую проверку с функцией `earth_distance`.

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

Эта часть модуля основана на представлении точек на Земле в виде значений типа point, в которых первый компонент представляет долготу в градусах, а второй — широту. Точки воспринимаются как (долгота, широта), а не наоборот, так как долгота ближе к интуитивному представлению как оси X, а широта — оси Y.

В модуле реализован один оператор:

Оператор	Результат	Описание
`point <@> point`	`float8`	Вычисляет расстояние в сухопутных милях между точками на поверхности Земли

Изменение функции earth() не повлияет на результат этого оператора.

Доработка#

Доработка не проводилась.

Ограничения#

Ограничения отсутствуют.

Установка#

При наличии прав администратора СУБД включение модуля возможно выполнить вручную:

CREATE EXTENSION earthdistance CASCADE SCHEMA ext;

Примечание:

Модуль earthdistance зависит от модуля cube, поэтому сначала необходимо установить модуль cube, либо воспользоваться указанием CASCADE команды CREATE EXTENSION, чтобы установить сразу оба расширения.

Расширения earthdistance и cube настоятельно рекомендуется устанавливать в одну схему. В этой схеме недоверенные пользователи не должны иметь право CREATE. Если в схеме окажутся объекты, созданные злонамеренным пользователем, возможна угроза безопасности.

При использовании функции earthdistance следует ограничивать путь поиска только доверенными схемами.

Настройка#

Настройка не требуется.

Использование модуля#

Функция earth_distance расчета расстояния между двумя точками земли, с функцией ll_to_earth определением координат при помощи широты и долготы:

SELECT earth_distance(ll_to_earth(39.9042, 116.4074), ll_to_earth(31.2304, 121.4737)) AS distance_meters;

Пример вывода:

 distance_meters     
-----------------
        1067260
(1 row)

Ссылки на документацию разработчика#

Дополнительно поставляемый модуль earthdistance: https://www.postgresql.org/docs/15/earthdistance.html.