# Éditer le RNB
### Pré-requis, cultivez-vous 🙂
{% hint style="success" %}
Avant de modifier des données dans le RNB, assurez-vous de respecter : \
\
1\) **la définition officielle du bâtiment**, établie par le Conseil national de l’information géolocalisée (CNIG). Au besoin, relisez la [définition](https://rnb.beta.gouv.fr/definition) du bâtiment au sens du RNB.
2\) **l'art de l'édition dans le RNB**. Lisez les astuces pour bien éditer sur le [Guide d’édition](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/editer-le-rnb/guide-dedition-du-rnb?ref=referentiel-national-du-batiment.ghost.io)\
\
Pour que le RNB remplisse son rôle correctement, il est important que tous ses éditeurs et éditrices partagent une même méthodologie.
{% endhint %}
{% hint style="info" %}
Dans cet esprit et pour éviter toute erreur massive lors de contributions en production, un **quota évolutif est établi par utilisateur.** Il est par défaut de 500 éditions, et est mis-à-jour par paliers après vérification des premières contributions.
{% endhint %}
### 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 ce faire : \
\
**1°** 🚀 **Demandez vos accès sur** [**https://rnb.beta.gouv.fr/login**](https://rnb.beta.gouv.fr/login) \
**2° Une fois vos identifiants créés, cliquez sur "Mon compte" pour accéder à ''Mes Cles API''.**
**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
{% hint style="info" %}
Il est vivement recommandé d'utiliser [l'environnement "bac à sable"](/documentation/api-et-outils/bac-a-sable.md) du RNB pour développer et tester vos outils.
{% endhint %}
## Création d'un bâtiment
> 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.
```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/":{"post":{"summary":"Création d'un bâtiment","description":"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.","operationId":"postBuilding","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"Commentaire optionnel associé à la création du bâtiment."},"status":{"type":"string","enum":["constructed","notUsable","demolished"],"description":"Statut du bâtiment."},"addresses_cle_interop":{"type":"array","description":"Liste des clés d'interopérabilité BAN liées au bâtiment, éventuellement vide (`[]`) en l'absence d'adresse à attribuer."},"shape":{"type":"string","description":"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."}},"required":["status","shape","addresses_cle_interop"]}}}},"responses":{"201":{"description":"Détails du bâtiment nouvellement créé dans le RNB","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Building"},{"$ref":"#/components/schemas/BuildingWPlots"}]}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"403":{"description":"L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment."},"404":{"description":"Une clé d'interopérabilité n'a pas été trouvée auprès de la BAN"},"429":{"description":"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.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."},"503":{"description":"Service temporairement indisponible"}}}}},"components":{"schemas":{"Building":{"type":"object","properties":{"rnb_id":{"$ref":"#/components/schemas/RNBID"},"status":{"$ref":"#/components/schemas/BuildingStatus"},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"$ref":"#/components/schemas/BuildingShape"},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"$ref":"#/components/schemas/BuildingAddress"}},"marked_as_correct_by":{"type":"array","description":"Liste des utilisateurs ayant marqué ce bâtiment comme correct. Un bâtiment marqué comme correct par un utilisateur est un bâtiment que cet utilisateur considère comme correspondant à la définition d'un bâtiment et dont il pense que les attributs statut, géométrie et adresses sont corrects.","items":{"$ref":"#/components/schemas/PublicUser"}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":"string","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}},"PublicUser":{"type":"object","properties":{"id":{"type":"integer"},"username":{"type":"string"},"display_name":{"type":"string","description":"Nom à afficher pour l'utilisateur. Il peut s'agir du nom d'utilisateur ou d'un nom plus complet si celui-ci a été renseigné par l'utilisateur."}}},"ExtId":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."},"BuildingWPlots":{"type":"object","properties":{"plots":{"$ref":"#/components/schemas/BuildingPlots"}}},"BuildingPlots":{"type":"array","description":"Liste des parcelles cadastrales intersectant le bâtiment. Disponible si le paramètre withPlots=1
est intégré à l'URL de requête. NB: il s'agit d'un croisement géométrique et non d'une donnée fiscale. Il arrive parfois qu'un bâtiment intersecte une mauvaise parcelle du fait d'un décalage géographique entre les bâtiments du cadastre et ceux du RNB. Nous fournissons avec chaque parcelle cadastrale le taux d'intersection du bâtiment avec celle-ci. Les parcelles intersectant largement un bâtiment sont plus susceptibles d'être réellement associées à ce bâtiment d'un point de vue fiscal.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de la parcelle."},"bdg_cover_ratio":{"type":"number","description":"Taux d'intersection du bâtiment par la parcelle. Ce taux est compris entre 0 et 1. Un taux de 1 signifie que la parcelle couvre entièrement le bâtiment."}}}}}}}
```
## Mise à jour ou désactivation/réactivation d'un bâtiment
> 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.\
> \* marquer un bâtiment comme correct.\
> \
> Il n'est pas possible de simultanément mettre à jour un bâtiment et de le désactiver/réactiver.\
> Il n'est pas possible de simultanément marquer un bâtiment comme correct 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"]}\`\`\`\
> \* \`\`\`{"comment": "je marque que ce bâtiment est correct", "mark\_as\_correct": True}\`\`\`
````json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/{rnb_id}/":{"patch":{"summary":"Mise à jour ou désactivation/réactivation d'un bâtiment","description":"Cet endpoint permet de :\n* mettre à jour un bâtiment existant (status, addresses_cle_interop, shape)\n* désactiver son ID-RNB s'il s'avère qu'il ne devrait pas faire partie du\n RNB. Par exemple un arbre qui aurait été par erreur répertorié comme un\n bâtiment du RNB.\n* réactiver un ID-RNB, si celui-ci a été désactivé par erreur.\n* marquer un bâtiment comme correct.\n\nIl n'est pas possible de simultanément mettre à jour un bâtiment et de le désactiver/réactiver.\nIl n'est pas possible de simultanément marquer un bâtiment comme correct et de le désactiver/réactiver.\n\nCet endpoint nécessite d'être identifié et d'avoir des droits d'édition du RNB.\n\nExemples valides:\n* ```{\"comment\": \"faux bâtiment\", \"is_active\": False}```\n* ```{\"comment\": \"RNB ID désactivé par erreur, on le réactive\", \"is_active\": True}```\n* ```{\"comment\": \"bâtiment démoli\", \"status\": \"demolished\"}```\n* ```{\"comment\": \"bâtiment en ruine\", \"status\": \"notUsable\", \"addresses_cle_interop\": [\"75105_8884_00004\"]}```\n* ```{\"comment\": \"je marque que ce bâtiment est correct\", \"mark_as_correct\": True}```\n","operationId":"patchBuilding","parameters":[{"name":"rnb_id","in":"path","description":"Identifiant unique du bâtiment dans le RNB (ID-RNB)","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"Texte associé à la modification et la justifiant.","exemple":"Ce n'est pas un bâtiment mais un arbre."},"is_active":{"type":"boolean","description":"* `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.\n* `True` : l'ID-RNB est réactivé. À utiliser uniquement pour annuler une désactivation accidentelle."},"status":{"type":"string","enum":["constructed","notUsable","demolished"],"description":"Statut du bâtiment.","exemple":"demolished"},"addresses_cle_interop":{"type":"array","description":"Liste des clés d'interopérabilité BAN liées au bâtiment.\n\nSi ce paramêtre est :\n* absent, alors les clés ne sont pas modifiées.\n* présent et que sa valeur est une liste vide (`[]`), alors le bâtiment ne sera plus lié à aucune adresse.","exemple":["75105_8884_00004","75105_8884_00006"]},"shape":{"type":"string","description":"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."},"mark_as_correct":{"type":"boolean","description":"Permet à l'utilisateur de marquer que l'état actuel du bâtiment est correct (`True`) ou de retirer cette indication s'il l'avait précédemment marquée (`False`).\n\n* Peut être envoyé seul ou en complément d'une modification (`status`, `addresses_cle_interop`, `shape`).\n* Lorsqu'un bâtiment est modifié, la liste des utilisateurs l'ayant marqué comme correct est réinitialisée."}},"required":[]}}}},"responses":{"204":{"description":"Pas de contenu attendu dans la réponse en cas de succès"},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"403":{"description":"L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment."},"404":{"description":"ID-RNB inconnu ou une clé d'interopérabilité n'a pas été trouvée auprès de la BAN"},"429":{"description":"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.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."},"503":{"description":"Service temporairement indisponible"}}}}}}
````
## Fusion de bâtiments
> 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.\
>
```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/merge/":{"post":{"summary":"Fusion de bâtiments","description":"Permet de corriger le RNB en fusionnant plusieurs bâtiments existants, donnant lieu à la création d'un nouveau bâtiment.\n\nCet endpoint nécessite d'être identifié et d'avoir des droits d'édition du RNB.\n ","operationId":"mergeBuildings","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"Commentaire optionnel associé à l'opération"},"rnb_ids":{"type":"array","description":"Liste des ID-RNB des bâtiments à fusionner","exemple":["XXXXYYYYZZZZ","AAAABBBBCCCC"]},"merge_existing_addresses":{"type":"boolean","description":"- `True`, le bâtiment nouvellement créé hérite des adresses des bâtiments dont il est issu.\n- `False` ou non rempli, le champ `addresses_cle_interop` est utilisé pour déterminer les adresses du bâtiment."},"addresses_cle_interop":{"type":"array","description":"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.","exemple":["75105_8884_00004","75105_8884_00006"]},"status":{"type":"string","enum":["constructed","notUsable","demolished"],"description":"Statut du bâtiment."}},"required":["rnb_ids","status"]}}}},"responses":{"201":{"description":"Détails du bâtiment nouvellement créé","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Building"}]}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"403":{"description":"L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment."},"404":{"description":"ID-RNB inconnu ou une clé d'interopérabilité n'a pas été trouvée auprès de la BAN"},"429":{"description":"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.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."},"503":{"description":"Service temporairement indisponible"}}}}},"components":{"schemas":{"Building":{"type":"object","properties":{"rnb_id":{"$ref":"#/components/schemas/RNBID"},"status":{"$ref":"#/components/schemas/BuildingStatus"},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"$ref":"#/components/schemas/BuildingShape"},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"$ref":"#/components/schemas/BuildingAddress"}},"marked_as_correct_by":{"type":"array","description":"Liste des utilisateurs ayant marqué ce bâtiment comme correct. Un bâtiment marqué comme correct par un utilisateur est un bâtiment que cet utilisateur considère comme correspondant à la définition d'un bâtiment et dont il pense que les attributs statut, géométrie et adresses sont corrects.","items":{"$ref":"#/components/schemas/PublicUser"}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":"string","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}},"PublicUser":{"type":"object","properties":{"id":{"type":"integer"},"username":{"type":"string"},"display_name":{"type":"string","description":"Nom à afficher pour l'utilisateur. Il peut s'agir du nom d'utilisateur ou d'un nom plus complet si celui-ci a été renseigné par l'utilisateur."}}},"ExtId":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."}}}}
```
## Scission de bâtiments
> 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.
```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/{rnb_id}/split/":{"post":{"summary":"Scission de bâtiments","description":"Permet de corriger le RNB en scindant un bâtiment existant, donnant lieu à la création de plusieurs nouveaux bâtiments.\n\nCet endpoint nécessite d'être identifié et d'avoir des droits d'édition du RNB.","operationId":"splitBuildings","parameters":[{"name":"rnb_id","in":"path","description":"Identifiant unique du bâtiment dans le RNB (ID-RNB)","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"Commentaire optionnel associé à l'opération"},"created_buildings":{"type":"array","description":"Liste des bâtiments issus de la scission.","items":{"type":"object","properties":{"status":{"type":"string","enum":["constructed","notUsable","demolished"],"description":"Statut du bâtiment."},"shape":{"type":"string","description":"Géométrie du bâtiment au format WKT ou HEX, en WGS84."},"addresses_cle_interop":{"type":"array","description":"Liste des clés interopérables des adresses associées"}},"required":["status","shape","addresses_cle_interop"]}}},"required":["rnb_id","created_buildings"]}}}},"responses":{"201":{"description":"Détails des bâtiments nouvellement créés","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Building"}}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"403":{"description":"L'utilisateur n'a pas les droits nécessaires pour créer un bâtiment."},"404":{"description":"ID-RNB inconnu ou une clé d'interopérabilité n'a pas été trouvée auprès de la BAN"},"429":{"description":"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.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."},"503":{"description":"Service temporairement indisponible"}}}}},"components":{"schemas":{"Building":{"type":"object","properties":{"rnb_id":{"$ref":"#/components/schemas/RNBID"},"status":{"$ref":"#/components/schemas/BuildingStatus"},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"$ref":"#/components/schemas/BuildingShape"},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"$ref":"#/components/schemas/BuildingAddress"}},"marked_as_correct_by":{"type":"array","description":"Liste des utilisateurs ayant marqué ce bâtiment comme correct. Un bâtiment marqué comme correct par un utilisateur est un bâtiment que cet utilisateur considère comme correspondant à la définition d'un bâtiment et dont il pense que les attributs statut, géométrie et adresses sont corrects.","items":{"$ref":"#/components/schemas/PublicUser"}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":"string","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}},"PublicUser":{"type":"object","properties":{"id":{"type":"integer"},"username":{"type":"string"},"display_name":{"type":"string","description":"Nom à afficher pour l'utilisateur. Il peut s'agir du nom d'utilisateur ou d'un nom plus complet si celui-ci a été renseigné par l'utilisateur."}}},"ExtId":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/editer-le-rnb.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.