{"title":"Geographic Feeds","version":"4.0","locale":"pl","docname":"ref/contrib/gis/feeds","url":"/pl/4.0/ref/contrib/gis/feeds/","canonical":"https://djangodocs.dev/pl/4.0/ref/contrib/gis/feeds/","summary":"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.…","html":"<span id=\"geographic-feeds\"></span><h1>Geographic Feeds<a class=\"heading-anchor\" href=\"#module-django.contrib.gis.feeds\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>GeoDjango has its own <a class=\"reference internal\" href=\"#django.contrib.gis.feeds.Feed\" title=\"django.contrib.gis.feeds.Feed\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">Feed</span></code></a> subclass that may embed location information\nin RSS/Atom feeds formatted according to either the <a class=\"reference external\" href=\"https://georss.org\">Simple GeoRSS</a> or\n<a class=\"reference external\" href=\"https://www.w3.org/2003/01/geo/\">W3C Geo</a> standards.  Because GeoDjango’s syndication API is a superset of\nDjango’s, please consult <a class=\"reference internal\" href=\"/pl/4.0/ref/contrib/syndication/\"><span class=\"doc\">Django’s syndication documentation</span></a> for details on general usage.</p>\n<section id=\"example\">\n<h2>Example<a class=\"heading-anchor\" href=\"#example\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n</section>\n<section id=\"api-reference\">\n<h2>API Reference<a class=\"heading-anchor\" href=\"#api-reference\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"feed-subclass\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">Feed</span></code> Subclass<a class=\"heading-anchor\" href=\"#feed-subclass\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.gis.feeds.Feed\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">Feed</span></span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.Feed\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>In addition to methods provided by the\n<a class=\"reference internal\" href=\"/pl/4.0/ref/contrib/syndication/#django.contrib.syndication.views.Feed\" title=\"django.contrib.syndication.views.Feed\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">django.contrib.syndication.views.Feed</span></code></a> base class, GeoDjango’s\n<code class=\"docutils literal notranslate\"><span class=\"pre\">Feed</span></code> class provides the following overrides. Note that these overrides\nmay be done in multiple ways:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">django.contrib.gis.feeds</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">Feed</span>\n\n<span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">MyFeed</span><span class=\"p\">(</span><span class=\"n\">Feed</span><span class=\"p\">):</span>\n\n    <span class=\"c1\"># First, as a class attribute.</span>\n    <span class=\"n\">geometry</span> <span class=\"o\">=</span> <span class=\"o\">...</span>\n    <span class=\"n\">item_geometry</span> <span class=\"o\">=</span> <span class=\"o\">...</span>\n\n    <span class=\"c1\"># Also a function with no arguments</span>\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"nf\">geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span>\n        <span class=\"o\">...</span>\n\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"nf\">item_geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span>\n        <span class=\"o\">...</span>\n\n    <span class=\"c1\"># And as a function with a single argument</span>\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"nf\">geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">obj</span><span class=\"p\">):</span>\n        <span class=\"o\">...</span>\n\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"nf\">item_geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">item</span><span class=\"p\">):</span>\n        <span class=\"o\">...</span>\n</code></pre></div>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.gis.feeds.Feed.geometry\">\n<span class=\"sig-name descname\"><span class=\"pre\">geometry</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">obj</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.Feed.geometry\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Takes the object returned by <code class=\"docutils literal notranslate\"><span class=\"pre\">get_object()</span></code> and returns the <em>feed’s</em>\ngeometry. Typically this is a <code class=\"docutils literal notranslate\"><span class=\"pre\">GEOSGeometry</span></code> instance, or can be a tuple\nto represent a point or a box. For example:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">ZipcodeFeed</span><span class=\"p\">(</span><span class=\"n\">Feed</span><span class=\"p\">):</span>\n\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"nf\">geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">obj</span><span class=\"p\">):</span>\n        <span class=\"c1\"># Can also return: `obj.poly`, and `obj.poly.centroid`.</span>\n        <span class=\"k\">return</span> <span class=\"n\">obj</span><span class=\"o\">.</span><span class=\"n\">poly</span><span class=\"o\">.</span><span class=\"n\">extent</span> <span class=\"c1\"># tuple like: (X0, Y0, X1, Y1).</span>\n</code></pre></div>\n<dl class=\"py method\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.gis.feeds.Feed.item_geometry\">\n<span class=\"sig-name descname\"><span class=\"pre\">item_geometry</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">item</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.Feed.item_geometry\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Set this to return the geometry for each <em>item</em> in the feed. This can be a\n<code class=\"docutils literal notranslate\"><span class=\"pre\">GEOSGeometry</span></code> instance, or a tuple that represents a point coordinate or\nbounding box. For example:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"k\">class</span><span class=\"w\"> </span><span class=\"nc\">ZipcodeFeed</span><span class=\"p\">(</span><span class=\"n\">Feed</span><span class=\"p\">):</span>\n\n    <span class=\"k\">def</span><span class=\"w\"> </span><span class=\"nf\">item_geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> <span class=\"n\">obj</span><span class=\"p\">):</span>\n        <span class=\"c1\"># Returns the polygon.</span>\n        <span class=\"k\">return</span> <span class=\"n\">obj</span><span class=\"o\">.</span><span class=\"n\">poly</span>\n</code></pre></div>\n</dd></dl>\n\n</section>\n<section id=\"syndicationfeed-subclasses\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">SyndicationFeed</span></code> Subclasses<a class=\"heading-anchor\" href=\"#syndicationfeed-subclasses\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>The following <a class=\"reference internal\" href=\"/pl/4.0/ref/utils/#django.utils.feedgenerator.SyndicationFeed\" title=\"django.utils.feedgenerator.SyndicationFeed\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">django.utils.feedgenerator.SyndicationFeed</span></code></a> subclasses\nare available:</p>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.gis.feeds.GeoRSSFeed\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">GeoRSSFeed</span></span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.GeoRSSFeed\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.gis.feeds.GeoAtom1Feed\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">GeoAtom1Feed</span></span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.GeoAtom1Feed\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.gis.feeds.W3CGeoFeed\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">W3CGeoFeed</span></span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.W3CGeoFeed\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Informacja</p>\n<p><a class=\"reference external\" href=\"https://www.w3.org/2003/01/geo/\">W3C Geo</a> formatted feeds only support\n<a class=\"reference internal\" href=\"/pl/4.0/ref/contrib/gis/model-api/#django.contrib.gis.db.models.PointField\" title=\"django.contrib.gis.db.models.PointField\"><code class=\"xref py py-class docutils literal notranslate\"><span class=\"pre\">PointField</span></code></a> geometries.</p>\n</aside>\n</section>\n</section>","rootId":"module-django.contrib.gis.feeds","toc":[{"title":"Example","anchor":"example","children":[]},{"title":"API Reference","anchor":"api-reference","children":[{"title":"Feed Subclass","anchor":"feed-subclass","children":[]},{"title":"SyndicationFeed Subclasses","anchor":"syndicationfeed-subclasses","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API Reference","url":"/pl/4.0/ref/"},{"docname":"ref/contrib/index","title":"contrib packages","url":"/pl/4.0/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/pl/4.0/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/admin","title":"GeoDjango’s admin site","url":"/pl/4.0/ref/contrib/gis/admin/"},"next":{"docname":"ref/contrib/gis/sitemaps","title":"Geographic Sitemaps","url":"/pl/4.0/ref/contrib/gis/sitemaps/"},"formats":{"html":"/pl/4.0/ref/contrib/gis/feeds/","markdown":"/pl/4.0/ref/contrib/gis/feeds.md","json":"/pl/4.0/ref/contrib/gis/feeds.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/ref/contrib/gis/feeds.txt","official":"https://docs.djangoproject.com/pl/4.0/ref/contrib/gis/feeds/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}