Dokument o zmene verzie

V rozhraní EV Location API došlo k zmene, ktorá má vplyv na kompatibilitu. Súčasný koncový bod verzie v1 bude vyradený z prevádzky dňa 31. marca 2026. Zákazníkom používajúcim verziu v1 odporúčame naplánovať si prechod na verziu v2.

Základné koncepcie rozhrania API zostávajú nezmenené; verzia v2 však prináša niekoľko technických úprav, ako sú aktualizované datové typy pre určité parametre a odstránenie irelevantných alebo nie vždy spoľahlivých polí.

Nasledujúce časti podrobne vysvetľujú tieto zmeny.

Overovanie

Koncový bod pre overovanie sa nemení a existujúci koncový bod OAuth zostáva v prevádzke.

Verzovanie rozhraní API

Z verzie v1 na verziu v2 bola aktualizovaná iba základná URL adresa pre všetky štyri koncové body lokalít. Samotné cesty koncových bodov zostávajú nezmenené.
1. Stará základná URL adresa – https://api.shell.com/ev/v1/locations
2. Nová základná URL adresa - https://api.shell.com/ev/v2/locations

Zmeny podrobností v 3 koncových bodoch: /locations, /id, /nearby

Zmeny dátových typov v obsahu odpovede
1. Odpoveď teraz obsahuje tri polia UUID (UUID lokality, UUID EVSE, UUID konektora). Predtým boli tieto hodnoty poskytované ako celé čísla. Teraz boli všetky aktualizované na reťazcové dátové typy, aby sa zabezpečilo správne formátovanie a konzistentnosť UUID.
2. Nižšie sú uvedené presné názvy parametrov v obsahu odpovede.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
Nasledujúce parametre boli vo verzii v2 odstránené.
1. Data.accessibility.remark
2. data.operatorComment
3. Data.evse.connectors.deleted
4. Data.evse.connectors.fixedCable
5. Data.evse.connectors.tariff
6. Data.evse.connectors.updated
7. Data.evse.connectors.updatedBy
8. Data.evse.deleted
9. Data.evse.physicalReference

Upozorňujeme, že informácie o tarife sú k dispozícii v koncovom bode /locations/id . Informácie o tarife je možné získať len pre jednotlivé lokality.

Podrobnosti o zmenách v koncovom bode /locations/markers

Vo verzii v2 boli z obsahu odpovede odstránené tri parametre.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Podrobnosti o tarife

Podrobnosti o tarife budú k dispozícii iba v koncovom bode locations/id, čo znamená, že ich je možné získať iba pre jednotlivé lokality, a nie hromadne. Táto zmena súvisí s funkciou dynamického cenotvorenia, ktorá bola v našom produkte aktivovaná.

Okrem toho je na získanie informácií o tarifách v parametri dotazu ProviderID povinné. ID poskytovateľa bude zdieľané spoločnosťou Shell.

Nižšie je uvedená ukážka tarifnej zložky pre orientáciu.

"tariffs": [
    {
 "createdBy": "STAGE_TEST1",
 "currency": "",
      "elements": [
 {
 "priceComponents": [
 {
 "price": 1.7208002,
 "stepSize": 1,
              "type": "ENERGY",
 "vat": 21
 }
 ]
 },
 {
 "priceComponents": [
 {
              "price": 4.1202,
 "stepSize": 10,
 "type": "TIME",
 "vat": 8
 }
 ]
 },
        {
 "priceComponents": [
 {
 "price": 0,84033614,
 "stepSize": 1,
 "type": "FLAT",
              "vat": 19
 }
 ]
 }
 ],
 "endDateTime": "2026-09-02T15:03:09Z",
      "internalId": "CH*FR*SHE*9ddc09f2-1a66-47e9-b6f3-40b0d55tt923",
      "lastUpdated": "2025-09-10T08:43:09Z",
 "maxPrice": 999,
      "minPrice": 0,
 "operatorId": "FR*SHE",
 "powerRange": {
 "max": 150,
 "min": 0
 },
      "providerId": "Shell_RP_2",
 "startDateTime": "2026-01-21T08:43:09Z",
 "tariffAltText": null,
      "tariffId": "9ddc09f2-1a66-47e9-b6f3-40b0d55tt923",
 "tariffType": "DRIVER"
    } 
]

Podpora

Ak potrebujete pomoc alebo máte otázky, kontaktujte náš technický tím vytvorením žiadosti o podporu:

Vytvoriť žiadosť

Vyberte svoj jazyk

EV Public Locations 2.1.2