Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

query BAN resources by their id. #38

Open
aparrot89 opened this issue Sep 28, 2024 · 10 comments
Open

query BAN resources by their id. #38

aparrot89 opened this issue Sep 28, 2024 · 10 comments

Comments

@aparrot89
Copy link

I'm currently working on the RnB "référentiel national du bâtiment"
To be able to access ban data via the RNB it would be great to be able to query BAN resources by their id.

@JulienThilliezLM2
Copy link

Hello,

Similar need for us, ideally we would be able to query by ID or UUID (This would allow synchronization). Note: The addok filters do not meet the need, as they are an 'additional' filter (they require a search string).

Thanks in advance!

@FrederiqWilliams
Copy link
Member

On y travaille!
mais comme nous sommes en train d'installer un nouvel ID, la route de consultation par ID n'est pas encore à niveau.

@aparrot89
Copy link
Author

@FrederiqWilliams
Merci pour le retour.
Bravo pour ce projet central.
Ça permet de faire plein d'autres choses : https://www.data.gouv.fr/fr/datasets/finess-alignement-vers-ban-et-rnb/

@FrederiqWilliams
Copy link
Member

FrederiqWilliams commented Oct 4, 2024

@aparrot89 Nous travaillons justement avec le RNB pour améliorer l'articulation des référentiels.
Votre cas d'usage nous intéresse, seriez-vous d'accord pour nous le présenter?

@aparrot89
Copy link
Author

aparrot89 commented Oct 5, 2024

Bonjour,
Par exemple, pour pouvoir récupérer facilement l'adresse de la BAN à partir d'un batiment du RNB.

@aparrot89
Copy link
Author

Bonjour,
Deux retours concernant les id

  • En explorant la base de données de la BAN (pas l'API) nous voyions que parfois des id en doublon (756 cas). Par exemple celui-ci 16068_0860_00007 où des coordonnées de géolocalisation changent légèrement.
    Alors que l'api ne retourne qu'une entité : https://api-adresse.data.gouv.fr/search/?q=7+Route+de+Mansle+CELLEFROUIN
    Est-ce une erreur ?
  • aussi le RNB utilise aussi un identifiant BAN qui semble être un uuid non signifiant. La clé BAN semblant être l'id sus cité
    image
    Est-ce possible d'avoir cette uuid (identifiant BAN) dans l'api et l'export des données ?

@FrederiqWilliams
Copy link
Member

Bonjour,

Les doublons sont en général des multi-positions d'une même adresse. En effet la BAN donne la possibilité d'associer à une même adresse plusieurs positions avec un type : entrée, bâtiment, délivrance postale par ex.
L'API ne prend que la première position du fichier.

Le nouvel id est effectivement non-signifiant justement pour s'affranchir de la dépendance avec le FANTOIR, qui provoquait des instabilités de la clé d'interoperabilité (la clé d'interop est de la forme 16068_0860_00007 ou 0860 est le code de voie fantoir. Si le code INSEE ou le code voie change, la clé évolue, ce qui ne permet pas de suivre le cycle de vie de l'adresse dans le temps).
Nous sommes en phase de déploiement du nouvel identifiant (=identifiant BAN) qui va à terme remplacer la clé d'interopérabilité.
Celui ci est un uuid v4.

Le RNB a logiquement associé d'abord la clé d'interop pour faire la jointure avec la BAN, puisque l'id BAN n'était pas encore en place. Le deuxième a été rajouté récemment pour faciliter la bascule.
Actuellement 65% des adresses de la BAN en dispose. Il est bien dans l'API.
Il est un peu plus caché dans les exports car nous ne pouvons pas modifier l'export csv qui est utilisé largement : les exports avec id sont ici : https://adresse.data.gouv.fr/data/ban/adresses/weekly/csv-with-ids
Nous travaillons également à un nouvel export pour embarquer ces évolutions.

@aparrot89
Copy link
Author

Bonjour,

Merci pour votre réponse.

Nous intégrerons les identifiants BAN dans nos prochains alignements : https://www.data.gouv.fr/fr/organizations/interhop/#/datasets

@aparrot89
Copy link
Author

Bonjour
Dans l'export de la BAN présent ici (https://adresse.data.gouv.fr/data/ban/adresses/latest/csv-with-ids) nous avons vu apparaitre les colonnes id_ban_adresse, id_ban_toponyme et id_ban_commune
Dans l'API seul le banId est renvoyé.
Est-ce en fonction du "type" : https://adresse.data.gouv.fr/api-doc/adresse
Screenshot 2024-10-24 at 11 15 04

  • quand nous avons un "housenumber" alors c'est le id_ban_adresse qui va être renvoyé dans le banId
  • quand nous avons un "street" alors c'est le id_ban_toponyme qui va être renvoyé dans le banId
  • quand nous avons un "municipality" alors c'est le id_ban_commune qui va être renvoyé dans le banId
    Est-ce bien cela ?
    Si oui quel type de banId est renvoyé quand nous avons un type "locality" ?

@FrederiqWilliams
Copy link
Member

Bonjour,
oui c'est exactement ça, le ban_id renvoyé correspond au ban-id du type d'objet considéré.
Les "locality" sont associés à des voies ils disposent donc d'un id_ban_toponyme
L'id_ban_commune n'est pas renvoyé (je crois..) il est à usage interne pour la gestion des évolutions de commune. L'identifiant significatif pour les "municipality" est le code INSEE (=citycode)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants