LT
EN
Prisijungti
Duomenų teikimas

Duomenų teikimas

 

Instrukcija

  1. Įkelkite OCPI duomenų prieigos adresą, pavyzdys:  https://ev.vialietuva.lt/ocpi_module
  2. Paspauskite mygtuką „Atnaujinti autorizacijos duomenis“ ir palaukite kol užsikraus įkrovimo stotelių duomenys.

Toliau visas procesas vyks automatiškai. Išoriniai OCPI duomenys bus sulyginti su sistemoje esančiais duomenimis. Visi objektai kurie neegzistuoja sistemoje, bus sukurti ir 10 minučių bėgyje atsiras “Stotelės” modulyje. Taip pat pagrindiniame viešame sistemos puslapyje.

 

Pavyzdiniai JSON failai


 

Vietovės (Locations) – OCPI 2.3.0

OCPI 2.3.0 standarto nuoroda – Locations modulis

Tai pagrindinis endpoint’as, kuriame pateikiami įkrovimo stotelių baziniai duomenys ir jų būsenos. Duomenys yra sudaryti iš lokacijos (Location) objektų.

Lokacijos (Location) objektas

Lokacijos objektas aprašo fizinę įkrovimo vietą ir turi šiuos laukus:

  • id – unikalus lokacijos identifikatorius. Negali dubliuotis tarp lokacijų ir negali keistis per visą lokacijos gyvavimo laiką.

  • publish – parametras, nurodantis, ar lokacija yra publikuojama. Kol šio parametro reikšmė yra neigiama (false), lokacija nėra kuriama ir viešinama. Tai leidžia valdyti naujai statomus arba dar neaktyvius įrenginius, kurių kol kas nenorima rodyti viešai.

  • name – lokacijos arba įkrovimo stotelės pavadinimas.

  • address – formalus lokacijos adresas.

  • city – miestas, kuriam priskiriama lokacija. Visa sistema lokacijas grupuoja pagal šį parametrą.
    Jei parametras nenurodytas arba nurodytas nežinomas miestas, miesto mazgas bus priskirtas automatiškai pagal koordinates, pasirenkant artimiausią miestą.

  • coordinates – lokacijos koordinačių objektas, sudarytas iš latitude ir longitude laukų. Duomenų tipai ir tikslumo reikalavimai aprašyti OCPI standarto dokumentacijoje.

  • parking_type – bendras parkavimo tipo aprašymas. Reikšmė parenkama iš OCPI standarte nurodyto sąrašo.
    Papildomai palaikomi du nestandartiniai tipai:

    • IS_TENT – nurodo, kad lokacija yra Transeuropinio transporto tinklo (TEN-T) teritorijoje;

    • SECURE – nurodo, kad lokacija yra saugomoje arba uždaroje stovėjimo aikštelėje.

  • parking_places – parkavimo vietų objektų sąrašas. Šie objektai aprašo parkavimo vietas ir gali būti susiejami su konkrečiais prieigos taškais (EVSE).OCPI standartas

  • operator – operatoriaus duomenų objektas, pateikiamas pagal OCPI standartą.

  • owner – faktinio lokacijos savininko duomenų objektas.

  • facilities – papildomos paslaugos arba infrastruktūra, esanti šalia lokacijos (pvz., WC, kavinė ir pan.).

  • opening_times – objektas, aprašantis lokacijos prieinamumą ir darbo laiką. Aprašymas pateikiamas pagal OCPI standartą.

  • help_phone – telefono numeris, kuriuo naudotojas gali susisiekti susidūręs su techninėmis problemomis lokacijoje.

  • last_updated – data ir laikas, kada lokacijos duomenys buvo paskutinį kartą atnaujinti.

  • evses – EVSE objektų masyvas. Kiekvienas EVSE objektas atitinka vieną fizinį prieigos tašką įkrovimo stotelėje.
     

EVSE objektas

EVSE objektas aprašo konkretų prieigos tašką ir turi šiuos laukus:

  • uid – unikalus EVSE identifikatorius tiekėjo sistemoje. Negali dubliuotis tarp visų EVSE objektų ir negali keistis.

  • status – dabartinis EVSE būsenos statusas. Galimos reikšmės aprašytos OCPI standarte.

  • capabilities – EVSE palaikomų galimybių sąrašas. Pagal šį parametrą nustatoma, kokie autentifikavimo ir apmokėjimo būdai yra galimi.

  • evse_id – standartizuoto formato EVSE identifikatorius, skirtas naudotojui draugiškam ir tarptautiniu mastu atpažįstamam prieigos taško kodui.

  • last_updated – paskutinio EVSE būsenos arba duomenų atnaujinimo data ir laikas.

  • connectors – jungčių (connector) objektų masyvas. Kiekvienas objektas atitinka vieną fizinę jungtį, kurią gali naudoti EVSE.

 

Connector objektas

