# Éditer le RNB dans les règles de l'art

#### 🚀 **Le RNB s’ouvre à l’édition collaborative. Partagez la connaissance de votre territoire et bénéficiez en retour des améliorations apportées par la communauté pour une donnée bâtimentaire la plus proche du terrain !**&#x20;

{% hint style="info" %}
Il est important pour **garantir la qualité et l'uniformité du RNB** que tous les contributeurs et contributrices **éditent le RNB en suivant les mêmes consignes.** Cette page a pour but de les lister et de les expliquer.
{% endhint %}

## <mark style="color:$primary;">Préalable</mark>&#x20;

{% 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.<br>

2\) **l'art de l'édition dans le RNB**. Lisez les astuces pour bien éditer sur cette page.\
\
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 %}

**A vous de jouer :**&#x20;

1\) Demandez vos accès sur <https://rnb.beta.gouv.fr/login> 🚀

2\) Deux outils d'édition :\
1° l’[API d'édition](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/editer-le-rnb) dans le RNB \
2° Une [carte interactive](https://rnb.beta.gouv.fr/)\
ℹ Quel que soit le mode de contribution utilisé, les actions réalisables dans le référentiel restent les mêmes.

## [Créér un bâtiment](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/ecrire-dans-le-rnb#api-alpha-buildings)

#### Quand créer un bâtiment ?

Créez un bâtiment lorsque celui-ci est manquant dans le référentiel. La création du bâtiment dans le RNB lui attribuera immédiatement un ID-RNB.

<figure><img src="/files/UFEymrsAg1SWk5eGasKd" alt=""><figcaption><p>Un bâtiment visible sur la vue satellite mais manquant dans le RNB, qui a très envie d'être créé !</p></figcaption></figure>

#### Pourquoi et comment lui attribuer une/des adresse(s) ?

Le lien bâtiment-adresse est une donnée fondamentale du RNB. Identifier un bâtiment grâce à son adresse est l'une des manières les plus répandues de le faire. Lorsque vous créez un bâtiment essayez de toujours lui associer son adresse, voire ses adresses s'il en a plusieurs.

L'ajout d'une adresse se fait via un clé d'interopérabilité de la [BAN](https://adresse.data.gouv.fr/decouvrir-la-BAN). Il existe plusieurs manières de récupérer une clé d’interopérabilité, via l'[API](https://geoservices.ign.fr/documentation/services/services-geoplateforme/geocodage) de la BAN ou via leur [cartographie](https://adresse.data.gouv.fr/carte-base-adresse-nationale) en ligne.

La BAN est par ailleurs en train de mettre en place un identifiant BAN qui offre certaines garanties supplémentaires d'unicité et de pérennité. Lorsque la mise en place sera complète, c'est à dire que toutes les adresses auront un identifiant BAN attribué, le RNB utilisera cet identifiant à la place de la clé d'interopérabilité.

#### Quelle géométrie donner à un bâtiment ?

**La géométrie du RNB n'a pas pour objectif d'être la source de vérité, ni la source officielle quand à la géométrie physique du bâtiment.** \
\
Les géométries présentes dans le RNB permettent avant tout d'identifier le bâtiment physique auquel est attribué un ID-RNB. Certaines géométries sont issues de relevés aériens, tandis que d'autres représentent des emprises au sol. Il arrive également que la forme d'un bâtiment nous soit inconnue et qu'il soit représenté dans le RNB par un simple point.

La géométrie attendue est donc la meilleure possible (un polygone sera plus utile qu'un point) mais le RNB n'impose pas de contraintes la concernant.

En cas de doutes, privilégier :&#x20;

* Une emprise au sol ou à la base du bâtiment
* Une emprise au toit si l'emprise au sol est difficile à évaluer
* Une approximation d'une de ces deux valeurs

Une approximation sera toujours mieux qu'aucune information pour identifier ledit bâtiment.

{% hint style="info" %}
**Le RNB ne permet pas de représenter des bâtiments superposés à ce stade.**\
\
Dans ce cas, il convient de représenter un seul bâtiment avec l'emprise de l'union des bâtiments superposés.\
\
Nous envisageons de faire évoluer le référentiel afin de mieux prendre en compte ces cas dans une version future.
{% endhint %}

#### Quel statut donner à un bâtiment ?

<mark style="color:purple;">`constructionProject`</mark> : En projet

Un bâtiment en projet de construction qui n'existe donc pas encore dans le monde physique. Un permis de construire va (prochainement) typiquement donner lieu à la création d'un bâtiment avec ce statut. Même si le bâtiment n'existe pas encore, il peut être déjà utile d’échanger de l'information à son propos grâce à son ID-RNB.

<mark style="color:purple;">`canceledConstructionProject`</mark> : Projet annulé

Le projet de construction a été annulé, le bâtiment ne sera finalement pas construit.

<mark style="color:purple;">`constructed`</mark> : Construit

Un bâtiment construit, comme la plupart de ceux que nous voyons autour de nous. Ce statut est le plus répandu dans le RNB.

<mark style="color:purple;">`notUsable`</mark> **:** Non utilisable / ruine

Un bâtiment existant mais dont l'état de dégradation ne permet plus son utilisation. Les bâtiments abandonnés, aux toits effondrés, les ruines ont ce statut.&#x20;

<mark style="color:purple;">`demolished`</mark> : Démoli

Le bâtiment a été démoli. Même si le bâtiment n'existe plus physiquement, il peut être utile de continuer à échanger de l'information à son propos grâce à son ID-RNB qui lui reste bien actif !

## [Mettre à jour un bâtiment](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/ecrire-dans-le-rnb#api-alpha-buildings-rnb_id)

#### Quand mettre à jour un bâtiment ?

Lorsqu'un un bâtiment existe déjà dans le RNB, mais que ses attributs sont erronés ou périmés, il convient de le mettre à jour. En pratique, son ID-RNB reste inchangé, mais ses attributs sont mis à jour. Il est possible de modifier :

* sa géométrie
* sa/ses adresses
* son statut

Des cas typiques nécessitant une mise à jour d'un bâtiment :

* géométrie imprécise ou réduite à un point
* adresse manquante ou erronée
* bâtiment démoli, nécessitant que son statut soit passé à `demolished.`

{% hint style="info" %}
Attention à ne pas [confondre](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/editer-le-rnb/guide-dedition-du-rnb#quelle-difference-avec-une-mise-a-jour-de-son-statut-en-demolished) une démolition avec une désactivation de ID-RNB.
{% endhint %}

## [Fusionner plusieurs bâtiments](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/ecrire-dans-le-rnb#api-alpha-buildings-merge)

#### Quand fusionner des bâtiments ?

Lorsque plusieurs bâtiments existent dans le RNB, chacun ayant son propre ID-RNB, mais que la [définition du bâtiment](https://rnb.beta.gouv.fr/definition) nous permet d'affirmer qu'il s'agit du même bâtiment, il faut alors fusionner ces bâtiments ensemble.

Lors d'une fusion, tous les ID-RNB des bâtiments fusionnés sont désactivés, tandis qu'un nouveau bâtiment est créé dans le RNB et se voit attribué un nouvel ID-RNB. Le lien "de parenté" entre les bâtiments fusionnés et le bâtiment créé est historisé par le RNB.

<figure><img src="/files/v5BmMMZBa5jkjuFek8IH" alt=""><figcaption><p>Un seul bâtiment est représenté à tord dans le RNB par deux bâtiments qu'il convient de fusionner</p></figcaption></figure>

## [Scinder un bâtiment](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/ecrire-dans-le-rnb#api-alpha-buildings-rnb_id-split)

#### Quand scinder un bâtiment ?

C'est le cas inverse de la fusion.

Lorsque le RNB ne contient qu'un seul bâtiment, mais que selon la définition du bâtiment, il y a en réalité plusieurs bâtiments, il convient de scinder le bâtiment en plusieurs.

Lors d'une scission, l'ID-RNB du bâtiment scindé est alors désactivé, tandis que plusieurs ID-RNB sont créés et attribués aux bâtiments issus de la scission. Le lien de "parenté" entre le bâtiments scindé et les bâtiments créés est historisé par le RNB.

<figure><img src="/files/MJSfRXUW4OIHuvZryyZF" alt=""><figcaption><p>Cette barre d'immeuble comporte en réalité 3 entrées indépendantes et autant de cages d'escalier qui ne communiquent pas entre elles. Il convient de la scinder en 3.</p></figcaption></figure>

## [Désactiver un ID-RNB](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/ecrire-dans-le-rnb#api-alpha-buildings-rnb_id)

#### Quand désactiver un ID-RNB ?

Il arrive qu'un ID-RNB soit attribué à tord à autre chose qu'un bâtiment. Un arbre par exemple, ou à rien du tout ! Il faut alors désactiver cet ID-RNB.

<figure><img src="/files/uiZk9Ud9HcwclrexzZ95" alt=""><figcaption><p>Il n'y a pas de bâtiment ici, mais un arbre</p></figcaption></figure>

#### Quelle différence avec une mise à jour de son statut en demolished ?

Un bâtiment démoli a existé, mais a été démoli. Il reste utile de pouvoir y faire référence via son ID-RNB.

Au contraire, un bâtiment qui n'a jamais existé dans la réalité n'intéresse à priori personne. Son identifiant doit donc être désactivé.

## [Réactiver un ID-RNB](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/ecrire-dans-le-rnb#api-alpha-buildings-rnb_id)

Cette opération permet uniquement d'annuler une désactivation accidentelle d'un ID-RNB.


---

# 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/guides/editer-le-rnb-dans-les-regles-de-lart.md?ask=<question>
```

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.
