Open Charge Map （獨立發行者）（預覽版）

開放收費地圖服務提供對世界上最大的充電地點登記處的訪問。您可以將此服務整合到您自己的應用程式或服務中，並將充電位置資料匯出到您自己的系統中。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	特洛伊·泰勒
URL	https://www.hitachisolutions.com
Email	ttaylor@hitachisolutions.com

連接器中繼資料
Publisher	特洛伊·泰勒
網站	https://openchargemap.org/site
隱私策略	https://openchargemap.org/site/about/terms
類別	資料

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	此 API 的 API 金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

取得參考資料	傳回用於查詢 ID 的核心參考資料，例如連線型別、運運算元、國家/地區等。
取得興趣點清單	用於獲取地理邊界內或特定緯度/經度附近的 POI（站點）列表。

取得參考資料

作業識別碼：: ReferenceDataGet

傳回用於查詢 ID 的核心參考資料，例如連線型別、運運算元、國家/地區等。

參數

名稱	機碼	必要	類型	Description
國家/地區 ID	countryid		array	國家/地區識別碼的可選篩選器，與給定數字國家/地區識別碼完全相符（逗號分隔清單）

傳回

用於其他 API 結果和 UI 的核心參考資料集。

核心參考資料: CoreReferenceData

取得興趣點清單

作業識別碼：: POIGet

用於獲取地理邊界內或特定緯度/經度附近的 POI（站點）列表。

參數

名稱	機碼	類型	Description
客戶	client	string	字串來識別您的用戶端應用程式。可選，但建議將您的客戶端與其他機器人/爬蟲區分開來
結果最大值	maxresults	integer	傳回結果數目上限的限制
國碼 (地區碼)	countrycode	string	2 個字元的 ISO 國家/地區代碼，可篩選到一個特定國家/地區
國家/地區 ID	countryid	array	指定數字國家/地區 ID 的完全匹配（逗號分隔列表）
緯度	latitude	double	用於距離計算和過濾的緯度
經度	longitude	double	用於距離計算和過濾的經度
距離	distance	double	選擇性地依與指定緯度/經度的最大距離來篩選結果
距離單位	distanceunit	string	`miles` 或 `km` 距離單位
操作者ID	operatorid	array	與指定 EVSE 運算子 ID 完全相符（逗號分隔清單）
連線類型 ID	connectiontypeid	array	指定連線類型識別碼的完全相符（逗號分隔清單）
層級 ID	levelid	array	在給定充電層級（1-3） ID 上完全相符（逗號分隔清單）
使用類型識別碼	usagetypeid	array	指定使用類型識別碼的完全相符（逗號分隔清單）
狀態類型 ID	statustypeid	array	與指定狀態類型識別碼完全相符（逗號分隔清單）
資料提供者 ID	dataproviderid	array	指定資料提供者識別碼的完全相符（逗號分隔清單）。
開放資料	opendata	boolean	僅對 OCM 提供的（「開啟」）資料使用 opendata=true。
包含註解	includecomments	boolean	如果為true，則使用者註解和媒體項目將包含在結果集中
Verbose	verbose	boolean	設定為 false 以取得移除 Null 專案的較小結果集。
緊湊	compact	boolean	設定為 true 可從輸出中移除參考資料物件（只會傳回常見參考資料的 ID，例如 DataProvider 等）。
駝峰式	camelcase	boolean	設定為true以取得駝峰命名法格式的屬性名稱。
充電點 ID	chargepointid	string	指定 OCM POI ID 上的完全相符（逗號分隔清單）
邊界方塊	boundingbox	array	將結果篩選至指定的邊界方塊。將左上角和右下角框角指定為：（lat，lng），（lat2，lng2）
Polygon	polygon	string	篩選指定多邊形內的結果。為多邊形造型指定編碼聚合線。多邊形將從最後一個點到第一個點自動閉合。
聚合線條	polyline	string	沿著編碼聚合線過濾結果，與距離參數一起使用以增加沿線的搜索距離。聚合線會展開為多邊形以涵蓋搜尋距離。

傳回

response: array of POI

定義

POI

POI（興趣點），也稱為 Site 或 ChargePoint，是有關存在一或多個電動車充電設備的地理站點的頂層資訊集。

