Document de changement de version

Il y a un changement radical dans l'API de localisation EV. Le point de terminaison v1 actuel sera mis hors service le 31 mars 2026. Il est conseillé aux clients qui utilisent la v1 de planifier leur migration vers la v2.

Les concepts fondamentaux de l'API restent inchangés ; toutefois, la v2 introduit plusieurs ajustements techniques, tels que la mise à jour des types de données pour certains paramètres et la suppression de champs non pertinents ou dont la fiabilité n'est pas constante.

Les sections ci-dessous expliquent les changements en détail.

Authentication

1. Le point de terminaison d'authentification est inchangé, et le point de terminaison OAuth existant reste en service.

Version des API

1. Seule l'URL de base des quatre points d'accès a été mise à jour de v1 à v2. Les chemins d'accès restent inchangés.
   1. Ancienne URL de base - https://api.shell.com/ev/v1/locations
   2. Nouvelle URL de base - https://api.shell.com/ev/v2/locations

Modification des détails de 3 points d'extrémité : /locations, /id, /nearby

1. Modifications du type de données dans la charge utile de la réponse
   1. La réponse comprend désormais trois champs UUID (Location UUID, EVSE UUID, Connector UUID). Auparavant, ces valeurs étaient fournies sous forme d'entiers. Elles ont été mises à jour pour devenir des chaînes de caractères afin d'assurer le formatage et la cohérence de l'UUID.
   2. Voici les noms exacts des paramètres dans la charge utile de la réponse.
      1. Data.uid
      2. Data.evses.uid
      3. Data.evses.connectors.uuid
2. Les paramètres suivants ont été supprimés dans la version 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

Veuillez noter que la composante tarifaire est mise à disposition dans /locations/id endpoint. Les informations tarifaires ne peuvent être récupérées que par emplacement.

Détails du changement sur le point de terminaison /locations/markers

1. Trois paramètres ont été supprimés de la charge utile de la réponse dans la v2.
   1. Data.geoHash
   2. Data.markerType
   3. Data.uniquekey

Détails tarifaires

Les détails tarifaires ne seront disponibles que dans le point final locations/id, ce qui signifie que les détails tarifaires ne peuvent être récupérés que par emplacement et non en masse. Ce changement est dû à la fonction de tarification dynamique qui a été activée dans notre produit.

En outre, pour obtenir les informations tarifaires, ProviderID est obligatoire dans le paramètre de requête. Le ProviderId sera partagé par Shell.

Voici un exemple de composant tarifaire pour référence.

"tarifs" : [
    {
      "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

1. Si vous avez besoin d'aide ou si vous avez des questions, veuillez contacter notre équipe technique en créant un ticket de support:

   Créer un ticket

.