Dokument zmiany wersji

Istnieje przełomowa zmiana w EV Location API. Obecny punkt końcowy v1 zostanie wycofany 31 marca 2026. Klienci korzystający z wersji v1 powinni zaplanować migrację do wersji v2.

Podstawowe koncepcje API pozostają niezmienione; jednak wersja v2 wprowadza kilka zmian technicznych, takich jak zaktualizowane typy danych dla niektórych parametrów i usunięcie nieistotnych lub niezmiennie wiarygodnych pól.

Poniższe sekcje szczegółowo wyjaśniają zmiany.

Uwierzytelnianie

Punkt końcowy uwierzytelniania pozostaje niezmieniony, a istniejący punkt końcowy OAuth pozostaje w użyciu.

Wersja interfejsów API

Zaktualizowano tylko podstawowy adres URL dla wszystkich czterech punktów końcowych lokalizacji z v1 do v2. Same ścieżki punktów końcowych pozostają niezmienione.
1. Stary podstawowy adres URL - https://api.shell.com/ev/v1/locations
2. Nowy bazowy adres URL - https://api.shell.com/ev/v2/locations

Zmieniono szczegóły dotyczące 3 punktów końcowych: /locations, /id, /nearby

Zmiany typu danych w ładunku odpowiedzi
1. Odpowiedź zawiera teraz trzy pola UUID (Location UUID, EVSE UUID, Connector UUID). Wcześniej wartości te były dostarczane jako liczby całkowite. Teraz wszystkie zostały zaktualizowane do typów danych łańcuchowych, aby zapewnić prawidłowe formatowanie i spójność UUID.
2. Poniżej znajdują się dokładne nazwy parametrów w ładunku odpowiedzi.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
Następujące parametry zostały usunięte w wersji 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

Należy pamiętać, że komponent taryfy jest udostępniany w punkcie końcowym /locations/id . Informacje o taryfie mogą być pobierane tylko na lokalizację.

Zmiana szczegółów w punkcie końcowym /locations/markers

Trzy parametry zostały usunięte z ładunku odpowiedzi w wersji 2.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Szczegóły taryfy

Szczegóły taryfy będą dostępne tylko w punkcie końcowym locations/id, co oznacza, że szczegóły taryfy mogą być pobierane tylko na lokalizację, a nie zbiorczo. Zmiana ta wynika z funkcji dynamicznego ustalania cen, która została włączona w naszym produkcie.

Ponadto, aby pobrać informacje o taryfie, ProviderID jest obowiązkowy w parametrze zapytania. ProviderId będzie współdzielony przez Shell.

Poniżej znajduje się przykładowy komponent taryfowy.

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

Support

Jeśli potrzebujesz pomocy lub masz pytania, skontaktuj się z naszym zespołem technicznym, podnosząc bilet wsparcia:

Podnieś bilet

Wybierz język

EV Public Locations 2.1.2