名稱	路徑	類型	Description
ID	ID	integer	此 POI （興趣點）的 OCM 參考 ID。
通用唯一識別碼 (UUID)	UUID	uuid	用作代理金鑰的通用唯一識別碼。提交 POI 更新資訊時，必須保留 ID 和 UUID。
用戶評論	UserComments	array of UserComment	本網站的使用者評論或簽到清單
媒體項目	MediaItems	array of MediaItem	用戶為本網站提交的照片列表
最近驗證	IsRecentlyVerified	boolean	動態計算的值，指出此網站最近發生的任何確認活動（積極簽到等）
上次驗證日期	DateLastVerified	date-time	動態計算的值，日期和時間（UTC、ISO 8601）此 POI 最後由使用者編輯或相關使用者註解確認
家長充電點 ID	ParentChargePointID	string	如果存在，則此 POI 中的此資料會取代另一個 POI 中的資訊。一般與消費者無關。
資料提供者 ID	DataProviderID	integer	此POI資料提供者的參考ID
資料提供者參考	DataProvidersReference	string	如果存在，這是資料提供者在其來源資料集中此 POI 的自己的金鑰
操作員 ID	OperatorID	integer	設備網路營運商或擁有者的參考 ID
運算子參考	OperatorsReference	string	網路營運商對本網站的引用（可以是網站參考或單一設備引用）
使用類型識別碼	UsageTypeID	integer	網站使用類型 0 == 未知的參考 ID
使用成本	UsageCost	string	與本網站相關的可能使用成本的自由文本描述。一般與停車費有關，網絡是否以免費方式運營本網站
地址資訊	AddressInfo	AddressInfo	站台和（最近）地址元件資訊的地理位置。
連結	Connections	array of ConnectionInfo	本網站的設備摘要資訊清單
積分數	NumberOfPoints	integer	該站點總體上可用的托架或謹慎站的數量。這表示同時站台使用者數目的限制。
一般意見	GeneralComments	string	POI 的一般附加事實資訊。不鼓勵用戶使用此字段來獲取有關網站質量等的意見。
計劃日期	DatePlanned	date-time	該 POI 正在或計劃調試的日期和時間（UTC、ISO 8601）。一般來說，在確認可操作之前，不應向最終用戶提供計劃的 POI。
最後確認日期	DateLastConfirmed	date-time	根據資料提供者或使用者，此 POI 上次確認的日期和時間（UTC、ISO 8601）。請參閱 DateLastVerified，以取得根據多個訊號動態計算的日期。
狀態類型 ID	StatusTypeID	integer	此 POI 的整體作業狀態類型參考 ID （即作業等）。 0 == 未知
上次狀態更新日期	DateLastStatusUpdate	date-time	更新了此 POI 或直接相關的子屬性的日期和時間（UTC、ISO 8601）。
中繼資料值	MetadataValues	array of	中繼資料值的選用陣列。通常用於指示資料歸屬，但也旨在供將來使用，以指示周圍的裝置、連結或外鍵值到其他資料集中。
數據質量級別	DataQualityLevel	integer	在匯入期間套用的量度，以根據可用資訊詳細資料指出品質層級（5 == 最佳）。目前基本上未使用。
建立日期	DateCreated	date-time	此 POI 已新增至 Open Charge Map 資料庫的日期和時間（UTC、ISO 8601）
提交狀態類型 ID	SubmissionStatusTypeID	integer	套用至此 POI 之提交狀態類型的參考 ID。
資料提供者	DataProvider	DataProvider	資料提供者是來源資料集的控制器，用來建構此 POI 的詳細資料。資料已從其原始形式進行轉換和解釋。每個資料提供者都透過明確的授權或協議提供資料。
運營商信息	OperatorInfo	OperatorInfo	運營商是控制充電點網絡的公共組織。
使用類型	UsageType	UsageType	網站的 [使用類型] 會指出使用量的一般限制。
狀態類型	StatusType	StatusType	站台或設備項目的「狀態類型」會指出它是否一般可運作。
提交狀態類型	SubmissionStatus	SubmissionStatusType	Submission Status 物件，詳細說明 POI 清單狀態。

資料提供者

資料提供者是來源資料集的控制器，用來建構此 POI 的詳細資料。資料已從其原始形式進行轉換和解釋。每個資料提供者都透過明確的授權或協議提供資料。

名稱	路徑	類型	Description
網站 URL	WebsiteURL	string	此資料提供者的網站 URL
評論	Comments	string	一般公眾意見以及有關該資料提供者的資訊。
DataProviderStatusType	DataProviderStatusType	DataProviderStatusType	狀態物件，說明目前是否啟用此資料提供者，以及來源類型（手動輸入、匯入等）。
編輯是否受到限制	IsRestrictedEdit	boolean	目前尚未實施。表示潛在的編輯限制。
開放資料是否獲得許可	IsOpenDataLicensed	boolean	如果為true，則資料提供者會使用開放資料授權
已核准匯入	IsApprovedImport	boolean	如果為 false，則可能無法匯入此提供者的資料。
許可證	License	string	適用於此資料提供者的授權摘要。每個資料提供者都有一個特定的授權或協議。使用資料需要接受給定的授權。
上次匯入日期	DateLastImported	date-time	上次針對此資料提供者執行匯入的日期和時間（UTC）（如果匯入）。
ID	ID	integer	此資料提供者的參考標識碼
Title	Title	string	此資料提供者的標題

