API модели GeoDjango¶

Выбор SRID¶

Выбор подходящего SRID для вашей модели - это важное решение, которое разработчик должен тщательно продумать. SRID - это целочисленный спецификатор, соответствующий системе проекций, которая будет использоваться для интерпретации данных в пространственной базе данных. [3] Системы проекций придают контекст координатам, определяющим местоположение. Хотя детали geodesy выходят за рамки данной документации, общая проблема заключается в том, что Земля сферическая, а представления Земли (например, бумажные карты, веб-карты) - нет.

Большинство людей знакомы с использованием широты и долготы для определения местоположения на земной поверхности. Однако широта и долгота - это углы, а не расстояния. Другими словами, если кратчайший путь между двумя точками на плоской поверхности - это прямая линия, то кратчайший путь между двумя точками на изогнутой поверхности (такой как Земля) - это *дуга great circle. [4] Таким образом, для получения расстояний в плоскостных единицах (например, километрах и милях) требуются дополнительные вычисления. Использование географической системы координат может в дальнейшем создать сложности для разработчика. Например, SpatiaLite не имеет возможности выполнять вычисления расстояний между геометриями, использующими географические системы координат, например, построить запрос для поиска всех точек в пределах 5 миль от границы округа, сохраненной как WGS84. [5]

Части земной поверхности могут проецироваться на двухмерную, или декартову, плоскость. Проецируемые системы координат особенно удобны для приложений, ориентированных на конкретный регион, например, если вы знаете, что ваша база данных будет охватывать только геометрию в North Kansas, то вы можете рассмотреть возможность использования системы проекций, специфичной для этого региона. Более того, проецируемые системы координат определены в декартовых единицах (таких как метры или футы), что облегчает вычисления расстояний.

Дополнительные ресурсы:

• spatialreference.org: База данных пространственных систем координат на основе Django.
• The State Plane Coordinate System: Веб-сайт, посвященный различным системам проекций, используемым в США. Большая часть пространственных данных США будет представлена в одной из этих систем координат, а не в географической системе координат, такой как WGS84.

Тип географии¶

Тип geography обеспечивает встроенную поддержку пространственных характеристик, представленных географическими координатами (например, долгота/широта WGS84). [6] В отличие от плоскости, используемой типом геометрии, тип географии использует сферическое представление своих данных. Операции измерения расстояний и измерений, выполняемые на графе географии, автоматически используют вычисления дуги большого круга и возвращают линейные единицы. Другими словами, при вызове ST_Distance на двух географиях возвращается значение в метрах (в отличие от градусов при вызове на колонке геометрии в WGS84).

Поскольку в географических расчетах используется больше математики, только часть пространственных поисков PostGIS доступна для географического типа. Практически это означает, что в дополнение к distance lookups для столбцов географии доступны только следующие дополнительные spatial lookups:

• bboverlaps
• coveredby
• covers
• intersects

Если вам необходимо использовать пространственный поиск или агрегат, который не поддерживает тип географии в качестве входных данных, вы можете использовать функцию базы данных Cast для преобразования столбца географии в тип геометрии в запросе:

from django.contrib.gis.db.models import PointField
from django.db.models.functions import Cast

Zipcode.objects.annotate(geom=Cast("geography_field", PointField())).filter(
    geom__within=poly
)

Для получения дополнительной информации в документации PostGIS есть полезный раздел об определении when to use geography data type over geometry data type.

Сноски