Version Change Document

Er vindt een doorbraak plaats in de EV Location API. Het huidige v1 endpoint wordt op 31 maart 2026 buiten gebruik gesteld. Klanten die gebruikmaken van v1 wordt geadviseerd hun migratie naar v2 te plannen.

De kernconcepten van de API blijven ongewijzigd; v2 introduceert echter een aantal technische aanpassingen, zoals bijgewerkte gegevenstypen voor bepaalde parameters en de verwijdering van niet-relevante of niet consistent betrouwbare velden.

In de onderstaande secties worden de wijzigingen in detail uitgelegd.

Authenticatie

Het authenticatie-eindpunt is ongewijzigd en het bestaande OAuth-eindpunt blijft in gebruik.

Versie van de API's

Alleen de basis-URL voor alle vier de locatie-eindpunten is bijgewerkt van v1 naar v2. De eindpuntpaden zelf blijven ongewijzigd.
1. Old Base URL - https://api.shell.com/ev/v1/locations
2. Nieuwe basis-URL - https://api.shell.com/ev/v2/locations

Wijziging van details voor 3 eindpunten: /locations, /id, /nearby

Wijzigingen gegevenstype in payload van antwoord
1. Het antwoord bevat nu drie UUID-velden (Location UUID, EVSE UUID, Connector UUID). Voorheen werden deze waarden als gehele getallen geleverd. Ze zijn nu allemaal bijgewerkt naar string-datatypes om de juiste UUID-indeling en consistentie te waarborgen.
2. Hieronder staan de exacte parameternamen in de payload van de respons.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
De volgende parameters zijn verwijderd in versie 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

Let op: de tariefcomponent wordt beschikbaar gesteld in /locations/id endpoint.Tariefinformatie kan alleen per locatie worden opgehaald.

Wijzig details op /locations/markers eindpunt

Drie parameters zijn verwijderd uit de payload van het antwoord in v2.
1. Data.geoHash
2. Data.markerType
3. Data.uniqueekey

Tariefgegevens

De tariefgegevens zijn alleen beschikbaar in het eindpunt locaties/id, wat betekent dat tariefgegevens alleen per locatie kunnen worden opgehaald en niet in bulk. Deze wijziging is het gevolg van de functie voor dynamische prijzen die in ons product is ingeschakeld.

Ook is ProviderID verplicht in de queryparameter om de tariefgegevens op te halen. ProviderID wordt gedeeld door Shell.

Hieronder staat een voorbeeld van een tariefcomponent ter referentie.

"tarieven": [
    {
      "createdBy": "STAGE_TEST1",
      "valuta": "",
      "elementen": [
        {
          "priceComponents": [
            {
              "prijs": 1.7208002,
              "stepSize": 1,
              "type": "ENERGY",
              "btw": 21
            }
          ]
        },
        {
          "priceComponents": [
            {
              "price": 4.1202,
              "stepSize": 10,
              "type": "TIME",
              "vat": 8
            }
          ]
        },
        {
          "priceComponents": [
            {
              "prijs": 0.84033614,
              "stepSize": 1,
              "type": "FLAT",
              "btw": 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

Als u hulp nodig hebt of vragen hebt, neem dan contact op met ons technische team door een supportticket aan te maken:

Stel een ticket aan

Selecteer uw taal

EV Public Locations 2.1.2