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

Поиск с помощью растров¶

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

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

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

Приведенные ниже примеры показывают эквивалент SQL для поиска в различных типах растровой поддержки. Аналогичная схема применима ко всем пространственным поискам.

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

bbcontains¶

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

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

Пример:

Zipcode.objects.filter(poly__bbcontains=geom)

bboverlaps¶

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

Проверяет, перекрывает ли граница поля геометрии границу поля геометрии поиска.

Пример:

Zipcode.objects.filter(poly__bboverlaps=geom)

contained¶

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

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

Пример:

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 (конверсия)

Проверяет, связано ли поле геометрии пространственно с геометрией поиска по значениям, указанным в заданном шаблоне. Для этого поиска требуется параметр кортежа (geom, pattern); форма pattern будет зависеть от пространственного бэкенда:

# 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 предоставляет некоторые агрегатные функции, специфичные для ГИС. Подробнее о том, как использовать эти агрегатные функции, смотрите the topic guide on aggregation.

Пример:

>>> 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.