Справочник по API GIS QuerySet ¶

Запросы с матрицами ¶

Все примеры в приведенной ниже ссылке относятся к геометрическим полям и входам, но эти запросы можно очень хорошо использовать с объектами массивов с обеих сторон. Если запрос не поддерживает ввод массива , ввод автоматически преобразуется в геометрический объект, когда это необходимо, с помощью функции ST_Polygon . См. Также введение в матричные запросы .

Операторы базы данных, используемые в запросах, можно разделить на три категории:

• Встроенная поддержка матрицы N : оператор изначально принимает матричные объекты с обеих сторон запроса, и входные данные матрицы могут смешиваться с входными геометрическими данными.
• Поддержка двусторонних матриц B : оператор поддерживает матричные объекты только в том случае, если обе стороны запроса получают матричный ввод. Данные матрицы автоматически преобразуются в геометрические объекты в случае смешанных запросов.
• Поддерживается геометрическое преобразование C . Запрос изначально не поддерживает матричные объекты, все матричные данные автоматически преобразуются в геометрические объекты.

В приведенных ниже примерах показан эквивалентный код SQL для запросов с различными типами поддержки матриц. Такая же схема применяется для всех пространственных запросов.

Пространственные запросы с растровыми объектами поддерживаются только движком PostGIS (в этом разделе он называется PGRaster).

bbcontains ¶

Доступность  : PostGIS , MariaDB, MySQL, SpatiaLite, PGRaster (родной)

Проверяет, полностью ли ограничивающий прямоугольник геометрического или матричного поля ограничивающий прямоугольник геометрического поиска.

Пример:

Zipcode.objects.filter(poly__bbcontains=geom)

bboverlaps ¶

Доступность  : PostGIS , MariaDB, MySQL, SpatiaLite, PGRaster (родной)

Проверяет, закрывает ли ограничивающий прямоугольник геометрического поля частично ограничивающий прямоугольник геометрического поиска.

Пример:

Zipcode.objects.filter(poly__bboverlaps=geom)

contained ¶

Доступность  : PostGIS , MariaDB, MySQL, SpatiaLite, PGRaster (родной)

Проверяет, полностью ли ограничивающий прямоугольник геометрического поля содержится в ограничивающем прямоугольнике геометрического поиска.

Пример:

Zipcode.objects.filter(poly__contained=geom)

contains ¶

Доступность  : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (двусторонняя)

Проверяет, содержит ли геометрическое поле в пространстве геометрический объект поиска.

Пример:

Zipcode.objects.filter(poly__contains=geom)

contains_properly ¶

Наличие  : PostGIS , PGRaster (двусторонний)

Возвращает, имеет True ли геометрический объект поиска пересечение с внутренней частью геометрического поля, но не с его границами (или внешней стороной).

Пример:

Zipcode.objects.filter(poly__contains_properly=geom)

coveredby ¶

Доступность : PostGIS , Oracle, PGRaster (двусторонний), SpatiaLite

Проверяет, не находится ли никакая точка геометрического поля за пределами геометрического объекта поиска. [3]

Пример:

Zipcode.objects.filter(poly__coveredby=geom)

covers ¶

Доступность : PostGIS , Oracle, PGRaster (двусторонний), SpatiaLite

Проверяет, нет ли точек геометрического объекта поиска вне геометрического поля. [3]

Пример:

Zipcode.objects.filter(poly__covers=geom)

crosses ¶

Доступность  : PostGIS , MariaDB, MySQL, SpatiaLite, PGRaster (конвертация)

Проверяет, пересекается ли геометрическое поле в пространстве с геометрическим объектом поиска.

Пример:

Zipcode.objects.filter(poly__crosses=geom)

disjoint ¶

Доступность  : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (двусторонняя)

Проверяет, отличается ли геометрическое поле пространственно от геометрического объекта поиска.

Пример:

Zipcode.objects.filter(poly__disjoint=geom)

equals ¶

Доступность  : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (преобразование)

Проверяет, совпадает ли геометрическое поле в пространстве с геометрическим объектом поиска.

Пример:

Zipcode.objects.filter(poly__equals=geom)

exact , same_as ¶

Доступность  : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (двусторонняя)

Проверяет, "равно ли" геометрическое поле заданному геометрическому объекту. В Oracle, MySQL и Spatialite тест выполняется на пространственное равенство, а в PostGIS тест сравнивает равенство ограничивающих прямоугольников.

Пример:

Zipcode.objects.filter(poly=geom)

intersects ¶

Доступность : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (двусторонняя)

Проверяет, имеет ли геометрическое поле пространственное пересечение с геометрическим объектом поиска.

Пример:

Zipcode.objects.filter(poly__intersects=geom)

isvalid ¶

Доступность : MySQL (≥ 5.7.5), PostGIS , Oracle, SpatiaLite

Проверяет, действителен ли геометрический объект.

Пример:

Zipcode.objects.filter(poly__isvalid=True)

overlaps ¶

Доступность  : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (двусторонняя)

Проверяет, перекрывает ли геометрическое поле геометрический объект поиска.

relate ¶

Доступность : PostGIS , MariaDB, Oracle, SpatiaLite, PGRaster (преобразование)

Проверяет, имеет ли геометрическое поле пространственную связь с геометрическим объектом поиска в соответствии со значениями, указанными в заданном шаблоне. Для этого поиска требуется параметр в виде кортежа ; форма зависит от космического двигателя:(géom, motif) motif

