{"title":"Sérialisation GeoJSON","version":"2.1","locale":"fr","docname":"ref/contrib/gis/serializers","url":"/fr/2.1/ref/contrib/gis/serializers/","canonical":"https://djangodocs.dev/fr/2.1/ref/contrib/gis/serializers/","summary":"GeoDjango fournit un sérialiseur spécifique au format GeoJSON. Voir Sérialisation d’objets Django pour plus d’informations sur la sérialisation.","html":"<span id=\"geojson-serializer\"></span><h1>Sérialisation <code class=\"docutils literal notranslate\">GeoJSON</code><a class=\"heading-anchor\" href=\"#module-django.contrib.gis.serializers.geojson\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>GeoDjango fournit un sérialiseur spécifique au format <a class=\"reference external\" href=\"http://geojson.org/\">GeoJSON</a>. Voir <a class=\"reference internal\" href=\"/fr/2.1/topics/serialization/\"><span class=\"doc\">Sérialisation d’objets Django</span></a> pour plus d’informations sur la sérialisation.</p>\n<p>Le sérialiseur <code class=\"docutils literal notranslate\">geojson</code> n’est pas conçu pour des allers-retours de données, car il n’a pas d’équivalent de désérialisation. Par exemple, vous ne pouvez pas utiliser <a class=\"reference internal\" href=\"/fr/2.1/ref/django-admin/#django-admin-loaddata\"><code class=\"xref std std-djadmin docutils literal notranslate\">loaddata</code></a> pour recharger le résultat produit par ce sérialiseur. Si vous pensez devoir recharger les données produites, utilisez plutôt le <a class=\"reference internal\" href=\"/fr/2.1/topics/serialization/#serialization-formats-json\"><span class=\"std std-ref\">sérialiseur json simple</span></a>.</p>\n<p>En plus des options du sérialiseur <code class=\"docutils literal notranslate\">json</code>, le sérialiseur <code class=\"docutils literal notranslate\">geojson</code> accepte l’option supplémentaire suivante lorsqu’il est appelé par <code class=\"docutils literal notranslate\">serializers.serialize()</code>:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\">geometry_field</code>: une chaîne contenant le nom d’un champ géométrique à utiliser pour la clé <code class=\"docutils literal notranslate\">geometry</code> de l’entrée GeoJSON. C’est uniquement nécessaire si un modèle possède plus d’un champ géométrique et que vous ne voulez pas utiliser le premier champ géométrique défini (par défaut, le premier champ géométrique est choisi).</p></li>\n<li><p><code class=\"docutils literal notranslate\">srid</code>: le code SRID à utiliser pour le contenu géométrique. Contient <code class=\"docutils literal notranslate\">4326</code> par défaut (WGS 84).</p></li>\n</ul>\n<p>L’option <a class=\"reference internal\" href=\"/fr/2.1/topics/serialization/#subset-of-fields\"><span class=\"std std-ref\">fields</span></a> peut être utilisée pour limiter les champs qui seront présents dans la clé <code class=\"docutils literal notranslate\">properties</code>, comme cela fonctionne avec d’autres sérialiseurs.</p>\n<p>Exemple :</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.core.serializers</span> <span class=\"kn\">import</span> serialize\n<span class=\"kn\">from</span> <span class=\"nn\">my_app.models</span> <span class=\"kn\">import</span> City\n\nserialize<span class=\"p\">(</span><span class=\"s1\">&#39;geojson&#39;</span><span class=\"p\">,</span> City<span class=\"o\">.</span>objects<span class=\"o\">.</span>all<span class=\"p\">(),</span>\n          geometry_field<span class=\"o\">=</span><span class=\"s1\">&#39;point&#39;</span><span class=\"p\">,</span>\n          fields<span class=\"o\">=</span><span class=\"p\">(</span><span class=\"s1\">&#39;name&#39;</span><span class=\"p\">,))</span>\n</code></pre></div>\n<p>Afficherait :</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=\"p\">{</span>\n  <span class=\"s1\">&#39;type&#39;</span><span class=\"p\">:</span> <span class=\"s1\">&#39;FeatureCollection&#39;</span><span class=\"p\">,</span>\n  <span class=\"s1\">&#39;crs&#39;</span><span class=\"p\">:</span> <span class=\"p\">{</span>\n    <span class=\"s1\">&#39;type&#39;</span><span class=\"p\">:</span> <span class=\"s1\">&#39;name&#39;</span><span class=\"p\">,</span>\n    <span class=\"s1\">&#39;properties&#39;</span><span class=\"p\">:</span> <span class=\"p\">{</span><span class=\"s1\">&#39;name&#39;</span><span class=\"p\">:</span> <span class=\"s1\">&#39;EPSG:4326&#39;</span><span class=\"p\">}</span>\n  <span class=\"p\">},</span>\n  <span class=\"s1\">&#39;features&#39;</span><span class=\"p\">:</span> <span class=\"p\">[</span>\n    <span class=\"p\">{</span>\n      <span class=\"s1\">&#39;type&#39;</span><span class=\"p\">:</span> <span class=\"s1\">&#39;Feature&#39;</span><span class=\"p\">,</span>\n      <span class=\"s1\">&#39;geometry&#39;</span><span class=\"p\">:</span> <span class=\"p\">{</span>\n        <span class=\"s1\">&#39;type&#39;</span><span class=\"p\">:</span> <span class=\"s1\">&#39;Point&#39;</span><span class=\"p\">,</span>\n        <span class=\"s1\">&#39;coordinates&#39;</span><span class=\"p\">:</span> <span class=\"p\">[</span><span class=\"o\">-</span><span class=\"mf\">87.650175</span><span class=\"p\">,</span> <span class=\"mf\">41.850385</span><span class=\"p\">]</span>\n      <span class=\"p\">},</span>\n      <span class=\"s1\">&#39;properties&#39;</span><span class=\"p\">:</span> <span class=\"p\">{</span>\n        <span class=\"s1\">&#39;name&#39;</span><span class=\"p\">:</span> <span class=\"s1\">&#39;Chicago&#39;</span>\n      <span class=\"p\">}</span>\n    <span class=\"p\">}</span>\n  <span class=\"p\">]</span>\n<span class=\"p\">}</span>\n</code></pre></div>\n<p>Lorsque le paramètre <code class=\"docutils literal notranslate\">fields</code> n’est pas précisé, le sérialiseur <code class=\"docutils literal notranslate\">geojson</code> ajoute une clé <code class=\"docutils literal notranslate\">pk</code> au dictionnaire <code class=\"docutils literal notranslate\">properties</code> avec comme valeur la clé primaire de l’objet.</p>","rootId":"module-django.contrib.gis.serializers.geojson","toc":[],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/2.1/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/2.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/fr/2.1/ref/contrib/gis/"},{"docname":"ref/contrib/gis/utils","title":"Utilitaires GeoDjango","url":"/fr/2.1/ref/contrib/gis/utils/"}],"prev":{"docname":"ref/contrib/gis/ogrinspect","title":"Inspection OGR","url":"/fr/2.1/ref/contrib/gis/ogrinspect/"},"next":{"docname":"ref/contrib/gis/commands","title":"Commandes d’administration de GeoDjango","url":"/fr/2.1/ref/contrib/gis/commands/"},"formats":{"html":"/fr/2.1/ref/contrib/gis/serializers/","markdown":"/fr/2.1/ref/contrib/gis/serializers.md","json":"/fr/2.1/ref/contrib/gis/serializers.json"},"source":"https://github.com/django/django/blob/stable/2.1.x/docs/ref/contrib/gis/serializers.txt","official":"https://docs.djangoproject.com/fr/2.1/ref/contrib/gis/serializers/","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","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}