Geographic Feeds

فهرست فصل‌ها دانلود آرشیوناشر

Django Docs · نسخهٔ 33d2e5948a0b · BSD-3-Clause

================

Geographic Feeds

:synopsis: GeoDjango's framework for generating spatial feeds.

GeoDjango has its own Feed subclass that may embed location information in RSS/Atom feeds formatted according to either the Simple GeoRSS__ or W3C Geo_ standards. Because GeoDjango's syndication API is a superset of Django's, please consult :doc:Django's syndication documentation </ref/contrib/syndication> for details on general usage.

__ https://www.ogc.org/standard/georss/

Example

API Reference

`Feed` Subclass

In addition to methods provided by the django.contrib.syndication.views.Feed base class, GeoDjango's `Feed` class provides the following overrides. Note that these overrides may be done in multiple ways::

from django.contrib.gis.feeds import Feed

class MyFeed(Feed): # First, as a class attribute. geometry = ... item_geometry = ...

# Also a function with no arguments def geometry(self): ...

def item_geometry(self): ...

# And as a function with a single argument def geometry(self, obj): ...

def item_geometry(self, item): ...

Takes the object returned by `get_object() and returns the *feed's* geometry. Typically this is a GEOSGeometry` instance, or can be a tuple to represent a point or a box. For example::

class ZipcodeFeed(Feed): def geometry(self, obj): # Can also return: obj.poly, and obj.poly.centroid. return obj.poly.extent # tuple like: (X0, Y0, X1, Y1).

Set this to return the geometry for each *item* in the feed. This can be a `GEOSGeometry` instance, or a tuple that represents a point coordinate or bounding box. For example::

class ZipcodeFeed(Feed): def item_geometry(self, obj): # Returns the polygon. return obj.poly

`SyndicationFeed` Subclasses

The following django.utils.feedgenerator.SyndicationFeed subclasses are available:

W3C Geo_ formatted feeds only support ~django.contrib.gis.db.models.PointField geometries.