LogoLogo
Site du RNBGithub
  • Documentation du Référentiel National du Bâtiment (RNB)
  • API et Outils
    • 🛍️Liste des API et outils du RNB
    • 🗺️Tuiles vectorielles
    • 🏨API Bâtiments
      • Consultation d'un bâtiment
      • Listing de bâtiments
      • Identification de bâtiment
      • Différentiel entre deux dates
      • Éditer le RNB
        • Guide d'édition du RNB
    • 🏗️API ADS
    • 🏙️Export national et départemental
    • 🏖️Bac à sable
  • Exemples
    • 🗃️Obtenir des attributs métier à partir d'un identifiant RNB (ID-RNB)
    • 🏪Sélecteur de bâtiments
  • Lexique et définitions
    • 📐Propriétés d'un bâtiment
      • Parcelles cadastrales
  • 📝Lexique du RNB
  • 🪡Cycle de vie de la donnée
  • A propos
    • 🪙Budget
  • 📞Contacter le RNB
Propulsé par GitBook
Sur cette page

Cet article vous a-t-il été utile ?

  1. API et Outils
  2. API Bâtiments

Éditer le RNB

PrécédentDifférentiel entre deux datesSuivantGuide d'édition du RNB

Dernière mise à jour il y a 4 jours

Cet article vous a-t-il été utile ?

Authentification

Toute édition (requête en écriture) du RNB doit faire l’objet d’une authentification. Pour vous identifier, utilisez le token fourni par l’équipe du RNB. Pour faire une demande de token, .

Ajoutez une clé Authorization aux headers HTTP de chacune de vos requêtes. La valeur doit être votre token préfixé de la chaîne “Token”. Un espace sépare “Token” et votre token.

Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b

Bac à sable

Il est vivement recommandé d'utiliser du RNB pour développer et tester vos outils.

🏨
renseignez ce formulaire
l'environnement "bac à sable"
  • Authentification
  • Bac à sable
  • POSTCréation d'un bâtiment
  • PATCHMise à jour ou désactivation/réactivation d'un bâtiment
  • POSTFusion de bâtiments
  • POSTScission de bâtiments

Création d'un bâtiment

post

Cet endpoint permet de créer un bâtiment dans le RNB. Lors de la création, un identifiant RNB (ID-RNB) est généré. L'utilisateur doit être identifié et disposer des droits nécessaires pour écrire dans le RNB.

Corps
commentstringOptionnel

Commentaire optionnel associé à la création du bâtiment.

Example: Bâtiment ajouté suite à une nouvelle construction, visible sur la vue satellite.
statusstring · enumRequis

Statut du bâtiment.

Example: constructedValeurs possibles:
addresses_cle_interoparrayOptionnel

Liste des clés d'interopérabilité BAN liées au bâtiment.

Example: ["75105_8884_00004","75105_8884_00006"]
shapestringRequis

Géométrie du bâtiment au format WKT ou HEX, en WGS84. La géométrie attendue est idéalement un polygone représentant le bâtiment, mais il est également possible de ne donner qu'un point.

Example: POLYGON((2.3522 48.8566, 2.3532 48.8567, 2.3528 48.857, 2.3522 48.8566))
Réponses
200
Détails du bâtiment nouvellement créé dans le RNB
application/json
Réponseall of
400
Requête invalide (données mal formatées ou incomplètes).
403
L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment.
404
Une clé d'interopérabilité n'a pas été trouvée auprès de la BAN
429
Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.
503
Service temporairement indisponible
post
POST /api/alpha/buildings/ HTTP/1.1
Host: rnb-api.beta.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "comment": "Bâtiment ajouté suite à une nouvelle construction, visible sur la vue satellite.",
  "status": "constructed",
  "addresses_cle_interop": [
    "75105_8884_00004",
    "75105_8884_00006"
  ],
  "shape": "POLYGON((2.3522 48.8566, 2.3532 48.8567, 2.3528 48.857, 2.3522 48.8566))"
}
{
  "rnb_id": "PG46YY6YWCX8",
  "status": "constructed",
  "point": {
    "type": "Point",
    "coordinates": [
      -0.570505392116188,
      44.841034137099996
    ]
  },
  "shape": {
    "type": "Point",
    "coordinates": [
      [
        -0.570505392116188,
        44.841034137099996
      ]
    ]
  },
  "addresses": [
    {
      "id": "02191_0020_00003",
      "source": "bdnb",
      "street_number": "3",
      "street_rep": "bis",
      "street": "rue de l'église",
      "city_name": "Chivy-lès-Étouvelles",
      "city_zipcode": "02000",
      "city_insee_code": 2191
    }
  ],
  "ext_ids": [
    {
      "id": "bdnb-bc-3B85-TYM9-FDSX",
      "source": "bdnb",
      "source_version": "2023_01",
      "created_at": "2023-12-07T13:20:58.310444+00:00"
    }
  ],
  "plots": [
    {
      "id": "01402000AB0051",
      "bdg_cover_ratio": 0.403
    }
  ]
}

