版本更改文档

EV Location API 中有一项重大更改。当前的 v1 端点将于2026 年 3 月 31 日退役。

API 的核心概念保持不变；但是，v2 引入了若干技术调整，例如更新了某些参数的数据类型，并删除了不相关或不一致可靠的字段。

以下部分详细解释了这些更改。

身份验证

身份验证端点保持不变，现有的 OAuth 端点仍在使用。

API 的版本

只有所有四个位置端点的基本 URL 从 v1 更新到了 v2。端点路径本身保持不变。
1. 旧的基本 URL - https://api.shell.com/ev/v1/locations
2. New Base URL - https://api.shell.com/ev/v2/locations

更改 3 个端点的详细信息：/locations、/id、/nearby

响应有效负载中的数据类型更改
1. 响应现在包括三个 UUID 字段（位置 UUID、EVSE UUID、连接器 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.physicalReference

请注意，关税组件在 /locations/id endpoint.Tariff 信息只能按地点获取。

更改 /locations/markers 端点的详细信息

在 v2 中，已从响应有效负载中删除了三个参数：
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

资费详情

资费详情将仅在地点/id 端点中提供，这意味着只能按地点获取资费详情，而不能批量获取。这一更改是由于我们的产品启用了动态定价功能。

此外，要获取关税信息，查询参数中必须包含ProviderID。ProviderId 将由 Shell 共享。

下面是一个关税组件示例，供参考。

"tariffs"：[
    {
      "createdBy"："STAGE_TEST1"、
      "货币"："",
      "元素"：[
        {
          "priceComponents"：[
            {
              "price"：1.7208002,
              "stepSize"：1,
              "类型"："ENERGY"、
              "增值税"： 2121
            }
          ]
        },
        {
          "priceComponents"：[
            {
              "price"：4.1202,
              "stepSize"：10,
              "类型"："TIME"、
              "vat"：8
            }
          ]
        },
        {
          "priceComponents"：[
            {
              "price"：0.84033614,
              "stepSize"：1,
              "类型"：平"、
              "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,
      "最小价格0,
      "operatorId"："FR*SHE"、
      "功率范围{
        "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

如果您需要帮助或有任何疑问，请通过提交支持票据联系我们的技术团队：

提交票据

选择语言

EV Public Locations 2.1.2