運營商信息

運營商是控制充電點網絡的公共組織。

名稱	路徑	類型	Description
網站 URL	WebsiteURL	string	有關此網絡的更多信息的網站
評論	Comments	string
主要聯絡電話	PhonePrimaryContact	string	網路使用者的主要聯絡電話
次要聯絡電話	PhoneSecondaryContact	string	次要聯絡電話
是私人個人	IsPrivateIndividual	boolean	如果為true，則此運算子代表私人個人
地址資訊	AddressInfo	AddressInfo	站台和（最近）地址元件資訊的地理位置。
預訂網址	BookingURL	string	預約的 URL。
聯絡電子郵件	ContactEmail	string	聯絡電子郵件地址。
故障報告電子郵件	FaultReportEmail	string	用於在使用者提交故障報告評論/簽到時向網路操作員發送自動通知
編輯是否受到限制	IsRestrictedEdit	boolean	如果為true，則此網路會限制OCM資料的社群編輯
ID	ID	integer	Id
Title	Title	string	Title

使用類型

網站的 [使用類型] 會指出使用量的一般限制。

名稱	路徑	類型	Description
在地點付款	IsPayAtLocation	boolean	如果為true，則使用量需要在位置付款
是否需要會員資格	IsMembershipRequired	boolean	如果為true，則此使用類型需要註冊或服務成員資格。
是否需要存取金鑰	IsAccessKeyRequired	boolean	如果為true，則此使用方式需要實體存取金鑰
ID	ID	integer	識別碼。
Title	Title	string	標題。

狀態類型

站台或設備項目的「狀態類型」會指出它是否一般可運作。

名稱	路徑	類型	Description
正在運行	IsOperational	boolean	是否可操作。
使用者是否可選取	IsUserSelectable	boolean	使用者是否可選擇。
ID	ID	integer	識別碼。
Title	Title	string	標題。

提交狀態類型

Submission Status 物件，詳細說明 POI 清單狀態。

名稱	路徑	類型	Description
ID	ID	integer	提交狀態類型參考 ID
Title	Title	string	標題。
已上線	IsLive	boolean	如果為true，則POI列表是實時的（不是草稿或除名）

國家

國家/地區詳細信息。

名稱	路徑	類型	Description
ID	ID	integer	Id 結構描述
ISO代碼	ISOCode	string	ISO 代碼架構
大陸代碼	ContinentCode	string	大陸程式碼架構
Title	Title	string	標題結構描述

地址資訊

站台和（最近）地址元件資訊的地理位置。

名稱	路徑	類型	Description
ID	ID	integer	ID
地址行	AddressLine1	string	附近街道地址的第一行
地址行 2	AddressLine2	string	附近街道地址的第二行
城鎮或城市	Town	string	城鎮或城市
州或省	StateOrProvince	string	州或省
郵遞區號	Postcode	string	郵遞區號或郵遞區號
國家/地區 ID	CountryID	integer	國家/地區的參考 ID
國家	Country	Country	國家/地區詳細信息。
緯度	Latitude	double	網站緯度座標（以十進制度為單位）
經度	Longitude	double	網站經度座標（以十進制度為單位）
聯絡電話	ContactTelephone1	string	主要聯絡電話
聯絡電話 2	ContactTelephone2	string	次要聯絡電話
聯絡電子郵件	ContactEmail	string	主要聯絡人電子郵件
訪問評論	AccessComments	string	使用者使用或尋找設備的指南
相關網址	RelatedURL	string	可選網站了解更多信息
距離	Distance	double	與搜尋位置的距離（如果搜尋是在某個點周圍）
距離單位	DistanceUnit	integer	用於距離的單位，1 = 英里，2 = 公里
Title	Title	string	此位置的通用標題以幫助用戶

用戶評論

特定充電點（POI/站點）的用戶評論或簽到。

