API базы данных GeoDjango ¶

Пространственные ограничения MySQL ¶

До MySQL 5.6.1 пространственные расширения поддерживали только операции ограничивающего прямоугольника (то, что MySQL называет минимальными ограничивающими прямоугольниками, или MBR). В частности, MySQL не соответствовал стандарту OGC. Django поддерживает пространственные функции, работающие с реальной геометрией, доступной в современных версиях MySQL. Однако пространственные функции не так богаты, как другие серверные части, такие как PostGIS.

Поддержка растров ¶

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

Поиск по геометрии ¶

Географические запросы с геометрией принимают следующую общую форму (при условии, что Zipcodeмодель используется в GeoDjango Model API ):

>>> qs = Zipcode.objects.filter(<field>__<lookup_type>=<parameter>)
>>> qs = Zipcode.objects.exclude(...)

Например:

>>> qs = Zipcode.objects.filter(poly__contains=pnt)
>>> qs = Elevation.objects.filter(poly__contains=rst)

В данном случае polyэто географическое поле, contains это тип пространственного поиска, pntэто параметр (который может быть GEOSGeometryобъектом или строкой GeoJSON, WKT или HEXEWKB) и rstявляется GDALRasterобъектом.

Поиск растра ¶

Синтаксис поиска растра аналогичен синтаксису геометрических фигур. Единственное отличие состоит в том, что в качестве дополнительных входных данных можно указать индекс полосы. Если индекс полосы не указан, по умолчанию используется первая группа (индекс 0). В этом случае синтаксис идентичен синтаксису поиска геометрии.

Чтобы указать индекс полосы, можно указать дополнительный параметр на обеих сторонах поиска. С левой стороны синтаксис двойного подчеркивания используется для передачи индекса полосы. С правой стороны можно указать кортеж растра и индекс канала.

Это приводит к следующей общей форме поиска с использованием растров (при условии, что Elevationмодель используется в API модели GeoDjango ):

>>> qs = Elevation.objects.filter(<field>__<lookup_type>=<parameter>)
>>> qs = Elevation.objects.filter(<field>__<band_index>__<lookup_type>=<parameter>)
>>> qs = Elevation.objects.filter(<field>__<lookup_type>=(<raster_input, <band_index>)

Например:

>>> qs = Elevation.objects.filter(rast__contains=geom)
>>> qs = Elevation.objects.filter(rast__contains=rst)
>>> qs = Elevation.objects.filter(rast__1__contains=geom)
>>> qs = Elevation.objects.filter(rast__contains=(rst, 1))
>>> qs = Elevation.objects.filter(rast__1__contains=(rst, 1))

В левой части примера rastнаходится поле географического растра и containsтип пространственного поиска. На правой стороне, geomявляется входной геометрии и rstявляется GDALRasterобъектом. По умолчанию индекс полосы 0в первых двух запросах установлен в значение 1в остальных.

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

Тип поддержки растров указан для всех поисков в таблице совместимости . Поиск с использованием растров в настоящее время доступен только для серверной части PostGIS.

Введение ¶

Расчет расстояний с использованием пространственных данных сложен, потому что, к сожалению, Земля не плоская. Некоторые дистанционные запросы с полями в географической системе координат, возможно, придется выражать по-другому из-за ограничений в PostGIS. Дополнительные сведения см. В разделе « Выбор SRID » документации API модели GeoDjango .

Поиск расстояния ¶

Доступность : PostGIS, MariaDB, MySQL, Oracle, SpatiaLite, PGRaster (собственный)

Доступны следующие поиски расстояний:

• distance_lt
• distance_lte
• distance_gt
• distance_gte
• dwithin (кроме MariaDB и MySQL)

Поиск по расстоянию принимает параметр кортежа, содержащий:

1. Геометрия или растр для базовых расчетов; а также
2. Число или Distanceобъект, содержащий расстояние.

Если используется Distanceобъект, он может быть выражен в любых единицах (сгенерированный SQL будет использовать единицы, преобразованные в единицы поля); в противном случае предполагается, что числовые параметры указаны в единицах измерения поля.

Например, предположим, что у нас есть SouthTexasCityмодель (из тестов расстояния GeoDjango ) в системе координат проекции, действительной для городов на юге Техаса:

from django.contrib.gis.db import models

class SouthTexasCity(models.Model):
    name = models.CharField(max_length=30)
    # A projected coordinate system (only valid for South Texas!)
    # is used, units are in meters.
    point = models.PointField(srid=32140)

Тогда дистанционные запросы могут выполняться следующим образом:

>>> from django.contrib.gis.geos import GEOSGeometry
>>> from django.contrib.gis.measure import D # ``D`` is a shortcut for ``Distance``
>>> from geoapp.models import SouthTexasCity
# Distances will be calculated from this point, which does not have to be projected.
>>> pnt = GEOSGeometry('POINT(-96.876369 29.905320)', srid=4326)
# If numeric parameter, units of field (meters in this case) are assumed.
>>> qs = SouthTexasCity.objects.filter(point__distance_lte=(pnt, 7000))
# Find all Cities within 7 km, > 20 miles away, and > 100 chains away (an obscure unit)
>>> qs = SouthTexasCity.objects.filter(point__distance_lte=(pnt, D(km=7)))
>>> qs = SouthTexasCity.objects.filter(point__distance_gte=(pnt, D(mi=20)))
>>> qs = SouthTexasCity.objects.filter(point__distance_gte=(pnt, D(chain=100)))

Растровые запросы работают таким же образом, заменяя поле геометрии pointрастровым полем или pntобъект растровым объектом, или и то и другое. Чтобы указать индекс канала входного растра с правой стороны, 3-кортеж может быть передан поиску следующим образом:

>>> qs = SouthTexasCity.objects.filter(point__distance_gte=(rst, 2, D(km=7)))

Где полоса с индексом 2 (третья полоса) растра rstбудет использоваться для поиска.

Пространственные поиски ¶

В следующей таблице представлена ​​сводная информация о том, какие пространственные поисковые запросы доступны для каждой серверной части пространственной базы данных. Поиск в PostGIS Raster (PGRaster) разделен на три категории, описанные в деталях поиска в растре : встроенная поддержка N, двусторонняя встроенная поддержка Bи поддержка преобразования геометрии C.

Функции базы данных ¶

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

Агрегатные функции ¶

В следующей таблице приведены сводные данные о том, какие агрегатные функции для ГИС доступны на каждом пространственном сервере. Обратите внимание, что MySQL не поддерживает ни один из этих агрегатов и поэтому исключен из таблицы.

Сноски