Au-delà de DATEX II : intégrer l'open data dans une seule API européenne

DATEX II sur les points d'accès nationaux est l'ossature de NAPSPAN — 25 NAPs en service aujourd'hui, chaque flux analysé et ramené à un schéma normalisé unique. Mais le NAP n'est pas toute la carte. Beaucoup de données de mobilité européennes utiles en exploitation ne voyagent jamais en DATEX II : elles vivent sur des portails open data municipaux, dans des jeux de données communautaires de recharge, dans des flux nationaux antérieurs à la tuyauterie de la directive STI. Si nous n'ingérions que du DATEX II, nous passerions à côté.

Alors nous ne le faisons pas. Lors de ce dernier sprint, nous avons intégré trois sources non-DATEX dans le même schéma GeoJSON events / features que parle le reste de l'API — et, ce faisant, nous avons franchi la frontière de l'UE pour la première fois, vers l'Ukraine et la Moldavie. Voici ce qui a atterri et comment cela s'imbrique.

Un seul schéma, plus de canaux

Le but de NAPSPAN n'a jamais été d'être « un proxy DATEX II ». C'est une vue unique et normalisée des données routières européennes — events pour les incidents bornés dans le temps, features pour les points d'intérêt comme les caméras, le stationnement et la recharge VE — quelle que soit la manière dont la source publie. DATEX II est l'entrée la plus courante, pas la seule. Chaque adaptateur, quoi qu'il lise, aboutit au même endroit : du GeoJSON RFC 7946, filtrable par pays, bbox, rayon et type.

C'est cette conception qui fait de l'ajout d'une source non-DATEX une journée ordinaire plutôt qu'une bifurcation dans l'architecture. Un flux JSON municipal de stationnement et un flux DATEX II d'un Land deviennent le même type de feature de l'autre côté.

La recharge VE, au-delà des limites du NAP

Nous avons déjà écrit sur l'article 20 de l'AFIR, qui oblige chaque exploitant de points de recharge à publier le statut en direct par connecteur en DATEX II via le NAP. C'est l'étalon-or — et là où un État membre le porte, NAPSPAN le diffuse. Mais la télémétrie AFIR n'est aussi complète que le déploiement du NAP de chaque pays, et plusieurs pays que nous voulions couvrir n'exposent pas encore de flux VE abouti.

Open Charge Map comble cette lacune. C'est le registre des points de recharge maintenu par la communauté et sous licence ouverte — coordonnées, standards de connecteurs et puissances — et il atteint des endroits que les NAPs n'atteignent pas encore. Nous l'avons récupéré pour six pays supplémentaires (Portugal, Roumanie, Bulgarie, Slovaquie, Malte, Moldavie) et pour l'Ukraine, où il a fait apparaître à lui seul environ 575 points de recharge.

La distinction honnête, exposée dans les données pour que vous puissiez les différencier : l'AFIR via le NAP vous donne le statut en direct ; Open Charge Map vous donne le registre — où sont les bornes, ce qu'elles sont, à quelle vitesse. Chaque borne porte un metadata.source_feed pour qu'une intégration de routage ou de roaming sache exactement quelle garantie elle obtient.

GET /api/v1/features?type=ev_charging&country=UA

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [30.5234, 50.4501] },
      "properties": {
        "type": "ev_charging",
        "name": "DTEK YASNO — Kyiv",
        "connectors": [ { "standard": "CCS", "power_kw": 150 } ],
        "metadata": { "source_feed": "openchargemap", "country": "UA" }
      }
    }
  ]
}

Le stationnement tchèque, depuis la ville qui le publie

La Tchéquie était déjà un NAP en service pour nous côté événements. Ce qu'elle ne portait pas, c'était le stationnement — nous sommes donc allés à la source que les villes utilisent réellement : Golemio, la plateforme open data derrière Prague et un nombre croissant de municipalités tchèques. Elle agrège l'inventaire de stationnement à l'échelle nationale et, pour les villes qui instrumentent leurs parkings, l'occupation en direct.

Ce « pour les villes qui instrumentent leurs parkings » compte, et nous ne le masquons pas. La plupart des milliers d'enregistrements de stationnement tchèques sont un inventaire statique — emplacement, capacité, type. Un sous-ensemble (Liberec et d'autres parkings gérés par korid aujourd'hui) rapporte le nombre de places libres en direct. Là où un comptage en direct existe, il figure sur le feature ; là où il n'existe pas, le feature le dit plutôt que de laisser entendre une fraîcheur qu'il n'a pas. Un répartiteur ne devrait jamais avoir à deviner si « pas de champ d'occupation » signifie complet ou inconnu.

Franchir la frontière de l'UE

L'Ukraine et la Moldavie sont les premiers pays couverts par NAPSPAN qui se situent en dehors du cadre UE 27 + Royaume-Uni + AELE autour duquel le reste de la plateforme a été bâti. Ni l'un ni l'autre n'exploite de point d'accès national au titre de la directive STI, il n'y a donc pas de DATEX II à normaliser — les données proviennent de sources ouvertes à la place.

Pour Kyiv, c'est le portail open data de la ville elle-même (CC BY 4.0) : stationnement hors voirie et sur voirie, plus les fermetures de routes publiées, que nous projetons dans le même type d'événement construction que devient un enregistrement DATEX II de travaux. Une fermeture à Kyiv et une zone de travaux en Bavière sont la même forme d'event au moment où elles vous parviennent — mêmes champs, mêmes filtres, même couche cartographique.

Rien de tout cela ne change le contrat. ?country=UA ou ?country=CZ se comporte exactement comme ?country=DE. Le schéma ne sait pas — et n'a pas besoin de savoir — qu'un flux était du DATEX II et un autre du JSON municipal. C'est là tout l'intérêt de normaliser en périphérie.

La licence, d'emblée

Chaque source que nous ajoutons passe le même filtre avant d'être livrée : classer la licence, consigner l'attribution et respecter toute limite de redistribution. Les trois sources présentées ici sont des canaux open data propres — Open Charge Map sous CC BY-SA 4.0, Kyiv sous CC BY 4.0, Golemio selon ses conditions open data — et chacune est créditée dans nos sources de données. Lorsque les conditions d'une source n'autorisent pas la redistribution, elle n'est pas diffusée, un point c'est tout. Une couverture ne vaut rien si ce n'est pas une couverture sur laquelle vous pouvez légalement bâtir.

Ce que cela représente au total

L'ossature du NAP continue de croître vers l'ensemble UE 27 + Royaume-Uni + AELE. À ses côtés, les canaux open data et communautaires nous permettent d'atteindre les données que les NAPs ne portent pas encore — stationnement municipal, couverture de recharge VE dans les interstices, et désormais deux pays au-delà de l'Union — sans greffer une seconde API pour les interroger. Un seul schéma, un seul jeu de filtres, et davantage du continent dedans.

Essayez

• Documentation API — events, features et les filtres ?country= / ?type=
• Carte en direct — visualisez les couches de recharge VE et de stationnement à travers les nouveaux pays
• Clé API gratuite — sans carte, essai de 14 jours