Справочник по 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 (преобразование)

Проверяет, связано ли поле геометрии пространственно с поисковой геометрией значениями, указанными в данном шаблоне. Для этого поиска требуется параметр кортежа ; форма будет зависеть от пространственного бэкенда:(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 предоставляет некоторые агрегатные функции, специфичные для ГИС. Подробные сведения об использовании этих агрегатных функций см. В тематическом руководстве по агрегированию .

Пример:

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