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

Document FR / EN pitfalls in data modeling #238

Open
jmaupetit opened this issue Nov 21, 2024 · 0 comments
Open

Document FR / EN pitfalls in data modeling #238

jmaupetit opened this issue Nov 21, 2024 · 0 comments
Assignees
Labels
API Item related to the API service documentation schema Discussions around data schemas

Comments

@jmaupetit
Copy link
Member

jmaupetit commented Nov 21, 2024

Purpose

There are many pitfalls in data modeling for our users mostly due to language issues between French and English terms as the static data documentation is in French.

Proposal

Adding the following corresponding table in our documentation could help:

EN (AFIR) Alias (EN) FR (AFIR) Alias (FR) Schema field
Connector Connecteur Prise prise_type_*
Recharging point Point de recharge id_pdc_itinerance
Recharging station EVSE Station de recharge Borne
Recharging pool Parc de recharge Station id_station_itinerance *

* There might be multiple recharging pools within the same location, leading to multiple id_station_itinerance for the same operator.

As the Recharging pool is a bit generic, we must consider the following constraint:

A pool (with a single id_station_itinerance) concerns EVSEs linked to a single delivery point (num_pdl field).

AFIR definitions:

  • recharging point means a fixed or mobile, on-grid or off-grid interface for the transfer of electricity to an electric vehicle which, although it may have one or more connectors to accommodate different connector types, is capable of recharging only one electric vehicle at a time, and which excludes devices with a power output less than or equal to 3,7 kW the primary purpose of which is not the recharging of electric vehicles;
  • recharging pool means one or more recharging stations at a specific location;
  • recharging station means a physical installation at a specific location, consisting of one or more recharging points;

Thanks for the suggestion @ssorin 🎩

@jmaupetit jmaupetit added documentation schema Discussions around data schemas API Item related to the API service labels Nov 21, 2024
@jmaupetit jmaupetit self-assigned this Nov 21, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
API Item related to the API service documentation schema Discussions around data schemas
Projects
None yet
Development

No branches or pull requests

1 participant