名稱	路徑	類型	Description
ID	ID	integer	識別碼。
充電點 ID	ChargePointID	integer	充電點識別碼。
註解類型識別碼	CommentTypeID	integer	註解類型識別碼。
使用者註解類型	CommentType	UserCommentType	用戶評論的類別，例如一般評論、故障報告（給用戶和運營商的通知）。
用戶名稱	UserName	string	用戶名稱。
評論	Comment	string	評論。
相關網址	RelatedURL	string	相關 URL 位址。
建立日期	DateCreated	date-time	建立日期。
UserInfo	User	UserInfo	特定 Open Charge Map 使用者的簡短公開摘要設定檔。
簽入狀態類型 ID	CheckinStatusTypeID	integer	簽入狀態類型識別碼。
簽入狀態類型	CheckinStatusType	CheckinStatusType	使用者評論或使用特定充電位置的體驗的分類。

媒體項目

使用者提交了與特定充電點或站點相關的媒體項目。目前始終是圖像。

名稱	路徑	類型	Description
ID	ID	integer	識別碼。
充電點 ID	ChargePointID	integer	充電點識別碼。
項目網址	ItemURL	string	項目 URL 位址。
項目縮圖 URL	ItemThumbnailURL	string	項目縮圖 URL 位址。
評論	Comment	string	評論。
已啟用	IsEnabled	boolean	是否已啟用。
是視頻	IsVideo	boolean	無論是視頻。
是特色項目	IsFeaturedItem	boolean	是否為特色項目。
是外部資源	IsExternalResource	boolean	是否是外部資源。
UserInfo	User	UserInfo	特定 Open Charge Map 使用者的簡短公開摘要設定檔。
建立日期	DateCreated	string	建立日期。

連接資訊

有關設備類型和功率能力的詳細信息。

名稱	路徑	類型	Description
ID	ID	integer	識別碼。
連線類型 ID	ConnectionTypeID	integer	連線類型識別碼。
連接類型	ConnectionType	ConnectionType	EVSE 支援的最終使用者連線類型。
Reference	Reference	string	此連線/埠的選用運算子參考
狀態類型 ID	StatusTypeID	integer	狀態類型參考 ID。0 = 未知
狀態類型	StatusType	StatusType	站台或設備項目的「狀態類型」會指出它是否一般可運作。
層級 ID	LevelID	integer	電源能力的一般類別。已棄用，轉而記錄特定設備功率（以千瓦為單位）。
層級類型	Level	LevelType	設備電源能力的一般類別。已棄用，無法用於一般用途。目前根據設備功率自動計算。
放大器	Amps	integer	EVSE 電源最大電流（以安培為單位）
電壓	Voltage	double	EVSE 電源電壓
功率千瓦	PowerKW	double	峰值可用功率（以 kW 為單位）
目前類型 ID	CurrentTypeID	integer	電源類型參考 ID（例如 DC 等）
供應類型	CurrentType	SupplyType	指示 EVSE 電源類型，例如 DC（直流電）、AC（單相）、AC（三相）。
數量	Quantity	integer	此規格可用的設備項目的可選摘要數量
評論	Comments	string	評論。

連接類型

EVSE 支援的最終使用者連線類型。

名稱	路徑	類型	Description
正式名稱	FormalName	string	此連線類型的正式（標準）名稱
已停產	IsDiscontinued	boolean	如果為true，則這是已停止但已使用的連線類型
已過時	IsObsolete	boolean	如果為true，則這是一種過時的連線類型，不太可能出現在現代基礎結構中
ID	ID	integer	識別碼。
Title	Title	string	標題。

層級類型

設備電源能力的一般類別。已棄用，無法用於一般用途。目前根據設備功率自動計算。

名稱	路徑	類型	Description
ID	ID	integer	識別碼。
Title	Title	string	標題。
評論	Comments	string	評論。
是快速充電能力	IsFastChargeCapable	boolean	如果為true，則相對於其他級別，此級別被視為“快速”充電。

供應類型

指示 EVSE 電源類型，例如 DC（直流電）、AC（單相）、AC（三相）。

名稱	路徑	類型	Description
ID	ID	integer	識別碼。
Title	Title	string	標題。

UserInfo

特定 Open Charge Map 使用者的簡短公開摘要設定檔。

名稱	路徑	類型	Description
ID	ID	integer	識別碼。
用戶名稱	Username	string	用戶名稱。
聲譽點數	ReputationPoints	integer	聲譽點。
設定檔影像URL	ProfileImageURL	string	設定檔影像URL位址。

簽入狀態類型

使用者評論或使用特定充電位置的體驗的分類。

名稱	路徑	類型	Description
ID	ID	integer	識別碼。
Title	Title	string	標題。
是否自動辦理登機手續	IsAutomatedCheckin	boolean	如果為true，則簽到或註解是由自動化系統提供的。
是正的	IsPositive	boolean	如果為true，則此類型的簽入/註解會被視為正面。

核心參考資料