# 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. ## Essential Elements[​](#essential-elements "Direct link to Essential Elements") ### Address[​](#address "Direct link to Address") `address`string The house number of the address. Can be empty string `""` if not present. * Example `8` ### Address Line One[​](#address-line-one "Direct link to Address Line One") `line_1`string First address line (house number, suffix, and street name). Can be `null` if not present. * Example `8 bis avenue des Champs-Élysées` ### Address Line Two[​](#address-line-two "Direct link to Address Line Two") `line_2`string Second address line (postcode and municipality name). Can be `null` if not present. * Example `75008 Paris` *** ## Geographic and Location Information[​](#geographic-and-location-information "Direct link to Geographic and Location Information") ### Country[​](#country "Direct link to Country") `country`string Full country names (ISO 3166) * Values * "France" ### Country ISO[​](#country-iso "Direct link to Country ISO") `country_iso` 3 letter country code (ISO 3166-1) * Values * "FRA" ### Country ISO 2[​](#country-iso-2 "Direct link to Country ISO 2") `country_iso_2`string 2 letter country code (ISO 3166-1) * Values * "FR" ### Language[​](#language "Direct link to Language") `language` Language represented by 2 letter ISO Code (639-1) * Values * "fr" ### Longitude[​](#longitude "Direct link to Longitude") `longitude` ### Latitude[​](#latitude "Direct link to Latitude") `latitude` ### Source Longitude (lon)[​](#source-longitude-lon "Direct link to Source Longitude (lon)") `lon`string Longitude (WGS84) as returned from source data ### Source Latitude (lat)[​](#source-latitude-lat "Direct link to Source Latitude (lat)") `lat`string Latitude (WGS84) as returned from source data ### Easting (Lambert 93)[​](#easting-lambert-93 "Direct link to Easting (Lambert 93)") `x`string Lambert 93 easting coordinate ### Northing (Lambert 93)[​](#northing-lambert-93 "Direct link to Northing (Lambert 93)") `y`string Lambert 93 northing coordinate ### Position Type[​](#position-type "Direct link to Position Type") `type_position`string Positional accuracy type (`entrée`, `bâtiment`, `parcelle`, `délivrance postale`, etc.) ### Position Source[​](#position-source "Direct link to Position Source") `source_position`string Source of position data (`commune`, `IGN`, etc.) *** ## Address Components and Identifiers[​](#address-components-and-identifiers "Direct link to Address Components and Identifiers") ### ID[​](#id "Direct link to ID") `id` ### Dataset[​](#dataset "Direct link to Dataset") `dataset`string * Values * "ban" ### FANTOIR Street Identifier[​](#fantoir-street-identifier "Direct link to FANTOIR Street Identifier") `id_fantoir`string FANTOIR street identifier ### House Number[​](#house-number "Direct link to House Number") `numero`integer House number ### House Number Suffix[​](#house-number-suffix "Direct link to House Number Suffix") `rep`string House number suffix / répétition (`bis`, `ter`, `quater`, etc.) ### Street Name[​](#street-name "Direct link to Street Name") `nom_voie`string Street name ### AFNOR Street Name[​](#afnor-street-name "Direct link to AFNOR Street Name") `nom_afnor`string AFNOR-normalised street name ### Street Name Source[​](#street-name-source "Direct link to Street Name Source") `source_nom_voie`string Source of street name data ### Alias[​](#alias "Direct link to Alias") `alias`string Address alias ### Lieu-dit[​](#lieu-dit "Direct link to Lieu-dit") `nom_ld`string Lieu-dit (named place) label *** ## Municipality and Postal Information[​](#municipality-and-postal-information "Direct link to Municipality and Postal Information") ### Postal Code[​](#postal-code "Direct link to Postal Code") `code_postal`string 5-digit postal code ### INSEE Commune Code[​](#insee-commune-code "Direct link to INSEE Commune Code") `code_insee`string INSEE commune code (2-digit département + 3-digit commune) ### Municipality Name[​](#municipality-name "Direct link to Municipality Name") `nom_commune`string Municipality name ### Former Commune INSEE Code[​](#former-commune-insee-code "Direct link to Former Commune INSEE Code") `code_insee_ancienne_commune`string INSEE code of the pre-fusion commune (for merged municipalities) ### Former Commune Name[​](#former-commune-name "Direct link to Former Commune Name") `nom_ancienne_commune`string Name of the pre-fusion commune (for merged municipalities) ### Postal Routing Label[​](#postal-routing-label "Direct link to Postal Routing Label") `libelle_acheminement`string Postal routing label ### Municipality Certification[​](#municipality-certification "Direct link to Municipality Certification") `certification_commune`boolean Whether the municipality has certified this address ### Cadastral Parcels[​](#cadastral-parcels "Direct link to Cadastral Parcels") `cad_parcelles`string Cadastral parcel reference(s)