{"title":"Sérialisation GeoJSON","version":"4.1","locale":"fr","docname":"ref/contrib/gis/serializers","url":"/fr/4.1/ref/contrib/gis/serializers/","canonical":"https://djangodocs.dev/fr/4.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. Le sérialiseur…","html":"<span id=\"geojson-serializer\"></span><h1>Sérialisation <code class=\"docutils literal notranslate\"><span class=\"pre\">GeoJSON</span></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=\"https://geojson.org/\">GeoJSON</a>. Voir <a class=\"reference internal\" href=\"/fr/4.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\"><span class=\"pre\">geojson</span></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/4.1/ref/django-admin/#django-admin-loaddata\"><code class=\"xref std std-djadmin docutils literal notranslate\"><span class=\"pre\">loaddata</span></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/4.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\"><span class=\"pre\">json</span></code>, le sérialiseur <code class=\"docutils literal notranslate\"><span class=\"pre\">geojson</span></code> accepte l’option supplémentaire suivante lorsqu’il est appelé par <code class=\"docutils literal notranslate\"><span class=\"pre\">serializers.serialize()</span></code>:</p>\n<ul class=\"simple\">\n<li><p><code class=\"docutils literal notranslate\"><span class=\"pre\">geometry_field</span></code>: une chaîne contenant le nom d’un champ géométrique à utiliser pour la clé <code class=\"docutils literal notranslate\"><span class=\"pre\">geometry</span></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\"><span class=\"pre\">srid</span></code>: le code SRID à utiliser pour le contenu géométrique. Contient <code class=\"docutils literal notranslate\"><span class=\"pre\">4326</span></code> par défaut (WGS 84).</p></li>\n</ul>\n<p>L’option <a class=\"reference internal\" href=\"/fr/4.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\"><span class=\"pre\">properties</span></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=\"w\"> </span><span class=\"nn\">django.core.serializers</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">serialize</span>\n<span class=\"kn\">from</span><span class=\"w\"> </span><span class=\"nn\">my_app.models</span><span class=\"w\"> </span><span class=\"kn\">import</span> <span class=\"n\">City</span>\n\n<span class=\"n\">serialize</span><span class=\"p\">(</span><span class=\"s1\">&#39;geojson&#39;</span><span class=\"p\">,</span> <span class=\"n\">City</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">all</span><span class=\"p\">(),</span>\n          <span class=\"n\">geometry_field</span><span class=\"o\">=</span><span class=\"s1\">&#39;point&#39;</span><span class=\"p\">,</span>\n          <span class=\"n\">fields</span><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\"><span class=\"pre\">fields</span></code> n’est pas précisé, le sérialiseur <code class=\"docutils literal notranslate\"><span class=\"pre\">geojson</span></code> ajoute une clé <code class=\"docutils literal notranslate\"><span class=\"pre\">pk</span></code> au dictionnaire <code class=\"docutils literal notranslate\"><span class=\"pre\">properties</span></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/4.1/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/4.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/fr/4.1/ref/contrib/gis/"},{"docname":"ref/contrib/gis/utils","title":"Utilitaires GeoDjango","url":"/fr/4.1/ref/contrib/gis/utils/"}],"prev":{"docname":"ref/contrib/gis/ogrinspect","title":"Inspection OGR","url":"/fr/4.1/ref/contrib/gis/ogrinspect/"},"next":{"docname":"ref/contrib/gis/commands","title":"Commandes d’administration de GeoDjango","url":"/fr/4.1/ref/contrib/gis/commands/"},"formats":{"html":"/fr/4.1/ref/contrib/gis/serializers/","markdown":"/fr/4.1/ref/contrib/gis/serializers.md","json":"/fr/4.1/ref/contrib/gis/serializers.json"},"source":"https://github.com/django/django/blob/stable/4.1.x/docs/ref/contrib/gis/serializers.txt","official":"https://docs.djangoproject.com/fr/4.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","it","pt-br","ko","es","el","pl"]}