Spec-Zone.ru › Django 5.2

Сериализатор GeoJSON

GeoDjango предоставляет специальный сериализатор для формата GeoJSON. См. Сериализация объектов Django для получения дополнительной информации о сериализации.

Сериализатор geojson не предназначен для двустороннего обмена данными, так как у него нет эквивалентного десериализатора. Например, вы не можете использовать loaddata для перезагрузки вывода, созданного этим сериализатором. Если вы планируете перезагрузить выведенные данные, используйте стандартный сериализатор JSON вместо этого.

В дополнение к параметрам сериализатора json, сериализатор geojson принимает следующие дополнительные параметры при вызове через serializers.serialize():

  • geometry_field: Строка, содержащая имя поля геометрии, которое следует использовать для ключа geometry геообъекта. Это необходимо только в том случае, если у вас есть модель с более чем одним полем геометрии и вы не хотите использовать первое определённое поле геометрии (по умолчанию выбирается первое поле геометрии).
  • id_field: Строка, содержащая имя поля, которое следует использовать для ключа id геообъекта. По умолчанию используется первичный ключ объектов.
  • srid: SRID для использования с geometry содержимым. По умолчанию 4326 (WGS 84).

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

Пример:

from django.core.serializers import serialize
from my_app.models import City

serialize("geojson", City.objects.all(), geometry_field="point", fields=["name"])

Выведет:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "id": 1,
            "geometry": {"type": "Point", "coordinates": [-87.650175, 41.850385]},
            "properties": {"name": "Chicago"},
        }
    ],
}

Когда параметр fields не указан, сериализатор geojson добавляет ключ pk в словарь properties со значением, равным первичному ключу объекта.

© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/5.2/ref/contrib/gis/serializers/

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API