Dokument o změně verze

V rozhraní EV Location API dochází ke změně s dopadem na kompatibilitu. Současný koncový bod verze v1 bude vyřazen z provozu dne 31. března 2026. Zákazníkům používajícím verzi v1 doporučujeme naplánovat přechod na verzi v2.

Základní koncepce API zůstávají beze změny; verze v2 však přináší několik technických úprav, jako jsou aktualizované datové typy pro určité parametry a odstranění irelevantních nebo ne vždy spolehlivých polí.

Následující části podrobně vysvětlují tyto změny.

Ověřování

Ověřovací koncový bod se nemění a stávající koncový bod OAuth zůstává v provozu.

Verzování API

Z verze v1 na v2 byla aktualizována pouze základní URL pro všechny čtyři koncové body polohy. Samotné cesty ke koncovým bodům zůstávají beze změny.
1. Stará základní URL – https://api.shell.com/ev/v1/locations
2. Nová základní URL - https://api.shell.com/ev/v2/locations

Podrobnosti o změnách u 3 koncových bodů: /locations, /id, /nearby

Změny datových typů v datové části odpovědi
1. Odpověď nyní obsahuje tři pole UUID (UUID lokality, UUID EVSE, UUID konektoru). Dříve byly tyto hodnoty uváděny jako celá čísla. Nyní byly všechny aktualizovány na datové typy řetězců, aby bylo zajištěno správné formátování a konzistence UUID.
2. Níže jsou uvedeny přesné názvy parametrů v datové části odpovědi.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
Následující parametry byly ve verzi v2 odstraněny.
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

Vezměte prosím na vědomí, že komponenta tarifu je k dispozici v /locations/id koncovém bodě. Informace o tarifu lze načíst pouze pro jednotlivé lokality.

Podrobnosti o změnách na koncovém bodu /locations/markers

Ve verzi v2 byly z datové náplně odpovědi odstraněny tři parametry.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Podrobnosti o tarifu

Podrobnosti o tarifu budou k dispozici pouze v koncovém bodě locations/id, což znamená, že je lze načíst pouze pro jednotlivé lokality, nikoli hromadně. Tato změna je způsobena funkcí dynamického stanovení cen, která byla v našem produktu aktivována.

K získání informací o tarifech je navíc v parametru dotazu ProviderID povinné. ID poskytovatele bude sdíleno společností Shell.

Níže je uveden vzorový komponent tarifu pro informaci.

"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

Pokud potřebujete pomoc nebo máte dotazy, kontaktujte prosím náš technický tým vytvořením žádosti o podporu:

Vytvořit žádost

Vyberte jazyk

EV Public Locations 2.1.2