Mise à jour ou désactivation/réactivation d'un bâtiment

patch

Cet endpoint permet de :

  • mettre à jour un bâtiment existant (status, addresses_cle_interop, shape)
  • désactiver son ID-RNB s'il s'avère qu'il ne devrait pas faire partie du RNB. Par exemple un arbre qui aurait été par erreur répertorié comme un bâtiment du RNB.
  • réactiver un ID-RNB, si celui-ci a été désactivé par erreur.

Il n'est pas possible de simultanément mettre à jour un bâtiment et de le désactiver/réactiver.

Cet endpoint nécessite d'être identifié et d'avoir des droits d'édition du RNB.

Exemples valides:

  • {"comment": "faux bâtiment", "is_active": False}
  • {"comment": "RNB ID désactivé par erreur, on le réactive", "is_active": True}
  • {"comment": "bâtiment démoli", "status": "demolished"}
  • {"comment": "bâtiment en ruine", "status": "notUsable", "addresses_cle_interop": ["75105_8884_00004"]}
Paramètres de chemin
rnb_idstringRequis

Identifiant unique du bâtiment dans le RNB (ID-RNB)

Example: PG46YY6YWCX8
Corps
commentstringOptionnel

Texte associé à la modification et la justifiant.

is_activebooleanOptionnel
  • False : l' ID-RNB est désactivé, car sa présence dans le RNB est une erreur. Ne permet pas de signaler une démolition, qui doit se faire par une mise à jour du statut.
  • True : l'ID-RNB est réactivé. À utiliser uniquement pour annuler une désactivation accidentelle.
statusstring · enumOptionnel

Statut du bâtiment.

Valeurs possibles:
addresses_cle_interoparrayOptionnel

Liste des clés d'interopérabilité BAN liées au bâtiment.

Si ce paramêtre est :

  • absent, alors les clés ne sont pas modifiées.
  • présent et que sa valeur est une liste vide, alors le bâtiment ne sera plus lié à aucune adresse.
shapestringOptionnel

Géométrie du bâtiment au format WKT ou HEX, en WGS84. La géometrie attendue est idéalement un polygone représentant le bâtiment, mais il est également possible de ne donner qu'un point.

Réponses
204
Pas de contenu attendu dans la réponse en cas de succès
400
Requête invalide (données mal formatées ou incomplètes).
403
L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment.
404
ID-RNB inconnu ou une clé d'interopérabilité n'a pas été trouvée auprès de la BAN
429
Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.
503
Service temporairement indisponible
patch
PATCH /api/alpha/buildings/{rnb_id}/ HTTP/1.1
Host: rnb-api.beta.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "comment": "text",
  "is_active": true,
  "status": "constructionProject",
  "addresses_cle_interop": [],
  "shape": "text"
}

Aucun contenu

Fusion de bâtiments

post

Permet de corriger le RNB en fusionnant plusieurs bâtiments existants, donnant lieu à la création d'un nouveau bâtiment.

Cet endpoint nécessite d'être identifié et d'avoir des droits d'édition du RNB.

Corps
commentstringOptionnel

Commentaire optionnel associé à l'opération

rnb_idsarrayRequis

Liste des ID-RNB des bâtiments à fusionner

merge_existing_addressesboolOptionnel
  • True, le bâtiment nouvellement créé hérite des adresses des bâtiments dont il est issu.
  • False ou non rempli, le champ addresses_cle_interop est utilisé pour déterminer les adresses du bâtiment.
