Verzióváltási dokumentum

Az EV Location API-ban kompatibilitást megszakító változás történik. A jelenlegi v1 végpont 2026. március 31-én kerül leszerelésre. A v1-et használó ügyfeleknek javasoljuk, hogy tervezzék meg az átállást a v2-re.

Az API alapvető koncepciói változatlanok maradnak; a v2 azonban számos technikai módosítást vezet be, például bizonyos paraméterek adat típusainak frissítését, valamint a nem releváns vagy nem következetesen megbízható mezők eltávolítását.

Az alábbi szakaszok részletesen ismertetik a változásokat.

Hitelesítés

A hitelesítési végpont változatlan marad, és a meglévő OAuth végpont továbbra is használatban marad.

Az API-k verziószámozása

Csak a négy helymeghatározási végpont alap-URL-je frissült a v1-ről a v2-re. Maguk a végpont-útvonalak változatlanok maradnak.
1. Régi alap-URL – https://api.shell.com/ev/v1/locations
2. Új alap-URL - https://api.shell.com/ev/v2/locations

3 végpont adatai módosultak: /locations, /id, /nearby

Adattípus-változások a válasz hasznos adataiban
1. A válasz most három UUID-mezőt tartalmaz (hely UUID, EVSE UUID, csatlakozó UUID). Korábban ezeket az értékeket egész számként adták meg. Most mindet karakterlánc adattípusra frissítették a megfelelő UUID formázás és konzisztencia biztosítása érdekében.
2. Az alábbiakban a válasz payloadjában szereplő pontos paraméternévek találhatók.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
A következő paramétereket eltávolítottuk a v2 verzióból.
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

Felhívjuk figyelmét, hogy a tarifakomponens a /locations/id végponton érhető el. A díjszabási információk csak helyszínenként érhetők el.

Részletek módosítása a /locations/markers végponton

A v2-es verzióban három paramétert eltávolítottak a válasz adataiból.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Tarifarészletek

A tarifarészletek kizárólag a locations/id végponton lesznek elérhetők, ami azt jelenti, hogy a tarifarészletek csak helyszínenként, és nem tömegesen lekérhetők. Ez a változás a termékünkben engedélyezett dinamikus árképzési funkciónak köszönhető.

Továbbá a díjszabási információk lekéréséhez a ProviderID kötelező a lekérdezési paraméterben. A ProviderID-t a Shell osztja meg.

Az alábbiakban egy példa a díjszabási komponensre, tájékoztatás céljából.

"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"
    } 
]

Támogatás

Ha segítségre van szüksége vagy kérdése van, kérjük, vegye fel a kapcsolatot technikai csapatunkkal egy támogatási jegy létrehozásával:

Jelentés benyújtása

Válassza ki a nyelvet

EV Public Locations 2.1.2