# 電動車充電站(樁)資料標準欄位整理 * referance [電動車充電站(樁)資料標準V1.0](https://www.motc.gov.tw/ch/app/data/view?module=bussiness&id=2563&serno=97630c83-ef86-4554-8242-8d156a06476a) ![](https://hackmd.io/_uploads/HkLI-ZAW6.png) 圖1 表1 | 資料項目名稱 | 更新週期 | 資料檔案名稱 | | -------------------------- | --------------------------------------------- | ------------------ | | 充電站(樁)營運業者資料 XML | <font color="#f00">**需要定義**</font> (每天) | EVOperatorList.xml | 2 充電站基本資料 XML |<font color="#f00">**需要定義**</font> (每天)| EVStationList.xml| 3 充電站營業時間資料 XML |<font color="#f00">**需要定義**</font> (每天) |EVServiceTimeList.xml| 4 充電站停車費率資料 XML |<font color="#f00">**需要定義**</font> (每天)| EVParkingRateList.xml| 5 充電樁基本資料 XML |<font color="#f00">**需要定義**</font> (每天)| EVChargingPointList.xml| 6 充電槍基本資料 XML |<font color="#f00">**需要定義**</font> (每天) |EVConnectorList.xml| 7 充電槍充電費率資料 XML |<font color="#f00">**需要定義**</font> (每天)| EVChargingRateList.xml| 8 充電槍即時狀態資料 XML (動態資料) |<font color="#f00">**需要定義**</font> (1 分鐘)| EVConnectorLiveStatusList.xml | ## EVOperatorList : 充電站(樁)營運業者列表 ### 資料範例 ```xml <EVOperatorList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <Operators> <Operator> <OperatorID>29162550</OperatorID> <OperatorName> <Zh_tw>裕電能源股份有限公司</Zh_tw> <En> YES-Energy Service Co., LTD.</En> </OperatorName> <Telphone>02-27026627</Telphone> <Address>新北市新店區中興路 3 段 3 號 2 樓</Address> <WebURL>https://www.findcompany.com.tw/</WebURL> <LogoURL>https://www.findcompany.com.tw/logo.png</LogoURL> <TsAndCsURL>https://www.findcompany.com.tw/</TsAndCsURL> <BAN>29162550</BAN> </Operator> ………………………………………………. </Operators> </EVOperatorList> ``` ### 欄位說明 - 運營商列表 <EVOperatorList> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ---------------- | ---------- | ---------------------------------- | ---------------------------------------------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | 抓運營商最後一筆建立或更新時間 | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 寫死定義OR新增一張表存放更新週期與最後更新時間 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | Operators | 營運業者資訊 | Operator[] | | | - 運營商資訊<Operator> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ------------ | -------------------- | ----------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | OperatorID | 營運業者代碼 | string | <font color="#f00">**缺少**</font> | 目前 CPOInfo 有自己的PK(cpoId)，故只要在table中增加一個Ban欄位放統一編號，轉成XML時在同時放入 OperatorID 與 BAN 欄位即可 | | OperatorName | 營運業者名稱 | CultureInfo | | | | Telephone | 營運業者連絡電話 | string | | 可用 [CPOInfo].contactPhone 欄位 | | Address | 營運業者地址 | string | | 可用 [CPOInfo].address 欄位 | | WebURL | 營運業者官網網址 | string | <font color="#f00">**缺少**</font> | 需要新增 WebURL 圖檔路徑欄位，[圖檔範例-充電站業者官網網址](https://www.dodohome.com.tw/ ) | | LogoURL | 營運業者 Logo 網址 | string | <font color="#f00">**缺少**</font> | 需要新增 LogoURL 圖檔路徑欄位，[圖檔範例-充電站業者 Logo 網址](https://www.dodohome.com.tw/images/logo.png ) | | TsAndCsURL | 營運業者服務條款網址 | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | BAN | 公司統一編號 | string | <font color="#f00">**缺少**</font> | 同 OperatorID 補資料方式 | - 名稱語系<CultureInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | -------- | -------- | ---------------------------------- | --------------------------- | | Zh_tw | 中文名稱 | string | | 可用 [CPOInfo].cpoName 欄位 | | En | 英文名稱 | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | ## EVStationList : 充電站列表 ### 資料範例 ```xml <EVStationList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <Stations> <Station> <StationID>42861108-S0001</StationID> <StationName> <Zh_tw>板橋車站停車場充電站</Zh_tw> <En>…</En> </StationName> <Description>充電費率每小時 40 元。充電插頭 J-1772。充電格位 數 2</Description> <OperatorID>29162550</OperatorID> <OperationType>2</OperationType> <PositionLat>25.01255</PositionLat> <PositionLon>121.50125</PositionLon> <Geometry>…</Geometry> <Spaces>6</Spaces> <ChargingPoints>6</ChargingPoints> <Connectors> <Connector> <Type>1</Type> <Power>AC</Power> <Quantity>4</Quantity> </Connector> <Connector> <Type>2</Type> <Power>AC</Power> <Quantity>2</Quantity> </Connector> …………………………………….. </Connectors> <ServiceTime>7x24 小時或每日/00:00-24:00</ServiceTime> <ParkingRate>計時/每日/20 元每小時</ParkingRate> <ChargingRate>計時每小時 20 元<ChargingRate> <Floors>B1,B2</Floors> <UsageRestriction>本充電站限會員使用</UsageRestriction> <PhotoURLs> <PhotoURL>…</PhotoURL> … </PhotoURLs> <Location> <Freeway> <Road>國道 1 號</Road> <ServiceArea>清水休息區</ServiceArea> </Freeway> <CityRoad> <City>臺北市</City> <Town>中正區</Town> <Road>羅斯福路一段</Road> </CityRoad> <Place> <POI>101 大樓</POI> </Place> <Address> <City>臺北市</City> <Town>松山區</Town> <Road>民生東路五段</Road> <Lane>152 巷</Lane> <Alley>3 弄</Alley> <No>6 號</No> </Address> </Location> <Telephone>02-23955514</Telephone> <Reference> <CarPark> <CarParkID>056</CarParkID> <RateID>…</RateID> </CarPark> <CurbParkingSegment> <ParkingSegmentID>3020151</ParkingSegmentID> <RateID>…</RateID> </CurbParkingSegment> </Reference> </Station> ………………………………………………. </Stations> </EVStationList> ``` ### 欄位說明 - 充電站列表 <EVStationList> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ---------------- | --------- | ---------------------------------- | ---------------------------------------------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | 抓充電站最後一筆建立或更新時間 | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 寫死定義OR新增一張表存放更新週期與最後更新時間 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | Stations | 充電站資訊 | Station[] | | | - 充電站資訊 <Station> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ---------------- | ------------------------ | ------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | StationID | 充電站代碼 | string | <font color="#f00">**缺少**</font> | 目前 SiteInfo 有自己的PK(siteId & cpoId)，但該代碼需要為 **[充電站業者統一編號(8 碼數字)]+”-S”+[各營運系統的充電站代碼]範例 : 42861108-S0001** 故需要在 **table 中增加 Ban 與 SiteCode 欄位放統一編號與充電站代碼**，轉成XML時在將 Ban 與 SiteCode 字串組起來放入 StationID 即可 | | StationName | 充電站名稱 | CultureInfo | | | | Description | 充電站服務綜合描述 | string | | 可用 [SiteInfo].Note 欄位，但需要描述更詳細內容 | | OperatorID | 充電站營運業者代碼 | string | <font color="#f00">**缺少**</font> | 在 **table 中增加 Ban 欄位放統一編號 | | OperationType | 營運種類 | int | <font color="#f00">**缺少**</font> | 在 **table 中增加 SiteOperationType 欄位放該資訊， 1：公辦民營, 2：公辦公營, 3：私有民營 | | PositionLat | 代表點坐標位置緯度 | decimal | | 可用 [SiteInfo].Latitude 欄位 | | PositionLon | 代表點坐標位置經度 | decimal | | 可用 [SiteInfo].Longitude 欄位 | | Geometry | 充電站空間範圍圖資 | string | <font color="#f00">**缺少**</font> | **室外停車場才須提供。** 在 table 中增加 Polygon 欄位放該資訊，並需要 EVM UI 新增地圖Geofence編輯功能，標點後存入 [SiteInfo].Polygon 欄位內 | | Spaces | 充電車位數 | int | <font color="#f00">**缺少**</font> | 在 **table 中增加 SpaceCount 欄位放該資訊 | | ChargingPoints | 充電樁數 | int | | 用 SiteInfo 對應到的 ChargerInfo 資訊計算數量，但如果可以在 **table 中增加 ChargingPointCount 欄位放該資訊會更好 | | Connectors | 充電槍數資訊 | Co[] | | 用 SiteInfo 對應到的 [ChargerInfo].connectorsInfo 欄位顯示資訊 | | ServiceTime | 服務時間(描述) | string | <font color="#f00">**缺少**</font> | 在 **table 中增加 ServiceTime 欄位存放文字描述資料**，並且 **增加 [SiteServiceTimeInfo] table** | | ParkingRate | 充電車位停車費率 (描述) | string | <font color="#f00">**缺少**</font> | 在 **table 中增加 ParkingRate 欄位存放文字描述資料**，並且 **增加 [SiteParkingRateInfo] table** | | ChargingRate | 充電費率(描述) | string | | 可以用 [TOU].tou 內的資訊將資料組起來，或是在 **table 中增加 ChargingRate 欄位存放文字描述資料** | | Floors | 充電樁所在樓層 | string | <font color="#f00">**缺少**</font> | 在 **table 中增加 Floor 欄位存放** | | UsageRestriction | 充電站使用限制(文字描述) | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | PhotoURLs | 充電站照片網址資訊 | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | Location | 充電站空間位置資訊 | LocationInfo | | | | Telephone | 充電站連絡電話 | string | | 可用 [SiteInfo].ContactPhone 欄位 | | Reference | 關聯參照資訊 | ReferenceInfo | <font color="#f00">**缺少**</font> | <font color="#f00">**若充電站設於某已知之路外停車場或路邊停車路段時需要填**</font> | - 名稱語系<CultureInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | -------- | -------- | ---------------------------------- | ----------------------------- | | Zh_tw | 中文名稱 | string | | 可用 [SiteInfo].SiteName 欄位 | | En | 英文名稱 | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | - 充電槍資訊<Co> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | ---------------- | -------- | -------- | --------------------------------------------------------------------------------- | | Type | 充電槍規格 | int | | 可用 [ChargerInfo].connectorsInfo.connectors.connectorType 欄位(要轉換成對應數字); 1：CCS1, 2：CCS2, 3：CHAdeMO, 4：Tesla TPC, 5：J1772(Type1), 6：Mennekes(Type2), 254：Others, 255：Unknown | | Power | 充電電力輸出方式 | string | | [ChargerInfo].connectorsInfo.connectors.currentType; AC, DC | | Quantity | 充電槍數量 | int | | 用 Type 與 Power GroupBy 計算數量 | - 充電站位置<LocationInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | -------- | ------------ | -------------------------------------- | --------------------------------------------- | | Freeway | 高速公路 | FreewayInfo | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | CityRoad | 市區道路 | CityRoadInfo | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | Place | 地點 | PlaceInfo | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | Address | 地址 | AddressInfo | <font color="#f00">**部分缺少**</font> | 如果有地址建議都要填，可用 [SiteInfo].address | - 高速公路資訊<FreewayInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ----------- | ---------- | -------- | -------- | ---------------- | | Road | 國道名稱 | string | | | | ServiceArea | 服務區名稱 | string | | | - 市區道路資訊<CityRoadInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | -------- | -------- | -------- | ---------------- | | City | 縣市名 | string | | | | Town | 行政區名 | string | | | | Road | 路名 | string | | | - 地點資訊<PlaceInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | -------- | -------- | -------- | ---------------- | | POI | 國道名稱 | string | | | - 地址資訊<AddressInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | ---------- | -------- | -------- | --------------------------------------------------------------- | | City | 縣市名 | string | | <font color="#f00">**需要將[SiteInfo].address 個別拆開**</font> | | Town | 服務區名稱 | string | | <font color="#f00">**需要將[SiteInfo].address 個別拆開**</font> | | Road | 路名 | string | | <font color="#f00">**需要將[SiteInfo].address 個別拆開**</font> | | Lane | 巷名 | string | | <font color="#f00">**需要將[SiteInfo].address 個別拆開**</font> | | Alley | 弄名 | string | | <font color="#f00">**需要將[SiteInfo].address 個別拆開**</font> | | No | 號 | string | | <font color="#f00">**需要將[SiteInfo].address 個別拆開**</font> | - 參考資訊<ReferenceInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ------------------ | ---------------------------------------------- | ---------------------- | ---------------------------------- | -------------------- | | CarPark | 路外停車場(當充電站設置於某個路外停車場內時) | CarParkInfo | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | CurbParkingSegment | 路邊停車路段(當充電站設置於某個路邊停車路段時) | CurbParkingSegmentInfo | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | - 路外停車場資訊<CarParkInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | --------- | ------------ | -------- | -------- | ---------------- | | CarParkID | 停車場代碼 | string | | | | RateID | 停車費率代碼 | string | | | - 路邊停車路段資訊<CurbParkingSegmentInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ---------------- | ---------------- | -------- | -------- | ---------------- | | ParkingSegmentID | 路邊停車路段代碼 | string | | | | RateID | 路邊停車費率代碼 | string | | | ## EVServiceTimeList : 充電站營業時間(<font color="#f00">**缺少**</font>) ### 資料範例 ```xml <EVServiceTimeList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <ServiceTimes> <ServiceTime> <StationID>42861108-S0001</StationID> <OpeningHours> <OpeningHour> <ServiceType>1</ServiceType> <DayType>1</DayType> <StartTime>00:00</StartTime> <EndTime>23:59</EndTime> <LastEntranceTime>…</LastEntranceTime> </OpeningHour> ……… </OpeningHours> </ServiceTime> ………………………………………………. </ServiceTimes> </EVServiceTimeList> ``` ### 欄位說明 - 充電站營業時間列表 <EVParkingRateList> <font color="#f00">需要一張新的table SiteServiceTimeInfo </font> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ------------------ | ------------- | ---------------------------------- | ---------------------------------------------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | 抓停車費率最後一筆建立或更新時間 | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 寫死定義OR新增一張表存放更新週期與最後更新時間 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | ServiceTimes | 充電站營業時間資訊 | ServiceTime[] | | | - 充電站營業時間資訊 <ServiceTime> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ------------ | ------------ | ------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------ | | StationID | 充電站代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **siteId** Join SiteInfo，並拿[SiteInfo].Ban 與 [SiteInfo].SiteCode 組起來放入 StationID 即可 | | OpeningHours | 營業時間資訊 | OpeningHour[] | <font color="#f00">**缺少**</font> | | - 營業時間資訊 <OpeningHour> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ---------------- | ------------ | -------- | -------- | ------------------------------------------------------------------------------------------ | | ServiceType | 營業時間類型 | int | | 1：7*24 小時營業不間斷；2：每日特定時段才營業；3：分平假日有不同的營業時段 | | DayType | 服務日類型 | int | | 1：每日 Daily；2：平日 Weekdays；3：假日 Weekends；4：假日含國定例假日Weekends&Holidays | | StartTime | 開始營業時間 | datetime | | 時間格式採(HH:mm) | | EndTime | 結束營業時間 | datetime | | 時間格式採(HH:mm)，如果是整天 24 小時營運的情況則 StartTime 填寫 00:00，EndTime 填寫 24:00 | | LastEntranceTime | 最晚入場時間 | datetime | | 時間格式採(HH:mm)，非必要欄位可先不用補 | - 營業時間範例 | | 營業時間樣態 1<font color="#00f">**(7*24 小時營業)**</font> | 營業時間樣態 2 <font color="#00f">**(特定時段營業)**</font> | 營業時間樣態 3 <font color="#00f">**(平假日營業時段不同)**</font> | | | -------------- | ----------------------------------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------------- | ----- | | 營業時間(描述) | 每日/00:00-24:00 | 每日/07:00-22:00 | 平日/09:00-20:00 | 假日/09:00-22:00 | | ServiceType | 1 | 2 | 3 | 3 | | DayType | 1 | 1 | 2 | 3 | | StartTime | 00:00 | 07:00 | 09:00 | 09:00 | | EndTime | 24:00 | 22:00 | 20:00 | 22:00 | ## EVParkingRateList : 充電站停車費率(<font color="#f00">**缺少**</font>) ### 資料範例 ```xml <EVParkingRateList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <ParkingRates> <ParkingRate> <StationID>42861108-S0001</StationID> <Rates> <Rate> <RateType>2</RateType> <PricingType>1</PricingType> <DayType>1</DayType> <Price>20</Price> <MaxPrice>200</MaxPrice> </Rate> …………. </Rates> </ParkingRate> ………………………………………………. </ParkingRates> </EVParkingRateList> ``` ### 欄位說明 - 充電站停車費率列表 <EVParkingRateList> <font color="#f00">需要一張新的table SiteParkingRateInfo </font> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ------------------ | ------------- | ---------------------------------- | ---------------------------------------------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | 抓停車費率最後一筆建立或更新時間 | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 寫死定義OR新增一張表存放更新週期與最後更新時間 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | ParkingRates | 充電站停車費率資訊 | ParkingRate[] | | | - 充電站停車費率資訊 <ParkingRate> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | --------- | ------------ | -------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | StationID | 充電站代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **siteId** Join SiteInfo，並拿[SiteInfo].Ban 與 [SiteInfo].SiteCode 組起來放入 StationID 即可 | | Rates | 停車費率資訊 | Rate[] | <font color="#f00">**缺少**</font> | | - 停車費率資訊 <Rate> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ----------- | ---------------- | -------- | -------- | --------------------------------------------------------------------------------------- | | RateType | 費率類型 | int | | 1：免費 Free, 2：計次 By Count, 3：計時 By Hour | | PricingType | 定價類型 | int | | 1：固定費率FixedRate/FlateRate, 2：尖離峰差別定價 Peak-Load Pricing, 3：平假日差別定價 | | DayType | 服務日類型 | int | | 1：每日 Daily；2：平日 Weekdays；3：假日 Weekends；4：假日含國定例假日Weekends&Holidays | | RatePrice | 費率價格 | decimal | | <font color="#f00">**沒定義小數第幾位**</font> | | MaxPrice | 每日最高計費上限 | int | | 若無每日最高費用限制，則MaxPrice 值設定為-1 | - 停車費率範例 | | 停車費率樣態 1<font color="#00f">**(免費)**</font> | 停車費率樣態 2 <font color="#00f">**(計次&固定費率)**</font> | 營業時間樣態 5 <font color="#00f">**(計時&固定費率&每日有上限)**</font> | | -------------- | -------------------------------------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------- | | 營業時間(描述) | 免費 | 計次/每日/40 元每次 | 計時/每日/20 元每小時/每日最高/150 元每日 | | RateType | 1 | 2 | 3 | | PricingType | 1 | 1 | 1 | | DayType | 1 | 1 | 1 | | Price | 0 | 40 | 20 | | MaxPrice | 0 | 40 | 150 | ## EVChargingPointList : 充電樁列表 ### 資料範例 ```xml <EVChargingPointList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <ChargingPoints> <ChargingPoint> <StationID>42861108-S0001</StationID> <ChargingPointID>42861108-P0001<ChargingPointID> <OperatorID>29162550</OperatorID> <Connectors> <Connector> <Type>1</Type> <Quantity>2</Quantity> </Connector> <Connector> <Type>2</Type> <Quantity>3</Quantity> </Connector> ………… </Connectors> <ChargingRate>計時/30 元每小時</ChargingRate> <Payment> <CreditCard>1</CreditCard> <SmartCard>1</SmartCard> <EPay>1</EPay> <Others>0</Others> </Payment> <StartType> <ByCard>1</ByCard> <ByApp>0</ByApp> <ByStaff>0</ByStaff> <Others>1</Others> </StartType> <OperationURL>…</OperationURL> <Floor>1</Floor> <UsageRestriction>本充電樁限特斯拉車款使用</UsageRestriction> </ChargingPoint> ………………………………………………. </ChargingPoints> </EVChargingPointList> ``` ### 欄位說明 - 充電樁列表 <EVChargingPointList> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ------------------ | ------------- | ---------------------------------- | ---------------------------------------------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | 抓充電樁最後一筆建立或更新時間 | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 寫死定義OR新增一張表存放更新週期與最後更新時間 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | ChargingPoints | 充電樁資訊 | ChargingPoint[] | | | - 充電樁資訊 <ChargingPoint> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | | ---------------- | ------------------------ | ------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --- | | StationID | 充電站代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **siteId** Join SiteInfo，並拿[SiteInfo].Ban 與 [SiteInfo].SiteCode 組起來放入 StationID 即可 | | | ChargingPointID | 充電樁代碼 | string | <font color="#f00">**缺少**</font> | 目前 ChargerInfo 有自己的PK(id,identity & siteId)，但該代碼需要為 **[充電樁業者統一編號(8 碼數字)]+”-P”+[各營運系統的充電樁代碼]範例 : 42861108-P0001** 故需要在 **table 中增加 ChargerPointCode 欄位放統一編號與充電樁代碼**，轉成XML時在將 [SiteInfo].Ban 與 [ChargerInfo].ChargerPointCode 字串組起來放入 ChargingPointID 即可 | | | OperatorID | 充電站營運業者代碼 | string | <font color="#f00">**缺少**</font> | [SiteInfo].Ban | | | Connectors | 充電槍規格資訊 | Connector[] | | 用 SiteInfo 對應到的 [ChargerInfo].connectorsInfo 欄位顯示資訊 | | | ChargingRate | 充電費率(描述) | string | | 可以用 [TOU].tou 內的資訊將資料組起來，或是在 **table 中增加 ChargingRate 欄位存放文字描述資料** | | | Payment | 付款方式 | PaymentInfo | | 可用 [PaymentInstrument] 這張表 | | | StartType | 啟動充電操作方式 | StartTypeInfo | | 雖然沒有此資訊，但因為已經有對應啟動方式，故可以寫死，或開一張表存 | | | OperationURL | 操作方式說明網址 | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | | Floors | 充電樁所在樓層 | string | <font color="#f00">**缺少**</font> | 在 **table 中增加 Floor 欄位存放** | | | UsageRestriction | 充電站使用限制(文字描述) | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | - 充電槍規格資訊<Connector> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | ---------- | -------- | -------- | --------------------------------------------------------------------------------- | | Type | 充電槍規格 | int | | 可用 [ChargerInfo].connectorsInfo.connectors.connectorType 欄位(要轉換成對應數字); 1：CCS1, 2：CCS2, 3：CHAdeMO, 4：Tesla TPC, 5：J1772(Type1), 6：Mennekes(Type2), 254：Others, 255：Unknown | | Quantity | 充電槍數量 | int | | 用 Type 與 Power GroupBy 計算數量 | - 付款方式資訊<PaymentInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ---------- | ------------ | -------- | -------- | ------------------ | | CreditCard | 信用卡 | bool | | 0：否; 1：是(預設) | | SmartCard | 電子票證 | bool | | 0：否(預設); 1：是 | | EPay | 電子支付 | bool | | 0：否(預設); 1：是 | | Others | 其他付款方法 | bool | | 0：否(預設); 1：是 | - 啟動充電操作方式<StartTypeInfo> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | -------- | ------------ | -------- | -------- | ------------------ | | ByCard | 刷卡啟動 | bool | | 0：否(預設); 1：是 | | ByApp | APP 啟動 | bool | | 0：否(預設); 1：是 | | ByStaff | 管理員啟動 | bool | | 0：否(預設); 1：是 | | Others | 其他啟動方式 | bool | | 0：否(預設); 1：是 | ## EVConnectorList : 充電槍列表 <font color="#f00">是否需要一張新的table ChargerConnectorInfo </font> ### 資料範例 ```xml <EVConnectorList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <Connectors>` <Connector> <StationID>42861108-S0001</StationID> <ChargingPointID>42861108-P0001<ChargingPointID> <ConnectorID>42861108-C0002</ConnectorID> <Type>5</Type> <Power>1</Power> <Voltage>110V</Voltage> <CurrentRating>32A</CurrentRating> <PowerRating>7kw</PowerRating> <Floor>1</Floor> <UsageRestriction>本充電槍限特斯拉車款使用</UsageRestriction> </Connector> ………………………………………………. </Connectors> </EVConnectorList> ``` ### 欄位說明 - 充電槍列表 <EVConnectorList> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ------------------ | ------------- | ---------------------------------- | ---------------------------------------------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | 抓充電槍最後一筆建立或更新時間 | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 寫死定義OR新增一張表存放更新週期與最後更新時間 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | Connectors | 充電槍資訊 | Connector[] | | | - 充電槍資訊 <Connector> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | | ---------------- | ------------------------ | -------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | | StationID | 充電站代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **siteId** Join SiteInfo，並拿[SiteInfo].Ban 與 [SiteInfo].SiteCode 組起來放入 StationID 即可 | | | ChargingPointID | 充電樁代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **identity**，Join ChargerInfo，並拿[SiteInfo].Ban 與 [ChargerInfo].ChargerPointCode 組起來放入 ChargingPointID 即可 | | | ConnectorID | 充電槍代碼 | string | <font color="#f00">**缺少**</font> | 該代碼需要為 **統一編號(8 碼數字)]+”-C”+[各營運系統的充電槍代碼] 範例 : 42861108-C0001** ，故可能需要增加 **table ChargerConnectorInfo 並增加 ChargerConnectorCode 欄位放充電槍代碼** ，最後拿 [SiteInfo].Ban 與 [ChargerConnectorInfo].ChargerConnectorCode 組合來放入 ConnectorID 即可 | | | Type | 充電槍規格 | int | | 可用 [ChargerInfo].connectorsInfo.connectors.connectorType 欄位(要轉換成對應數字), Type1：CCS1, 2：CCS2, 3：CHAdeMO, 4：Tesla TPC, 5：J1772(Type1), 6：Mennekes(Type2), 254：Others, 255：Unknown | | | Power | 充電電力輸出方式 | int | | 可用 [ChargerInfo].connectorsInfo.connectors.currentType 欄位(要轉換成對應數字), 1:AC(交流電), 2:DC(直流電) | | | Voltage | 充電電壓 | decimal | | 可用 [ChargerInfo].connectorsInfo.connectors.minPower 欄位(要轉換成對應數字) <font color="#f00">**AC時必填**</font> | | | CurrentRating | 充電電流(額定電流) | decimal | | 可用 [ChargerInfo].connectorsInfo.connectors.minCurrent 欄位(要轉換成對應數字) <font color="#f00">**AC時必填**</font> | | | PowerRating | 充電最大功率 | decimal | <font color="#f00">**缺少**</font> | 可用 [ChargerInfo].connectorsInfo.connectors.maxPower, [ChargerInfo].connectorsInfo.connectors.maxCurrent (maxPower * maxCurrent) | | | Floors | 充電樁所在樓層 | string | <font color="#f00">**缺少**</font> | ** 可用 [ChargerInfo].Floor 欄位存放** | | | UsageRestriction | 充電站使用限制(文字描述) | string | <font color="#f00">**缺少**</font> | 非必要欄位可先不用補 | | ## EVChargingRateList : 充電槍充電費率 ### 資料範例 ```xml <EVChargingRateList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <ChargingRates> <ChargingRate> <StationID>42861108-S0001</StationID> <ChargingPointID>42861108-P0002</ChargingPointID> <Rates> <Rate> <RateType>2</RateType> <PricingType>2</PricingType> <Price>10</ Price > <StartTime>00:00</StartTime> <EndTime>7:00</EndTime> <Peak>2</Peak> <OvertimePrice>15</OvertimePrice> </ Rate > <Rate> <RateType>2</RateType> <PricingType>2</PricingType> <Price>20</ Price > <StartTime>07:00</StartTime> <EndTime>20:00</EndTime> <Peak>1</Peak> <OvertimePrice>15</OvertimePrice> </ Rate > ………… </ Rates > </ ChargingRate> ………………………………………………. </ ChargingRates > </EVChargingRateList> ``` ### 欄位說明 - 充電槍列表 <EVChargingRateList> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ------------------ | --------------- | ---------------------------------- | ---------------------------------------------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | 抓充電槍最後一筆建立或更新時間 | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 寫死定義OR新增一張表存放更新週期與最後更新時間 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | ChargingRates | 充電槍充電費率資訊 | ChargingRates[] | | | - 充電槍充電費率 <ChargingRate> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | --------------- | ------------ | -------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | StationID | 充電站代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **siteId** Join SiteInfo，並拿[SiteInfo].Ban 與 [SiteInfo].SiteCode 組起來放入 StationID 即可 | | ChargingPointID | 充電樁代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **identity**，Join ChargerInfo，並拿[SiteInfo].Ban 與 [ChargerInfo].ChargerPointCode 組起來放入 ChargingPointID 即可 | | ConnectorID | 充電槍代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **connectorIdentity**，Join ChargerConnectorInfo 並增加 ChargerConnectorCode 欄位放充電槍代碼** ，最後拿 [SiteInfo].Ban 與 [ChargerConnectorInfo].ChargerConnectorCode 組合來放入 ConnectorID 即可 | | Rates | 充電費率資訊 | Rate[] | <font color="#f00">**用TOU無法完全Match**</font> | | | OvertimeRate | 佔位超收費率 | decimal | <font color="#f00">**缺少**</font> |非必要欄位可先不用補 充滿電時未駛離之佔位費用。單位：元/分 | - 充電費率資訊 <Rate> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | ----------- | ------------ | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | RateType | 費率類型 | int | | 1：免費 Free, 2：計度 By Metering, 3：計分 By Minute | | PricingType | 定價類型 | int | | 1：固定費率 FixedRate/FlateRate, 2：尖離峰定價 Peak-Load Pricing | | RatePrice | 費率價格 | decimal | | | | StartTime | 開始營業時間 | datetime | | 時間格式採(HH:mm) | | EndTime | 結束營業時間 | datetime | | 時間格式採(HH:mm) | | Peak | 尖離峰 | int | | 0：無區分尖離峰時段, 1：尖峰時段, 2：離峰時段 | 問題 : 無法區分夏季與非夏季電價，也無法區分工作天與休假日(只能一律給無區分尖離峰時段的費率) - 充電槍充電費率範例 | | 充電槍充電費率樣態 1<font color="#00f">**(免費)**</font> | 充電槍充電費率樣態 2 <font color="#00f">**(計度&固定費率)**</font> | 充電槍充電費率樣態 3 <font color="#00f">**(計度&尖離峰費率)**</font> | | | | | -------------- | -------------------------------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------ | ------------------------------ | -------------------------------------------- | | 充電費率(描述) | 免費 | 計度/固定/2元每度 | 計度/尖峰/07:30-22:30/4 元每度 | 計度/離峰/22:30-24:00/4 元每度 | 計度/離峰/00:00-07:30/4 元每度 | 計度/未區分尖峰離峰時段/00:00-24:00/4 元每度 | | RateType | 1 | 2 | 2 | 2 | 2 | 2 | | PricingType | 1 | 1 | 2 | 2 | 2 | 2 | | Price | 0 | 2 | 4 | 4 | 4 | 4 | | StartTime | 00:00 | 00:00 | 07:30 | 22:30 | 00:00 | 00:00 | | EndTime | 24:00 | 24:00 | 22:30 | 24:00 | 07:30 | 24:00 | | Peak | 0 | 0 | 1 | 2 | 2 | 0 | ## EVConnectorLiveStatusList : 充電槍即時狀態資料 ### 資料範例 ```xml <EVConnectorLiveStatusList> <UpdateTime>2022-09-30T09:32:07+08:00</UpdateTime> <UpdateInterval>86400</UpdateInterval> <AuthorityCode>TPE</AuthorityCode> <LiveStatuses> <LiveStatus> <StationID>42861108-S0001</StationID> <ChargingPointID>42861108-P0003</ChargingPointID> <ConnectorID>1</ConnectorID> <ConnectorType>2</ConnectorType> <ConnectorStatus>1</ConnectorStatus> <ChargedKWH>120</ChargedKWH> <ChargedPercent>90</ChagredPercent> <LastUpdateTime>2022-09-30T09:32:07+08:00</LastUpdateTime> </LiveStatus> ………………………………………………. </LiveStatuses> </EVConnectorLiveStatusList> ``` ### 欄位說明 - 充電槍即時狀態列表 <EVConnectorLiveStatusList> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料方式 | | -------------- | ------------------ | -------- | ---------------------------------- | ---------- | | UpdateTime | 資料更新時間 | datetime | <font color="#f00">**缺少**</font> | | | UpdateInterval | 資料更新週期(秒) | int | <font color="#f00">**缺少**</font> | 1秒 | | AuthorityCode | 業管機關簡碼 | string | <font color="#f00">**缺少**</font> | | | LiveStatuses | 充電槍即時狀態資料 | LiveStatus[] | | | - 充電槍即時狀態 <LiveStatus> | 欄位名稱 | 欄位說明 | 資料型別 | 是否缺少 | 補資料說明與方式 | | --------------- | ------------ | -------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | StationID | 充電站代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **siteId** Join SiteInfo，並拿[SiteInfo].Ban 與 [SiteInfo].SiteCode 組起來放入 StationID 即可 | | ChargingPointID | 充電樁代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **identity**，Join ChargerInfo，並拿[SiteInfo].Ban 與 [ChargerInfo].ChargerPointCode 組起來放入 ChargingPointID 即可 | | ConnectorID | 充電槍代碼 | string | <font color="#f00">**缺少**</font> | 可以使用 **connectorIdentity**，Join ChargerConnectorInfo 並增加 ChargerConnectorCode 欄位放充電槍代碼** ，最後拿 [SiteInfo].Ban 與 [ChargerConnectorInfo].ChargerConnectorCode 組合來放入 ConnectorID 即可 | | ConnectorType | 充電槍規格 | int | | 透過 session 跟 OCPP 取得 | | ConnectorStatus | 充電槍狀態 | int | | 透過 session 跟 OCPP 取得 | | ChargedKWH | 已充電度數 | decimal | | 透過 session 跟 OCPP 取得 | | ChargedPercent | 已充電百分比 | decimal | | 可以使用 **[MeterValues].socValue** | | LastUpdateTime | 最新更新時間 | datetime | | 可以使用 **[MeterValues].timestamp** |