{"title":"Geographic Feeds","version":"6.1","locale":"pt-br","docname":"ref/contrib/gis/feeds","url":"/pt-br/6.1/ref/contrib/gis/feeds/","canonical":"https://djangodocs.dev/pt-br/6.1/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 para este cabeçalho</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\">Feed</code></a> subclass that may embed location\ninformation in RSS/Atom feeds formatted according to either the <a class=\"reference external\" href=\"https://www.ogc.org/standard/georss/\">Simple\nGeoRSS</a> or <a class=\"reference external\" href=\"https://www.w3.org/2003/01/geo/\">W3C Geo</a> standards. Because GeoDjango’s syndication API is a\nsuperset of Django’s, please consult <a class=\"reference internal\" href=\"/pt-br/6.1/ref/contrib/syndication/\"><span class=\"doc\">Django’s syndication documentation</span></a> for details on general usage.</p>\n<section id=\"example\">\n<h2>Exemplo<a class=\"heading-anchor\" href=\"#example\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n</section>\n<section id=\"api-reference\">\n<h2>Referência da API<a class=\"heading-anchor\" href=\"#api-reference\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"feed-subclass\">\n<h3><code class=\"docutils literal notranslate\">Feed</code> Subclass<a class=\"heading-anchor\" href=\"#feed-subclass\"><span class=\"visually-hidden\">Link para este cabeçalho</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\">class</span> </em><span class=\"sig-name descname\">Feed</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.Feed\"><span class=\"visually-hidden\">Link para esta definição</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>In addition to methods provided by the\n<a class=\"reference internal\" href=\"/pt-br/6.1/ref/contrib/syndication/#django.contrib.syndication.views.Feed\" title=\"django.contrib.syndication.views.Feed\"><code class=\"xref py py-class docutils literal notranslate\">django.contrib.syndication.views.Feed</code></a> base class, GeoDjango’s\n<code class=\"docutils literal notranslate\">Feed</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=\"nn\">django.contrib.gis.feeds</span> <span class=\"kn\">import</span> Feed\n\n\n<span class=\"k\">class</span> <span class=\"nc\">MyFeed</span><span class=\"p\">(</span>Feed<span class=\"p\">):</span>\n    <span class=\"c1\"># First, as a class attribute.</span>\n    geometry <span class=\"o\">=</span> <span class=\"o\">...</span>\n    item_geometry <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=\"nf\">geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span> <span class=\"o\">...</span>\n\n    <span class=\"k\">def</span> <span class=\"nf\">item_geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">):</span> <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=\"nf\">geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> obj<span class=\"p\">):</span> <span class=\"o\">...</span>\n\n    <span class=\"k\">def</span> <span class=\"nf\">item_geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> item<span class=\"p\">):</span> <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\">geometry</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">obj</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.Feed.geometry\"><span class=\"visually-hidden\">Link para esta definição</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\">get_object()</code> and returns the <em>feed’s</em>\ngeometry. Typically this is a <code class=\"docutils literal notranslate\">GEOSGeometry</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=\"nc\">ZipcodeFeed</span><span class=\"p\">(</span>Feed<span class=\"p\">):</span>\n    <span class=\"k\">def</span> <span class=\"nf\">geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> obj<span class=\"p\">):</span>\n        <span class=\"c1\"># Can also return: `obj.poly`, and `obj.poly.centroid`.</span>\n        <span class=\"k\">return</span> obj<span class=\"o\">.</span>poly<span class=\"o\">.</span>extent  <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\">item_geometry</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">item</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.Feed.item_geometry\"><span class=\"visually-hidden\">Link para esta definição</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\">GEOSGeometry</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=\"nc\">ZipcodeFeed</span><span class=\"p\">(</span>Feed<span class=\"p\">):</span>\n    <span class=\"k\">def</span> <span class=\"nf\">item_geometry</span><span class=\"p\">(</span><span class=\"bp\">self</span><span class=\"p\">,</span> obj<span class=\"p\">):</span>\n        <span class=\"c1\"># Returns the polygon.</span>\n        <span class=\"k\">return</span> obj<span class=\"o\">.</span>poly\n</code></pre></div>\n</dd></dl>\n\n</section>\n<section id=\"syndicationfeed-subclasses\">\n<h3><code class=\"docutils literal notranslate\">SyndicationFeed</code> Subclasses<a class=\"heading-anchor\" href=\"#syndicationfeed-subclasses\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>The following <a class=\"reference internal\" href=\"/pt-br/6.1/ref/utils/#django.utils.feedgenerator.SyndicationFeed\" title=\"django.utils.feedgenerator.SyndicationFeed\"><code class=\"xref py py-class docutils literal notranslate\">django.utils.feedgenerator.SyndicationFeed</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\">class</span> </em><span class=\"sig-name descname\">GeoRSSFeed</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.GeoRSSFeed\"><span class=\"visually-hidden\">Link para esta definição</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\">class</span> </em><span class=\"sig-name descname\">GeoAtom1Feed</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.GeoAtom1Feed\"><span class=\"visually-hidden\">Link para esta definição</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\">class</span> </em><span class=\"sig-name descname\">W3CGeoFeed</span><a class=\"heading-anchor\" href=\"#django.contrib.gis.feeds.W3CGeoFeed\"><span class=\"visually-hidden\">Link para esta definição</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\">Nota</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=\"/pt-br/6.1/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\">PointField</code></a> geometries.</p>\n</aside>\n</section>\n</section>","rootId":"module-django.contrib.gis.feeds","toc":[{"title":"Exemplo","anchor":"example","children":[]},{"title":"Referência da API","anchor":"api-reference","children":[{"title":"Feed Subclass","anchor":"feed-subclass","children":[]},{"title":"SyndicationFeed Subclasses","anchor":"syndicationfeed-subclasses","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Referência da API","url":"/pt-br/6.1/ref/"},{"docname":"ref/contrib/index","title":"contrib packages","url":"/pt-br/6.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/pt-br/6.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/admin","title":"GeoDjango’s admin site","url":"/pt-br/6.1/ref/contrib/gis/admin/"},"next":{"docname":"ref/contrib/gis/sitemaps","title":"Geographic Sitemaps","url":"/pt-br/6.1/ref/contrib/gis/sitemaps/"},"formats":{"html":"/pt-br/6.1/ref/contrib/gis/feeds/","markdown":"/pt-br/6.1/ref/contrib/gis/feeds.md","json":"/pt-br/6.1/ref/contrib/gis/feeds.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/contrib/gis/feeds.txt","official":"https://docs.djangoproject.com/pt-br/6.1/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","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}