Skip to content

Règles de validation des champs

Théophile Merlière edited this page Apr 13, 2023 · 3 revisions

Règles de validation des champs

Cette documentation présente les règles de validation pour chaque champ du format BAL.

Voici la liste des champs pour lesquels nous avons fourni une documentation des règles de validation :

  • cle_interop
  • commune_insee
  • commune_nom
  • commune_deleguee_insee
  • commune_deleguee_nom
  • voie_nom
  • lieudit_complement_nom
  • numero
  • suffixe
  • position
  • x
  • y
  • long
  • lat
  • cad_parcelles
  • source
  • date_der_maj
  • certification_commune
  • uid_adresse

Clé d’interopérabilité

cle_interop (obligatoire)

La clé d'interopérabilité est une chaîne de caractères unique qui permet d'identifier une adresse de manière non ambiguë. Elle est composée de plusieurs segments, tels que le code commune, le code voie et le numéro d'adresse.

Nom du champ alternatifs tolérées : cle_intero, cle_interro

Règles de validation :

  • La valeur doit être correcte : On vérifie si la clé d'interopérabilité est structurée correctement (ex: code commune, code voie, numéro d'adresse).
  • La clé d’interopérabilité doit être en minuscules : On vérifie que la clé d'interopérabilité est en minuscules.
  • La clé d’interopérabilité doit contenir au moins 3 segments : On vérifie que la clé d'interopérabilité est composée d'au moins 3 segments séparés par des tirets (ex: commune-voie-numéro).
  • La commune référencée doit être valide : On vérifie si le code commune dans la clé d'interopérabilité correspond à une commune existante.
  • La commune référencée ne doit pas être une commune ancienne : On vérifie si le code commune dans la clé d'interopérabilité ne correspond pas à une commune ancienne.
  • La voie doit être valide : On vérifie si le code voie dans la clé d'interopérabilité correspond à une voie existante.
  • Le numéro doit être valide : On vérifie si le numéro d'adresse dans la clé d'interopérabilité est correct.
  • La partie numéro de la clé d’interopérabilité doit contenir 5 caractères : On vérifie si la partie numéro de la clé d'interopérabilité contient 5 caractères (ex: 00123).
  • La partie voie de la clé d’interopérabilité doit être renseignée : On vérifie si la partie voie de la clé d'interopérabilité est renseignée et non nulle (ex: 0000 ou xxxx).

Code INSEE de la commune

commune_insee (obligatoire) [Format 1.2]

Le champ "commune_insee" correspond au code INSEE de la commune dans laquelle se trouve l'adresse.

Nom alternative du champ toléré : 'commune_in'.

Règles de validation :

  1. La valeur doit être un code INSEE valide ayant existé : On vérifie si le champ commune_insee correspond à un code INSEE valide dans la base de données des communes.
  2. La valeur ne doit pas être un code INSEE d'une commune ancienne : On vérifie si le champ commune_insee ne correspond pas à un code INSEE d'une commune ancienne.

Nom de la commune

commune_nom (optionnel)

Le champ commune_nom est utilisé pour indiquer le nom de la commune associée à l'adresse. Il est utile pour faciliter la compréhension des adresses et éviter les erreurs de localisation.

Nom alternative du champ toléré : commune_no.

**Règles de validation : ** Aucune règle de validation spécifique n'est appliquée à ce champ.

Les alternatives régionales sont gérées


Nom de la commune déléguée

commune_deleguee_nom (optionnel) [Format 1.2]

Le champ commune_deleguee_nom est utilisé pour indiquer le nom de la commune déléguée associée à l'adresse, si applicable. Il est utile pour faciliter la compréhension des adresses et éviter les erreurs de localisation dans les cas où une commune a été fusionnée avec une autre et a le statut de commune déléguée.

Règles de validation : Aucune règle de validation spécifique n'est appliquée à ce champ.

Les alternatives régionales sont gérées


Code INSEE de la commune déléguée

commune_deleguee_insee (optionnel) [Format 1.2]

Le champ "commune_deleguee_insee" correspond au code INSEE de la commune déléguée associée à l'adresse, si applicable.

Règles de validation :

  • La valeur doit être un code INSEE valide ayant existé : On vérifie si le champ commune_deleguee_insee correspond à un code INSEE valide dans la base de données des communes.
  • La valeur ne doit pas correspondre à une commune actuelle dont le chef-lieu n'est pas une commune déléguée : On vérifie si le champ commune_deleguee_insee ne correspond pas à un code INSEE d'une commune actuelle dont le chef-lieu n'est pas une commune déléguée.
  • La valeur ne doit pas correspondre à une commune ancienne qui n'a pas le statut de commune déléguée : On vérifie si le champ commune_deleguee_insee ne correspond pas à un code INSEE d'une commune ancienne sans le statut de commune déléguée.

Nom de la voie

voie_nom (obligatoire)

Cet attribut contiendra la concaténation du type et du nom officiel de la voie en majuscules et minuscules accentuées.

Règles de validation :

  • La valeur doit contenir au moins 3 caractères : On vérifie si la longueur du champ voie_nom est supérieure ou égale à 3.
  • La valeur doit contenir au maximum 200 caractères : On vérifie si la longueur du champ voie_nom est inférieure ou égale à 200.
  • La valeur doit être en minuscules : On vérifie si le champ voie_nom est en minuscules.
  • La valeur ne doit pas contenir de tiret bas : On vérifie si le champ voie_nom ne contient pas de caractère tiret bas.

