# BAN French Address File

The Base Adresse Nationale (BAN) is France's official open national address database, covering metropolitan France and the overseas départements down to the house-number level.

Address from France's Base Adresse Nationale (BAN), the official open national address database published via Etalab.

BAN reaches house-number level only (`numero` + street + commune) - it carries no sub-premise (unit, floor, building) data.

## Example Record

| Field                                                         | Example                     | Type      |
| ------------------------------------------------------------- | --------------------------- | --------- |
| [`id`](#id)                                                   | ban\_01002\_w4ld4h\_00006   | `string`  |
| [`dataset`](#dataset)                                         | ban                         | `string`  |
| [`country`](#country)                                         | France                      | `string`  |
| [`country_iso`](#country_iso)                                 | FRA                         | `string`  |
| [`country_iso_2`](#country_iso_2)                             | FR                          | `string`  |
| [`language`](#language)                                       | fr                          | `string`  |
| [`address`](#address)                                         | 6                           | `string`  |
| [`line_1`](#line_1)                                           | 6 place du Pese Lait        | `string`  |
| [`line_2`](#line_2)                                           | 01640 L'Abergement-de-Varey | `string`  |
| [`latitude`](#latitude)                                       | `46.005447`                 | `number`  |
| [`longitude`](#longitude)                                     | `5.425179`                  | `number`  |
| [`id_fantoir`](#id_fantoir)                                   | `null`                      | `object`  |
| [`numero`](#numero)                                           | `6`                         | `number`  |
| [`rep`](#rep)                                                 | `null`                      | `object`  |
| [`nom_voie`](#nom_voie)                                       | Place du Pese Lait          | `string`  |
| [`code_postal`](#code_postal)                                 | 01640                       | `string`  |
| [`code_insee`](#code_insee)                                   | 01002                       | `string`  |
| [`nom_commune`](#nom_commune)                                 | L'Abergement-de-Varey       | `string`  |
| [`code_insee_ancienne_commune`](#code_insee_ancienne_commune) | `null`                      | `object`  |
| [`nom_ancienne_commune`](#nom_ancienne_commune)               | `null`                      | `object`  |
| [`x`](#x)                                                     | 887643.67                   | `string`  |
| [`y`](#y)                                                     | 6547960.53                  | `string`  |
| [`lon`](#lon)                                                 | 5.425179                    | `string`  |
| [`lat`](#lat)                                                 | 46.005447                   | `string`  |
| [`type_position`](#type_position)                             | entrée                      | `string`  |
| [`alias`](#alias)                                             | `null`                      | `object`  |
| [`nom_ld`](#nom_ld)                                           | `null`                      | `object`  |
| [`libelle_acheminement`](#libelle_acheminement)               | ABERGEMENT-DE-VAREY (L )    | `string`  |
| [`nom_afnor`](#nom_afnor)                                     | PLACE DU PESE LAIT          | `string`  |
| [`source_position`](#source_position)                         | commune                     | `string`  |
| [`source_nom_voie`](#source_nom_voie)                         | commune                     | `string`  |
| [`certification_commune`](#certification_commune)             | `true`                      | `boolean` |
| [`cad_parcelles`](#cad_parcelles)                             | 01002000AE0005              | `string`  |

```json
{
  "id": "ban_01002_w4ld4h_00006",
  "dataset": "ban",
  "country": "France",
  "country_iso": "FRA",
  "country_iso_2": "FR",
  "language": "fr",
  "address": "6",
  "line_1": "6 place du Pese Lait",
  "line_2": "01640 L'Abergement-de-Varey",
  "latitude": 46.005447,
  "longitude": 5.425179,
  "id_fantoir": null,
  "numero": 6,
  "rep": null,
  "nom_voie": "Place du Pese Lait",
  "code_postal": "01640",
  "code_insee": "01002",
  "nom_commune": "L'Abergement-de-Varey",
  "code_insee_ancienne_commune": null,
  "nom_ancienne_commune": null,
  "x": "887643.67",
  "y": "6547960.53",
  "lon": "5.425179",
  "lat": "46.005447",
  "type_position": "entrée",
  "alias": null,
  "nom_ld": null,
  "libelle_acheminement": "ABERGEMENT-DE-VAREY (L )",
  "nom_afnor": "PLACE DU PESE LAIT",
  "source_position": "commune",
  "source_nom_voie": "commune",
  "certification_commune": true,
  "cad_parcelles": "01002000AE0005"
}
```

Every field is documented below.

## Essential Elements

* `address` string

  Address

  The house number of the address (`numero`), without any suffix.

  Can be empty string `""` if not present.

  Example: `6`

* `line_1` string

  Address Line One

  First address line (house number, suffix, and street name).

  Can be `null` if not present.

  Example: `6 place du Pese Lait`

* `line_2` string

  Address Line Two

  Second address line (postcode and municipality name).

  Can be `null` if not present.

  Example: `01640 L'Abergement-de-Varey`

## Geographic and Location Information

* `country` string

  Country

  Full country names (ISO 3166)

  Example: `France`

  Enum: "France"

* `country_iso` string

  Country ISO

  3 letter country code (ISO 3166-1)

  Example: `FRA`

  Enum: "FRA"

* `country_iso_2` string

  Country ISO 2

  2 letter country code (ISO 3166-1)

  Example: `FR`

  Enum: "FR"

* `language` string

  Language

  Language represented by 2 letter ISO Code (639-1)

  Example: `fr`

  Enum: "fr"

* `longitude` string

  Longitude

  Example: `5.425179`

* `latitude` string

  Latitude

  Example: `46.005447`

* `lon` string

  Source Longitude (lon)

  Longitude (WGS84) as returned from source data

  Example: `5.425179`

* `lat` string

  Source Latitude (lat)

  Latitude (WGS84) as returned from source data

  Example: `46.005447`

* `x` string

  Easting (Lambert 93)

  Lambert 93 easting coordinate

  Example: `887643.67`

* `y` string

  Northing (Lambert 93)

  Lambert 93 northing coordinate

  Example: `6547960.53`

* `type_position` string

  Position Type

  Positional accuracy type (`entrée`, `bâtiment`, `parcelle`, `délivrance postale`, etc.)

  Example: `entrée`

* `source_position` string

  Position Source

  Source of position data (`commune`, `IGN`, etc.)

  Example: `commune`

## Address Components and Identifiers

* `id` string

  ID

  Example: `ban_01002_w4ld4h_00006`

* `dataset` string

  Dataset

  Example: `ban`

  Enum: "ban"

* `id_fantoir` string

  FANTOIR Street Identifier

  FANTOIR street identifier

* `numero` integer

  House Number

  House number

  Example: `6`

* `rep` string

  House Number Suffix

  House number suffix / répétition (`bis`, `ter`, `quater`, etc.)

* `nom_voie` string

  Street Name

  Street name

  Example: `Place du Pese Lait`

* `nom_afnor` string

  AFNOR Street Name

  AFNOR-normalised street name

  Example: `PLACE DU PESE LAIT`

* `source_nom_voie` string

  Street Name Source

  Source of street name data

  Example: `commune`

* `alias` string

  Alias

  Address alias

* `nom_ld` string

  Lieu-dit

  Lieu-dit (named place) label

## Municipality and Postal Information

* `code_postal` string

  Postal Code

  5-digit postal code

  Example: `01640`

* `code_insee` string

  INSEE Commune Code

  INSEE commune code (2-digit département + 3-digit commune)

  Example: `01002`

* `nom_commune` string

  Municipality Name

  Municipality name

  Example: `L'Abergement-de-Varey`

* `code_insee_ancienne_commune` string

  Former Commune INSEE Code

  INSEE code of the pre-fusion commune (for merged municipalities)

* `nom_ancienne_commune` string

  Former Commune Name

  Name of the pre-fusion commune (for merged municipalities)

* `libelle_acheminement` string

  Postal Routing Label

  Postal routing label

  Example: `ABERGEMENT-DE-VAREY (L )`

* `certification_commune` boolean

  Municipality Certification

  Whether the municipality has certified this address

  Example: `true`

* `cad_parcelles` string

  Cadastral Parcels

  Cadastral parcel reference(s)

  Example: `01002000AE0005`
