Документ за промяна на версията

В API-то за местоположения на електромобили е налице промяна, която ще доведе до несъвместимост. Настоящият ендпойнт v1 ще бъде изведен от употреба на 31 март 2026 г.. На клиентите, които използват v1, се препоръчва да планират миграцията си към v2.

Основните концепции на API-то остават непроменени; обаче v2 въвежда няколко технически корекции, като актуализирани типове данни за определени параметри и премахване на нерелевантни или не винаги надеждни полета.

В разделите по-долу промените са обяснени подробно.

Удостоверяване

Крайната точка за удостоверяване остава непроменена, а съществуващата крайна точка за OAuth продължава да се използва.

Версии на API-тата

Само базовият URL адрес за всичките четири крайни точки за местоположение е актуализиран от v1 към v2. Самите пътища към крайните точки остават непроменени.
1. Стара базова URL - https://api.shell.com/ev/v1/locations
2. Нова базова URL - https://api.shell.com/ev/v2/locations

Подробности за промените в 3 крайни точки: /locations, /id, /nearby

Промени в типа на данните в полезния товар на отговора
1. Отговорът вече включва три полета с UUID (UUID на местоположението, UUID на EVSE, UUID на конектора). Преди тези стойности се предоставяха като цели числа. Сега всички те са актуализирани към типове данни от тип „низ“, за да се гарантира правилното форматиране и последователност на UUID.
2. По-долу са посочени точните имена на параметрите в полезния товар на отговора.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
Следните параметри са премахнати във версия v2.
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

Моля, имайте предвид, че компонентът за тарифите е достъпен в крайната точка /locations/id . Информацията за тарифите може да бъде извлечена само по местоположение.

Подробности за промените в крайната точка /locations/markers

Три параметъра са премахнати от полезния товар на отговора във версия v2.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Подробности за тарифите

Подробностите за тарифите ще бъдат достъпни само в крайната точка locations/id, което означава, че те могат да бъдат извлечени само за отделно местоположение, а не в масивен формат. Тази промяна се дължи на функцията за динамично ценообразуване, която е активирана в нашия продукт.

Освен това, за да се извлече информацията за тарифите, ProviderID е задължителен параметър в заявката. ProviderID ще бъде предоставен от Shell.

По-долу е даден пример за компонент с тарифи за справка.

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

Поддръжка

Ако се нуждаете от помощ или имате въпроси, моля, свържете се с нашия технически екип, като създадете заявка за поддръжка:

Отворете заявка

Изберете вашия език

EV Public Locations 2.1.2