Documento sulle modifiche alla versione

È prevista una modifica che comporta l'incompatibilità con le versioni precedenti nell'API EV Location. L'attuale endpoint v1 verrà dismesso il 31 marzo 2026. Si consiglia ai clienti che utilizzano la v1 di pianificare la migrazione alla v2.

I concetti fondamentali dell’API rimangono invariati; tuttavia, la v2 introduce diverse modifiche tecniche, quali l’aggiornamento dei tipi di dati per determinati parametri e la rimozione di campi non rilevanti o non costantemente affidabili.

Le sezioni seguenti illustrano le modifiche in dettaglio.

Autenticazione

L’endpoint di autenticazione rimane invariato e l’endpoint OAuth esistente continua a essere utilizzato.

Versioni delle API

Solo l’URL di base per tutti e quattro gli endpoint di localizzazione è stato aggiornato dalla v1 alla v2. I percorsi degli endpoint stessi rimangono invariati.
1. Vecchio URL di base - https://api.shell.com/ev/v1/locations
2. Nuovo URL di base - https://api.shell.com/ev/v2/locations

Modifiche relative a 3 endpoint: /locations, /id, /nearby

Modifiche al tipo di dati nel payload della risposta
1. La risposta ora include tre campi UUID (UUID della posizione, UUID dell'EVSE, UUID del connettore). In precedenza, questi valori erano forniti come numeri interi. Ora sono stati tutti aggiornati a tipi di dati stringa per garantire la corretta formattazione e coerenza degli UUID.
2. Di seguito sono riportati i nomi esatti dei parametri nel payload della risposta.
  1. Data.uid
  2. Data.evses.uid
  3. Data.evses.connectors.uuid
I seguenti parametri sono stati rimossi nella versione 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

Si noti che il componente relativo alla tariffa è disponibile nell’endpoint /locations/id . Le informazioni sulle tariffe possono essere recuperate solo per singola località.

Modifica dei dettagli sull’endpoint /locations/markers

Tre parametri sono stati rimossi dal payload della risposta nella v2.
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

Dettagli tariffari

I dettagli tariffari saranno disponibili solo nell’endpoint locations/id, il che significa che possono essere recuperati solo per singola località e non in blocco. Questa modifica è dovuta alla funzionalità di determinazione dinamica dei prezzi che è stata abilitata nel nostro prodotto.

Inoltre, per recuperare le informazioni sulle tariffe, il ProviderID è obbligatorio nel parametro di query. Il ProviderID verrà fornito da Shell.

Di seguito è riportato un componente di tariffa di esempio a titolo di riferimento.

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

Assistenza

Se hai bisogno di assistenza o hai domande, contatta il nostro team tecnico aprendo un ticket di assistenza:

Apri un ticket

Selezionare la lingua

EV Public Locations 2.1.2