版本變更文件

EV Location API 出現了破壞性變更。目前的 v1 端點將於 2026 年 3 月 31 日 停止服務。建議使用 v1 的客戶規劃遷移至 v2。

核心 API 概念維持不變；然而，v2 引入了若干技術調整，例如更新特定參數的資料類型，以及移除不相關或可靠性不一致的欄位。

以下各節將詳細說明這些變更。

驗證

驗證端點保持不變，現有的 OAuth 端點仍可繼續使用。

API 的版本控制

僅將所有四個位置端點的基礎 URL 從 v1 更新為 v2。端點路徑本身保持不變。
1. 舊版基礎網址 - https://api.shell.com/ev/v1/locations
2. 新版基礎網址 - 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.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

請注意，費率元件可透過 /locations/id 端點取得。費率資訊僅可按位置逐一擷取。

在 /locations/markers 端點上的變更詳情

v2 版本的回應載荷中已移除三個參數。
1. Data.geoHash
2. Data.markerType
3. Data.uniquekey

費率詳情

費率詳情僅會於 locations/id 端點提供，這意味著費率詳情只能按每個地點逐一擷取，無法批量擷取。此變更係因本產品已啟用動態定價功能所致。

此外，若要擷取費率資訊，查詢參數中必須包含 ProviderID。ProviderId 將由 Shell 提供。

以下為供參考的費率元件範例。

"tariffs": [
    {
 "createdBy": "STAGE_TEST1",
 "currency": "",
      "elements": [
 {
 "priceComponents": [
 {
 "price": 1.7208002,
 "stepSize": 1,
              "type": "ENERGY",
 "vat": 21
 }
 ]
 },
 {
 "priceComponents": [
 {
              "價格": 4.1202,
 "步長": 10,
 "類型": "TIME",
 "增值稅": 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
 },
      "供應商編號": "Shell_RP_2",
 "開始日期與時間": "2026-01-21T08:43:09Z",
 "費率替代文字": null,
      "tariffId": "9ddc09f2-1a66-47e9-b6f3-40b0d55tt923",
 "tariffType": "DRIVER"
    } 
]

支援服務

若您需要協助或有任何疑問，請透過提交支援單聯繫我們的技術團隊：

提交支援單

選擇語言

EV Public Locations 2.1.2