adresse.data.gouv.fr Documentation
website·Indexed 19 days ago
https://doc.adresse.data.gouv.fr/Documentation for managing and publishing a Base Adresse Locale (Local Address Base). It provides guidance on editing address data, certifying addresses, managing the publication process, tracking updates, and handling improvement requests such as modifications, creations, and deletions of address entries.
What's inside adresse.data.gouv.fr
- The Base Adresse Nationale (BAN) is the official reference database for all geolocated addresses across the French national territory. It is part of the Service Public des Données de référence. The database contains only the existence and geographic location of addresses and does not contain any personal data.
Overview of the Mes Adresses Local Address Database editor
Mes Adresses is a free, web-based editor developed by Etalab (DINUM) and maintained by the ANCT. It allows local authorities (municipalities or EPCIs) to create, manage, and publish a Local Address Database (Base Adresse Locale), which serves as the official reference for geolocated addresses transmitted to the National Address Database (BAN). The tool requires no software installation or expert technical skills and includes built-in tutorials accessible via the 'Besoin d’Aide ?' button.Overview of the Base Adresse Nationale (BAN)
The Base Adresse Nationale (BAN) is a free, open-source, and collaborative reference dataset for addresses in France. It aggregates address files produced by approximately 35,000 municipalities (communes) responsible for territorial addressing. The BAN's evolution is driven by user needs to maximize the reuse of address data across different systems and support the 'dites-le nous une fois' (tell us once) initiative. Development is coordinated through a user collective and participatory workshops known as 'Adresse-lab'.Overview of the adresse.data.gouv.fr portal and BAN
The adresse.data.gouv.fr portal provides access to the Base Adresse Nationale (BAN), the French national reference database for addresses managed by the Institut National de l'Information Géographique et Forestière (IGN). It also provides tools and services for municipalities to update their addresses and publish their Local Address Bases (Bases Adresses Locales). The ecosystem is provided under an Open License.Submit addresses to the BAN using the Deposit API
The Deposit API (L’API de dépôt) allows for a "push" approach to transmit address data to the National Address Base (BAN). This tool is specifically intended for software editors and solution integrators.Understand the address reporting and improvement workflow
The reporting system allows any individual to propose a fix for a field-level address issue—such as a creation, modification, or deletion—using the 'Mes Signalements' tool. Once a report is submitted, the proposal is transmitted to the administrator via 'Mes Adresses', where it can be reviewed and integrated with a single click. This process is designed to improve official address data through citizen involvement and reduce the manual workload for municipal addressing officers.Understand the local address base publication process
After authentication, the publication of a local address base is immediate. All addresses for the municipality are transmitted to the Base Adresse Nationale (BAN) without modification. The municipality becomes the official source of these addresses. Once the synchronization with the BAN is complete, the system will display an 'À jour' (Up to date) status button.Target audience for BAN identifier technical management
Technical identifier management must be transparent to municipalities (communes). This guidance is specifically intended for data producers responsible for providing BALs (Bases d'Adresses Locales) and those maintaining the identifiers, such as database administrators and software editors for BAL entry and updates.Use the Mes Adresses editing interface
The 'Mes Adresses' editor provides a dual-pane interface for managing local address bases:
- Side Panel: Used for searching streets or toponyms, correcting spelling, renaming entities, and adding or deleting numbers, streets, or toponyms.
- Central Map View: Provides IGN (aerial imagery), OpenMapTiles, and cadastral layers. Use this area to:
- Verify address locations.
- Drag and drop numbers to reposition them.
- Associate a house number with a specific cadastral parcel.
- Position toponyms for hamlets and place-names.
- Measure street lengths for metric numbering.
- Create new addresses quickly using the green button on the right.
- Toggle toponym visibility using the eye icon.
Requirements for technical identifiers in the BAN framework
According to the 'Cadre Commun d'Architecture des Référentiel de données', technical identifiers must be strictly separated from business identity data. A valid technical identifier must meet the following criteria:
- Easily shareable: Must use an interoperable format.
- Unambiguous: Must uniquely identify a single business object.
- Non-significant: Must not contain business or technical data that could change over time, nor any personal or confidential information.
- Immutable: Once assigned, it must never be modified.
- Non-reassignable: It cannot be assigned to a different business object, even if the original object no longer exists.
- Non-deletable: It must be preserved even if the object it represents is removed (e.g., a bankrupt company).
- Persistent: It must be stored, conserved, and archived over time.
Use the Mes Adresses online editor for Local Address Base management
The 'Mes Adresses' editor is a free, open-source web-based tool designed for non-technical users (such as elected officials, town hall secretaries, and urban planning agents) to modify and publish their Local Address Base (Base Adresse Locale) directly to the National Address Base (Base Adresse Nationale) via a real-time deposit API.
Key capabilities include:
- Support for the latest Local Address Base format, including certification, parcel-address linking, regional languages, and hamlets (lieux-dits).
- Ability to add custom map backgrounds in addition to provided defaults.
- Low-bandwidth compatibility as it focuses on legal addressing rather than road tracing.
- Integrated step-by-step tutorials and online guides (text/PDF).
Constraints and Limitations:
- Not multi-tasking: Multiple administrators can exist, but they cannot edit simultaneously.
- Device compatibility: Does not work on tablets.
- Scale: Not recommended for very large municipalities due to slower map background loading.
- Data organization: Streets without addresses are listed with hamlets (lieux-dits) in the toponym list, which may cause confusion.
Understand Base Adresse Locale (BAL) and Base Adresse Nationale (BAN)
The Base Adresse Locale (BAL) is the data file containing all addresses for a specific municipality, following a format defined by the AITF to ensure interoperability. The Base Adresse Nationale (BAN) is the free, open national address database managed by the Service Public de la Donnée. Municipalities publish their BAL into the BAN to make their local addresses accessible via the official commune pages, department downloads, and the public API.