addresses_cle_interoparrayOptionnel

Liste des clés d'interopérabilité BAN liées au nouveau bâtiment créé. Si une liste vide est passée, le bâtiment ne sera lié à aucune adresse.

statusstring · enumRequis

Statut du bâtiment.

Example: constructedValeurs possibles:
Réponses
200
Détails du bâtiment nouvellement créé
application/json
Réponseall of
400
Requête invalide (données mal formatées ou incomplètes).
403
L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment.
404
ID-RNB inconnu ou une clé d'interopérabilité n'a pas été trouvée auprès de la BAN
429
Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.
503
Service temporairement indisponible
post
POST /api/alpha/buildings/merge/ HTTP/1.1
Host: rnb-api.beta.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "comment": "text",
  "rnb_ids": [],
  "merge_existing_addresses": null,
  "addresses_cle_interop": [],
  "status": "constructed"
}
{
  "rnb_id": "PG46YY6YWCX8",
  "status": "constructed",
  "point": {
    "type": "Point",
    "coordinates": [
      -0.570505392116188,
      44.841034137099996
    ]
  },
  "shape": {
    "type": "Point",
    "coordinates": [
      [
        -0.570505392116188,
        44.841034137099996
      ]
    ]
  },
  "addresses": [
    {
      "id": "02191_0020_00003",
      "source": "bdnb",
      "street_number": "3",
      "street_rep": "bis",
      "street": "rue de l'église",
      "city_name": "Chivy-lès-Étouvelles",
      "city_zipcode": "02000",
      "city_insee_code": 2191
    }
  ],
  "ext_ids": [
    {
      "id": "bdnb-bc-3B85-TYM9-FDSX",
      "source": "bdnb",
      "source_version": "2023_01",
      "created_at": "2023-12-07T13:20:58.310444+00:00"
    }
  ]
}

Scission de bâtiments

post

Permet de corriger le RNB en scindant un bâtiment existant, donnant lieu à la création de plusieurs nouveaux bâtiments.

Cet endpoint nécessite d'être identifié et d'avoir des droits d'édition du RNB.

Paramètres de chemin
rnb_idstringRequis

Identifiant unique du bâtiment dans le RNB (ID-RNB)

Example: PG46YY6YWCX8
Corps
commentstringOptionnel

Commentaire optionnel associé à l'opération

Réponses
200
Détails des bâtiments nouvellement créés
application/json
400
Requête invalide (données mal formatées ou incomplètes).
403
L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment.
404
ID-RNB inconnu ou une clé d'interopérabilité n'a pas été trouvée auprès de la BAN
429
Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.
503
Service temporairement indisponible
post
POST /api/alpha/buildings/{rnb_id}/split/ HTTP/1.1
Host: rnb-api.beta.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 212

{
  "comment": "text",
  "created_buildings": [
    {
      "status": "constructed",
      "shape": "POLYGON((2.3522 48.8566, 2.3532 48.8567, 2.3528 48.857, 2.3522 48.8566))",
      "addresses_cle_interop": [
        "75105_8884_00004",
        "75105_8884_00006"
      ]
    }
  ]
}
[
  {
    "rnb_id": "PG46YY6YWCX8",
    "status": "constructed",
    "point": {
      "type": "Point",
      "coordinates": [
        -0.570505392116188,
        44.841034137099996
      ]
    },
    "shape": {
      "type": "Point",
      "coordinates": [
        [
          -0.570505392116188,
          44.841034137099996
        ]
      ]
    },
    "addresses": [
      {
        "id": "02191_0020_00003",
        "source": "bdnb",
        "street_number": "3",
        "street_rep": "bis",
        "street": "rue de l'église",
        "city_name": "Chivy-lès-Étouvelles",
        "city_zipcode": "02000",
        "city_insee_code": 2191
      }
    ],
    "ext_ids": [
      {
        "id": "bdnb-bc-3B85-TYM9-FDSX",
        "source": "bdnb",
        "source_version": "2023_01",
        "created_at": "2023-12-07T13:20:58.310444+00:00"
      }
    ]
  }
]