Les alternatives régionales sont gérées


Nom du lieu-dit historique ou complémentaire

lieudit_complement_nom (optionnel) [Format 1.2]

Le champ lieudit_complement_nom est utilisé pour fournir un complément d'information sur le lieu-dit associé à l'adresse. Il permet de préciser des informations supplémentaires pour faciliter la localisation de l'adresse.

Règles de validation : Aucune règle de validation spécifique n'est appliquée à ce champ.

Les alternatives régionales sont gérées


Numéro

numero (obligatoire)

Le champ "numero" est un nombre entier représentant le numéro de l'adresse. Il est utilisé pour identifier un emplacement précis au sein d'une voie.

Nom alternative du champ toléré : nulmero.

Règles de validation :

  • Ne doit pas être vide : On vérifie si le champ numéro est présent et non vide.
  • La valeur doit être correcte : On vérifie si le champ numéro est un nombre entier.
  • Le numéro ne doit pas être préfixé par des zéros : On vérifie si le champ numéro ne commence pas par des zéros (ex: 00123 est invalide).
  • Le numéro doit être compris entre 0 et 9999 (sauf toponyme) : On vérifie si le champ numéro est compris entre 0 et 9999, sauf si la valeur est un toponyme.

Suffixe

suffixe (optionnel)

Le champ "suffixe" est une chaîne de caractères utilisée pour compléter le champ "numero" et permet de distinguer plusieurs adresses ayant le même numéro. Par exemple, 12bis, 12ter, 12A, etc.

Règles de validation :

  • Le suffixe doit commencer par un chiffre ou une lettre
  • La longueur du suffixe doit être inférieure ou égale à 9 caractères

Position

position (optionnel)

Le champ position représente le type de positionnement de l'adresse.

Valeurs attendues :

  • délivrance postale
  • entrée
  • bâtiment
  • cage d’escalier
  • logement
  • parcelle
  • segment
  • service technique

X

x (optionnel)

Le champ "x" correspond à la coordonnée X en projection Lambert-93 de l'adresse.

Nom alternative du champ toléré : x_l93.

Règles de validation :

  • Le séparateur des décimales doit être le point : On vérifie que le champ x utilise un point comme séparateur décimal, et non une virgule ou un autre caractère.

Y

y (optionnel)

Le champ "y" correspond à la coordonnée Y en projection Lambert-93 de l'adresse.

Nom alternative du champ toléré : y_l93.

Règles de validation :

  • Le séparateur des décimales doit être le point : On vérifie que le champ y utilise un point comme séparateur décimal, et non une virgule ou un autre caractère.

Longitude

long (optionnel)

Le champ "long" correspond à la longitude en coordonnées géographiques WGS84 de l'adresse.

Nom alternative du champ toléré : long_wgs84, lon.

Règles de validation :

  • Le séparateur des décimales doit être le point : On vérifie que le champ long utilise un point comme séparateur décimal, et non une virgule ou un autre caractère.

Latitude

lat (optionnel) Le champ "lat" correspond à la latitude en coordonnées géographiques WGS84 de l'adresse.

Nom alternative du champ toléré : lat_wgs84.

Règles de validation :

  • Le séparateur des décimales doit être le point : On vérifie que le champ lat utilise un point comme séparateur décimal, et non une virgule ou un autre caractère.

Parcelles cadastrales desservies

cad_parcelles (optionnel) [Format 1.2]

Liste des parcelles liées à une adresse.

Nom alternative du champ toléré : cad_parcel.

Règles de validation :

  • Pipe en début ou fin de chaîne : On vérifie que le symbole '|' n'est pas utilisé au début ou à la fin de la chaîne de caractères du champ cad_parcelles.

Source

source

Le champ source est utilisé pour indiquer l’organisme ayant créé cette adresse.

Règles de validation : Aucune règle de validation spécifique n'est appliquée à ce champ.


Date de dernière mise à jour

date_der_maj (optionnel)

C’est la date de dernière mise à jour connue de la donnée. Cela ne correspond pas à la date de publication du jeu de données sur internet. Le format est AAAA-MM-JJ.

Nom alternative du champ toléré : date_der_m, dmaj, date_maj.

Règles de validation :

  • Date invalide : On vérifie que la valeur du champ date_der_maj est une date valide.
  • Date trop ancienne : On vérifie que la date n'est pas trop ancienne (par exemple, avant une certaine année limite).
  • Date dans le futur : On vérifie que la date n'est pas dans le futur.

Certification communale

certification_commune (obligatoire) [Format 1.3]

Cet attribut indique si la commune (administration ou élus) à d’une manière ou d’une autre validé l’exactitude des informations de l’adresse décrite SAUF la liste des parcelles cadastrales desservies.

Nom alternative du champ toléré : pour détecter ce champ : certification_adresse.

Valeurs attendues :

  • 0 : adresse non certifiée par la commune
  • 1 : adresse certifiée par la commune

Identifiant unique d’adresse

uid_adresse (optionnel)

Le champ uid_adresse est un identifiant unique attribué à chaque adresse.

Règles de validation : Aucune règle de validation spécifique n'est appliquée à ce champ.