Connector objektas aprašo konkrečią fizinę jungtį ir turi šiuos laukus:

  • id – unikalus jungties identifikatorius EVSE kontekste.

  • voltage – jungties tiekiama įtampa (V).

  • amperage – jungties tiekiama srovė (A).

  • max_electric_power – maksimali elektrinė galia, kurią gali tiekti ši jungtis (W).

  • parking – parkavimo informacijos objektas, nurodantis parkavimo poziciją ir ParkingId.
    ParkingId yra nuoroda į konkretų parking_places sąrašo objektą, aprašytą tėviniame lokacijos objekte.

  • standard – jungties tipas. Galimos reikšmės pateiktos oficialioje OCPI standarto dokumentacijoje.

  • tariff_id – tarifo identifikatorius, nurodantis kainodarą šiai jungčiai. Tarifų informacija gaunama iš atskiro OCPI endpoint’o.

  • last_updated – paskutinio jungties duomenų atnaujinimo data ir laikas.

Tarifai (Tariffs) – OCPI 2.3.0

OCPI 2.3.0 standarto nuoroda – Tariffs modulis

TariffElement objektai

elements laukas Tariff objekte yra TariffElement objektų sąrašas. Kiekvienas TariffElement aprašo kainodaros taisyklę ir susideda iš:

1.price_components

PriceComponent objektų sąrašas. Kiekvienas PriceComponent turi:

  • type – kainos komponento tipas / matavimo vienetas (pvz., per laiką, per energiją ir pan.; reikšmės aprašytos OCPI dokumentacijoje).

  • price – kainos reikšmė (skaičius).

  • vat – PVM dydis (jei taikoma).

  • step_size – mažiausias nedalomas apskaitos žingsnis (pvz., jei step_size = 10, apskaita vykdoma 10 min intervalais).

Jeigu viename TariffElement pateikiami keli price_components, jie sumuojami (pvz., vienkartinis mokestis + mokestis už laiką kas 10 min + mokestis už kWh).

2. restrictions

Apribojimų objektas (neprivalomas). Jame pateikiami laukai, kurie nurodo, kada konkretus TariffElement galioja.

Apribojimai gali apimti, pvz.:

  • laiko intervalus / dienas / valandas;

  • ribas pagal galios ar srovės parametrus;

  • min/max energijos kiekį (kWh) ar sesijos ribas.

Jeigu restrictions sąlygos nėra tenkinamos, tarifų skaičiavimui naudojamas sekantis TariffElement iš elements sąrašo (tikrinant jo restrictions ir taikant jo price_components).

Parking objektas – OCPI 2.3.0

OCPI 2.3.0 standarto nuoroda

Parking objektas aprašo konkrečią parkavimo vietą, kuri gali būti susieta su EVSE arba Connector objektu per parking / ParkingId nuorodą.

Parking objekto laukai

  • id – unikalus parkavimo vietos identifikatorius lokacijos kontekste.

  • physical_reference – fizinis parkavimo vietos identifikatorius (pvz., vietos numeris, žymėjimas aikštelėje).

  • vehicle_types – leidžiamų transporto priemonių tipų sąrašas pagal OCPI klasifikaciją.

  • max_vehicle_weight – maksimalus leidžiamas transporto priemonės svoris (kg).

  • max_vehicle_height – maksimalus leidžiamas transporto priemonės aukštis (cm).

  • max_vehicle_length – maksimalus leidžiamas transporto priemonės ilgis (cm).

  • max_vehicle_width – maksimalus leidžiamas transporto priemonės plotis (cm).

  • parking_space_length – parkavimo vietos ilgis (cm).

  • parking_space_width – parkavimo vietos plotis (cm).

  • dangerous_goods_allowed – nurodo, ar leidžiama statyti transporto priemones, vežančias pavojingus krovinius.

  • direction – parkavimo pozicijos orientacija (pvz., ANGLE, PARALLEL, PERPENDICULAR).

  • drive_through – nurodo, ar parkavimo vieta yra pravažiuojama (drive-through).

  • restricted_to_type – nurodo, ar parkavimo vieta skirta tik tam tikro tipo transporto priemonėms.

  • reservation_required – nurodo, ar parkavimo vietai reikalinga išankstinė rezervacija.

  • time_limit – maksimalus leidžiamas parkavimo laikas (minutėmis).

  • roofed – nurodo, ar parkavimo vieta yra dengta.

  • lighting – nurodo, ar parkavimo vieta yra apšviesta.

  • refrigeration_outlet – nurodo, ar parkavimo vietoje yra elektros lizdas šaldymo įrangai.

  • standards – taikomi techniniai ar infrastruktūros standartai (pvz., nacionaliniai ar tarptautiniai reglamentai). Svarbu - šiame parametre ieškoma frazė 3-101/D1-26 norint nustatyti, ar ši stovėjimo vieta yra pritaikyta visoms visuomenės grupėms, kaip nurodyta reglamente numeriu 3-101/D1-26.

  • last_updated – (jei taikoma) paskutinio parkavimo vietos duomenų atnaujinimo data ir laikas.