Dokument o spremembi različice

V API-ju EV Location je prišlo do spremembe, ki vpliva na združljivost. Trenutna končna točka različice v1 bo prenehala delovati 31. marca 2026. Strankam, ki uporabljajo različico v1, priporočamo, da načrtujejo prehod na različico v2.

Osnovni koncepti API-ja ostajajo nespremenjeni; vendar različica v2 uvaja nekaj tehničnih prilagoditev, kot so posodobljeni podatkovni tipi za določene parametre ter odstranitev nepomembnih ali nezanesljivih polj.

V spodnjih poglavjih so spremembe podrobno razložene.

Avtentifikacija

Končna točka za avtentifikacijo ostaja nespremenjena, obstoječa končna točka OAuth pa se še naprej uporablja.

Različice API-jev

Samo osnovni URL za vse štiri končne točke lokacij je bil posodobljen z različice v1 na v2. Same poti do končnih točk ostajajo nespremenjene.
1. Stari osnovni URL – https://api.shell.com/ev/v1/locations
2. Novi osnovni URL - https://api.shell.com/ev/v2/locations

Podrobnosti o spremembah na 3 končnih točkah: /locations, /id, /nearby

Spremembe tipa podatkov v vsebini odgovora
1. Odgovor zdaj vključuje tri polja UUID (UUID lokacije, UUID EVSE, UUID priključka). Prej so bile te vrednosti navedene kot cela števila. Zdaj so bile vse posodobljene na podatkovne tipe niza, da se zagotovi pravilno oblikovanje in doslednost UUID-jev.
2. Spodaj so navedena natančna imena parametrov v vsebini odgovora.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
V različici v2 so bili odstranjeni naslednji parametri.
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

Upoštevajte, da je komponenta tarife na voljo v končnem točki /locations/id . Podatke o tarifah je mogoče pridobiti le po posameznih lokacijah.

Podrobnosti o spremembah na končni točki /locations/markers

V različici v2 so bili iz vsebine odgovora odstranjeni trije parametri.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Podrobnosti o tarifah

Podrobnosti o tarifah bodo na voljo le v končnem točki locations/id, kar pomeni, da jih je mogoče pridobiti le po posameznih lokacijah in ne v večjem obsegu. Ta sprememba je posledica funkcije dinamičnega določanja cen, ki je bila omogočena v našem izdelku.

Poleg tega je za pridobivanje informacij o tarifah v parametru poizvedbe obvezno navesti ProviderID. Shell bo posredoval ProviderID.

Spodaj je prikazan vzorec komponente za tarife za referenco.

"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

Če potrebujete pomoč ali imate vprašanja, se obrnite na našo tehnično ekipo tako, da odprete zahtevek za podporo:

Odprite zahtevek

Izberite svoj jezik

EV Public Locations 2.1.2