# A tuple lookup parameter is used to specify the geometry and
# the intersection pattern (the pattern here is for 'contains').
Zipcode.objects.filter(poly__relate=(geom, 'T*T***FF*'))

SELECT ... WHERE ST_Relate(poly, geom, 'T*T***FF*')

SELECT ... WHERE Relate(poly, geom, 'T*T***FF*')

Zipcode.objects.filter(poly__relate=(rast, 1, 'T*T***FF*'))
Zipcode.objects.filter(rast__2__relate=(rast, 1, 'T*T***FF*'))

SELECT ... WHERE ST_Relate(poly, ST_Polygon(rast, 1), 'T*T***FF*')
SELECT ... WHERE ST_Relate(ST_Polygon(rast, 2), ST_Polygon(rast, 1), 'T*T***FF*')

Zipcode.objects.filter(poly__relate=(geom, 'anyinteract'))

SELECT ... WHERE SDO_RELATE(poly, geom, 'anyinteract')

touches ¶

Доступность  : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite

Проверяет, касается ли геометрическое поле в пространстве геометрического объекта поиска.

Пример:

Zipcode.objects.filter(poly__touches=geom)

within ¶

Доступность  : PostGIS , Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (двусторонняя)

Проверяет, находится ли геометрическое поле пространственно внутри геометрического объекта поиска.

Пример:

Zipcode.objects.filter(poly__within=geom)

left ¶

Доступность  : PostGIS , PGRaster (конвертация)

Проверяет, находится ли ограничивающий прямоугольник геометрического поля строго слева от ограничивающего прямоугольника геометрического поиска.

Пример:

Zipcode.objects.filter(poly__left=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly << geom

right ¶

Доступность  : PostGIS , PGRaster (конвертация)

Проверяет, находится ли ограничивающий прямоугольник геометрического поля строго справа от ограничивающего прямоугольника геометрического поиска.

Пример:

Zipcode.objects.filter(poly__right=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly >> geom

overlaps_left ¶

Наличие  : PostGIS , PGRaster (двусторонний)

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

Пример:

Zipcode.objects.filter(poly__overlaps_left=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly &< geom

overlaps_right ¶

Наличие  : PostGIS , PGRaster (двусторонний)

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

Пример:

Zipcode.objects.filter(poly__overlaps_right=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly &> geom

overlaps_above ¶

Доступность  : PostGIS , PGRaster (конвертация)

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

Пример:

Zipcode.objects.filter(poly__overlaps_above=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly |&> geom

overlaps_below ¶

Доступность  : PostGIS , PGRaster (конвертация)

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

Пример:

Zipcode.objects.filter(poly__overlaps_below=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly &<| geom

strictly_above ¶

Доступность  : PostGIS , PGRaster (конвертация)

Проверяет, находится ли ограничивающий прямоугольник геометрического поля строго над ограничивающим прямоугольником геометрического поиска.

Пример:

Zipcode.objects.filter(poly__strictly_above=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly |>> geom

strictly_below ¶

Доступность  : PostGIS , PGRaster (конвертация)

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

Пример:

Zipcode.objects.filter(poly__strictly_below=geom)

Эквивалент PostGIS:

SELECT ... WHERE poly <<| geom

distance_gt ¶

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

Пример:

Zipcode.objects.filter(poly__distance_gt=(geom, D(m=5)))

distance_gte ¶

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

Пример:

Zipcode.objects.filter(poly__distance_gte=(geom, D(m=5)))

distance_lt ¶

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

Пример:

Zipcode.objects.filter(poly__distance_lt=(geom, D(m=5)))

distance_lte ¶

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

Пример:

Zipcode.objects.filter(poly__distance_lte=(geom, D(m=5)))

dwithin ¶

Возвращает объекты, для которых расстояние между полем геометрии и объектом геометрии поиска не превышает заданное значение расстояния. Обратите внимание, что вы можете предоставлять объекты только в том Distance случае, если соответствующие геометрические объекты находятся в системе координат проекции. Для геометрических объектов географического типа необходимо использовать единицы геометрического поля (например, градусы для WGS84 ).

Пример:

Zipcode.objects.filter(poly__dwithin=(geom, D(m=5)))

Функции агрегирования ¶

Django предоставляет несколько функций агрегирования, специфичных для географических данных. Подробнее об использовании этих функций см. В тематическом руководстве по агрегированию .

Пример:

>>> from django.contrib.gis.db.models import Extent, Union
>>> WorldBorder.objects.aggregate(Extent('mpoly'), Union('mpoly'))

>>> qs = City.objects.filter(name__in=('Houston', 'Dallas')).aggregate(Extent('poly'))
>>> print(qs['poly__extent'])
(-96.8016128540039, 29.7633724212646, -95.3631439208984, 32.782058715820)

>>> qs = City.objects.filter(name__in=('Houston', 'Dallas')).aggregate(Extent3D('poly'))
>>> print(qs['poly__extent3d'])
(-96.8016128540039, 29.7633724212646, 0, -95.3631439208984, 32.782058715820, 0)

>>> qs = City.objects.filter(name__in=('Houston', 'Dallas')).aggregate(MakeLine('poly'))
>>> print(qs['poly__makeline'])
LINESTRING (-95.3631510000000020 29.7633739999999989, -96.8016109999999941 32.7820570000000018)

>>> u = Zipcode.objects.aggregate(Union(poly))  # This may take a long time.
>>> u = Zipcode.objects.filter(poly__within=bbox).aggregate(Union(poly))  # A more sensible approach.