เอกสารการเปลี่ยนแปลงเวอร์ชัน

มีการเปลี่ยนแปลงที่สำคัญใน EV Location API จุดสิ้นสุด v1 ปัจจุบันจะถูกยกเลิกการใช้งานในวันที่ 31 มีนาคม 2026 ลูกค้าที่ใช้ v1 ควรวางแผนการย้ายไปยัง v2แนวคิดหลักของ API ยังคงไม่เปลี่ยนแปลง อย่างไรก็ตาม v2 ได้มีการปรับปรุงทางเทคนิคหลายประการ เช่น การอัปเดตประเภทข้อมูลสำหรับพารามิเตอร์บางตัว และการลบฟิลด์ที่ไม่เกี่ยวข้องหรือไม่มีความน่าเชื่อถืออย่างสม่ำเสมอออกไป

ส่วนต่อไปนี้อธิบายการเปลี่ยนแปลงโดยละเอียด

การตรวจสอบสิทธิ์

1. จุดสิ้นสุดการตรวจสอบสิทธิ์ยังคงไม่เปลี่ยนแปลง และจุดสิ้นสุด OAuth ที่มีอยู่ยังคงใช้งานได้

การกำหนดเวอร์ชันของ API

1. เฉพาะ URL ฐานสำหรับจุดสิ้นสุดทั้งสี่ตำแหน่งเท่านั้นที่ได้รับการอัปเดตจาก v1 เป็น v2

เส้นทางปลายทางยังคงไม่เปลี่ยนแปลง

1. URL ฐานเดิม - https://api.shell.com/ev/v1/locations
2. URL ฐานใหม่- https://api.shell.com/ev/v2/locations

เปลี่ยนรายละเอียดบน 3 จุดสิ้นสุด:/locations, /id, /nearby

1. การเปลี่ยนแปลงประเภทข้อมูลในข้อมูลตอบกลับ
   1. การตอบกลับตอนนี้รวมถึงฟิลด์ UUID สามฟิลด์ (UUID ของตำแหน่ง, UUID ของ EVSE, UUID ของตัวเชื่อมต่อ) ก่อนหน้านี้ ค่าเหล่านี้ถูกให้ในรูปแบบจำนวนเต็มขณะนี้ทั้งหมดได้รับการอัปเดตเป็นประเภทข้อมูลสตริงเพื่อให้แน่ใจว่าการจัดรูปแบบ UUID มีความถูกต้องและสอดคล้องกัน
   2. ด้านล่างนี้คือชื่อพารามิเตอร์ที่แน่นอนในข้อมูลการตอบสนอง
      1. Data.uid
      2. Data.evses.uid
      3. Data.evses.connectors.uuid
2. พารามิเตอร์ต่อไปนี้ถูกลบออกในเวอร์ชัน 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 endpoint. ข้อมูลอัตราภาษีสามารถดึงได้เฉพาะตามตำแหน่งเท่านั้น

รายละเอียดการเปลี่ยนแปลงที่จุดสิ้นสุด /locations/markers

1. พารามิเตอร์สามตัวถูกลบออกจากข้อมูลที่ส่งกลับใน v2.
   1. Data.geoHash
   2. Data.markerType
   3. Data.uniquekey

รายละเอียดอัตราภาษี

รายละเอียดอัตราภาษีจะมีให้เฉพาะในจุดสิ้นสุดของตำแหน่ง/ID เท่านั้น ซึ่งหมายความว่าสามารถดึงรายละเอียดอัตราภาษีได้เฉพาะตามตำแหน่งเท่านั้น ไม่สามารถดึงข้อมูลจำนวนมากได้การเปลี่ยนแปลงนี้เกิดจากฟีเจอร์การกำหนดราคาแบบไดนามิกที่ได้เปิดใช้งานในผลิตภัณฑ์ของเราแล้ว

นอกจากนี้ ในการดึงข้อมูลอัตราค่าบริการ จำเป็นต้องระบุ ProviderID ในพารามิเตอร์ของคำขอ โดย Shell จะเป็นผู้แชร์ ProviderId ให้

ด้านล่างนี้คือตัวอย่างส่วนประกอบอัตราค่าบริการเพื่อเป็นข้อมูลอ้างอิง

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

การสนับสนุน

1. หากคุณต้องการความช่วยเหลือหรือมีคำถาม โปรดติดต่อทีมเทคนิคของเราโดยส่งคำขอสนับสนุน:

   สร้างตั๋ว