Open Charge Map (独立発行者) (プレビュー)

Open Charge Map は、世界最大級の充電スポット情報を提供するサービスです。 このサービスを独自のアプリやサービスに統合し、充電スポット情報データを独自のシステムにエクスポートできます。

このコネクタは、次の製品および地域で利用可能です:

Service	クラス	地域
Logic Apps	標準	以下を除くすべての Logic Apps 地域 :      -   Azure 政府の地域      -   Azure 中国の地域      -   国防総省 (DoD)
Power Automate	プレミアム	以下を除くすべての Power Automate 地域 :      -   米国政府 (GCC)      -   米国政府 (GCC High)      -   21Vianet が運用する中国のクラウド      -   国防総省 (DoD)
Power Apps	プレミアム	以下を除くすべての Power Apps 地域 :      -   米国政府 (GCC)      -   米国政府 (GCC High)      -   21Vianet が運用する中国のクラウド      -   米国国防総省 (DoD)

お問い合わせ先
件名	Troy Taylor
[URL]	https://www.hitachisolutions.com
メール	ttaylor@hitachisolutions.com

Connector Metadata
発行者	Troy Taylor
Web サイト	https://openchargemap.org/site
プライバシー ポリシー	https://openchargemap.org/site/about/terms
カテゴリー	データ​​

接続の作成

コネクタは、次の認証タイプをサポートしています:

既定	接続を作成するためのパラメーター。	すべての地域	共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名	タイプ	内容	必要
API キー	securestring	この API の API キー	True

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

POI の一覧を取得する	地理的境界線内または特定の経度/緯度付近の POI (サイト) の一覧を取得するために使用します。
参照データを取得する	接続の種類、オペレーター、国などの ID を検索するために使用されるコア参照データを返します。

POI の一覧を取得する

操作 ID:

POIGet

地理的境界線内または特定の経度/緯度付近の POI (サイト) の一覧を取得するために使用します。

パラメーター

名前	キー	必須	型	説明
Client	client		string	クライアント アプリケーションを識別する文字列。 オプションですが、クライアントを他のボット/クローラーと区別するために推奨されています
結果の最大件数	maxresults		integer	返される結果の最大件数
Country Code	countrycode		string	2 文字の ISO 国コードで 1 つの特定の国にフィルタリングします
Country ID	countryid		array	指定された数値の国 ID に完全一致するもの (コンマ区切りの一覧)
経度	latitude		integer	距離計算とフィルタリングに使用する経度
緯度	longitude		double	距離計算とフィルタリングに使用する緯度
Distance	distance		double	オプションで、指定された経度/緯度からの最大距離で結果をフィルタリングします
距離の単位	distanceunit		string	miles または km の距離の単位
オペレーター ID	operatorid		array	指定された EVSE オペレーター ID に完全一致するもの (コンマ区切りの一覧)
接続の種類 ID	connectiontypeid		array	指定された接続の種類 ID に完全一致するもの (コンマ区切りの一覧)
レベル ID	levelid		array	指定された充電レベル (1-3) ID に完全一致するもの (コンマ区切りの一覧)
使用状況の種類 ID	usagetypeid		array	指定された使用状況の種類 ID に完全一致するもの (コンマ区切りの一覧)
状態の種類 ID	statustypeid		array	指定された状態の種類 ID に完全一致するもの (コンマ区切りの一覧)
データ プロバイダー ID	dataproviderid		array	指定されたデータ プロバイダー ID に完全一致するもの (コンマ区切りの一覧)。
オープン データ	opendata		boolean	OCM が提供する ("Open") データのみに opendata=true を使用します。
コメントを含む	includecomments		boolean	true の場合、ユーザー コメントとメディア項目が結果セットに含まれます
詳細	verbose		boolean	false に設定して、null 項目が削除された小さな結果セットを取得します。
コンパクト	compact		boolean	true に設定して、出力から参照データ オブジェクトを削除します (DataProvider などの一般的な参照データの ID を返すだけです)。
キャメル ケース	camelcase		boolean	true に設定して、キャメル ケースでプロパティ名を取得します。
充電ポイント ID	chargepointid		string	指定された OCM POI ID に完全一致するもの (コンマ区切りの一覧)
境界ボックス	boundingbox		array	結果を指定された境界ボックスにフィルタリングします。 ボックスの左上と右下の角を次のように指定します: (緯度,経度),(緯度2,経度2)
Polygon	polygon		string	指定された多角形内で結果をフィルタリングします。 多角形形状のエンコードされたポリラインを指定します。 多角形は、最後の点から最初の点まで自動的に閉じられます。
ポリライン	polyline		string	エンコードされたポリラインに沿って結果をフィルタリングし、距離パラメーターと共に使用して、ラインに沿った検索距離を長くします。 ポリラインを多角形に展開し、検索距離をカバーします。

戻り値

返答

array of POI

参照データを取得する

操作 ID:

ReferenceDataGet

接続の種類、オペレーター、国などの ID を検索するために使用されるコア参照データを返します。

パラメーター

名前	キー	必須	型	説明
Country ID	countryid		array	国 ID のオプション フィルターで、指定された数値の国 ID に完全一致するもの (コンマ区切りの一覧)

戻り値

他の API 結果と UI に使用される一連のコア参照データ。

CoreReferenceData

CoreReferenceData

定義

POI

POI (Point of Interest) は、Site または ChargePoint とも呼ばれ、1 つ以上の電気自動車充電設備が存在する地理的サイトに関するトップレベルの情報セットです。

名前	パス	型	説明
ID	ID	integer	この POI (Point of Interest) の OCM 参照 ID。
UUID	UUID	uuid	代理キーとして使用される汎用一意識別子。 POI 更新情報を提出する際は、ID と UUID を保存する必要があります。
ユーザー コメント	UserComments	array of UserComment	このサイトに対するユーザー コメントまたはチェックインの一覧
メディア項目	MediaItems	array of MediaItem	このサイトにユーザーが投稿した写真の一覧
最近検証済みかどうか	IsRecentlyVerified	boolean	このサイトに対して最近実行された任意の確認活動 (肯定的チェックインなど) を示す動的に計算された値
最終検証日	DateLastVerified	date-time	動的に計算される値で、この POI ユーザーの編集または関連するユーザー コメントによって最後に確認された日時 (UTC、ISO 8601)
親充電ポイント ID	ParentChargePointID	string	存在する場合、この POI のこのデータは、別の POI の情報に取って代わります。 通常、消費者には関係ありません。
データ プロバイダー ID	DataProviderID	integer	この POI のデータ プロバイダーに対する参照 ID
データ プロバイダー参照	DataProvidersReference	string	存在する場合、これはソース データ セット内のこの POI に対するデータ プロバイダー独自のキーです
オペレーター ID	OperatorID	integer	設備のネットワーク オペレーターまたは所有者の参照 ID
オペレーター参照	OperatorsReference	string	このサイトに対するネットワーク オペレーター自身の参照 (サイト参照または単一設備参照の可能性がある)
使用状況の種類 ID	UsageTypeID	integer	サイトの使用状況タイプの参照 ID、0 == 不明
利用料金	UsageCost	string	このサイトに関連する利用料金の可能性についての自由形式の説明。 通常、ネットワークがこのサイトを無料で運営しているかどうか、駐車料金に関するものです
AddressInfo	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 == 最も良い)。 現在ほとんど使用していません。
Date Created	DateCreated	date-time	この POI が Open Charge Map データベースに追加された日時 (UTC、ISO 8601)
送信状況の種類 ID	SubmissionStatusTypeID	integer	この POI に適用される送信状況の種類の参照 ID。
DataProvider	DataProvider	DataProvider	データ プロバイダーは、この POI の詳細を構築するのに使用されるソース データ セットのコントローラーです。 データは、元の形式から変換および解釈されています。 各データ プロバイダーは、明示的なライセンスまたは契約のいずれかによりデータを提供します。
OperatorInfo	OperatorInfo	OperatorInfo	オペレーターは、充電ポイントのネットワークを管理する公的機関です。
UsageType	UsageType	UsageType	サイトの使用状況の種類は、使用状況に関する一般的な制限を示します。
StatusType	StatusType	StatusType	サイトまたは設備項目の状態の種類は、それが一般的に動作可能であるかどうかを示します。
SubmissionStatusType	SubmissionStatus	SubmissionStatusType	POI 掲載状況の詳細を示す送信状況のオブジェクト。

DataProvider

データ プロバイダーは、この POI の詳細を構築するのに使用されるソース データ セットのコントローラーです。 データは、元の形式から変換および解釈されています。 各データ プロバイダーは、明示的なライセンスまたは契約のいずれかによりデータを提供します。

名前	パス	型	説明
Web サイトの URL	WebsiteURL	string	このデータ プロバイダーの Web サイト URL
Comments	Comments	string	このデータ プロバイダーに関する情報を含む一般的な公開コメント。
DataProviderStatusType	DataProviderStatusType	DataProviderStatusType	このデータ プロバイダーが現在有効になっているかどうか、およびソースの種類 (手動入力、インポートなど) を示す状態オブジェクト。
制限された編集​かどうか	IsRestrictedEdit	boolean	現在、実装されていません。 潜在的な編集制限を示します。
オープン データがライセンス取得済みがどうか	IsOpenDataLicensed	boolean	true の場合、データ プロバイダーはオープン データ ライセンスを使用します
承認されたインポートかどうか	IsApprovedImport	boolean	false の場合、このプロバイダーのデータはインポートされない可能性があります。
ライセンス	License	string	このデータ プロバイダーに適用されるライセンスの概要。 各データ プロバイダーには、1 つの特定のライセンスまたは契約があります。 データの利用には、指定されたライセンスに同意していただく必要があります。
最後にインポートした日付	DateLastImported	date-time	このデータ プロバイダーに対して最後にインポートが実行された日時 (UTC) (インポートの場合)。
ID	ID	integer	このデータ プロバイダーに対する参照 ID
肩書き	Title	string	このデータ プロバイダーの肩書き

OperatorInfo

オペレーターは、充電ポイントのネットワークを管理する公的機関です。

名前	パス	型	説明
Web サイトの URL	WebsiteURL	string	このネットワークの詳細情報についての Web サイト
Comments	Comments	string
基本連絡先の電話番号	PhonePrimaryContact	string	ネットワーク ユーザーの基本連絡先の電話番号
セカンダリ連絡先の電話番号	PhoneSecondaryContact	string	セカンダリ連絡先の電話番号
個人であるかどうか	IsPrivateIndividual	boolean	true の場合、このオペレーターは個人を表します
AddressInfo	AddressInfo	AddressInfo	サイトおよび (最寄りの) 住所内容情報の地理的位置。
予約 URL	BookingURL	string	予約の URL。
連絡先メール	ContactEmail	string	取引先担当者のメール アドレスです。
エラー報告メール	FaultReportEmail	string	ユーザーがエラー レポートのコメント/チェックインを送信した場合、ネットワーク オペレーターに自動通知を送信するために使用されます
制限された編集​かどうか	IsRestrictedEdit	boolean	true の場合、このネットワークは OCM データのコミュニティ編集を制限します
ID	ID	integer	Id
肩書き	Title	string	肩書き

UsageType

サイトの使用状況の種類は、使用状況に関する一般的な制限を示します。

名前	パス	型	説明
現地払いかどうか	IsPayAtLocation	boolean	true の場合、使用の際に現地払いとなります
メンバーシップが必要かどうか	IsMembershipRequired	boolean	true の場合、この利用形態にはサービスへの登録またはメンバーシップが必要です。
アクセス キーが必要かどうか	IsAccessKeyRequired	boolean	true の場合、この使用には物理的アクセス キーが必要です
ID	ID	integer	識別子。
肩書き	Title	string	肩書き。

StatusType

サイトまたは設備項目の状態の種類は、それが一般的に動作可能であるかどうかを示します。

名前	パス	型	説明
稼働中かどうか	IsOperational	boolean	稼働中かどうか。
ユーザーが選択可能か	IsUserSelectable	boolean	ユーザーが選択可能かどうか。
ID	ID	integer	識別子。
肩書き	Title	string	肩書き。

SubmissionStatusType

POI 掲載状況の詳細を示す送信状況のオブジェクト。

名前	パス	型	説明
ID	ID	integer	送信状況タイプの参照 ID
肩書き	Title	string	肩書き。
ライブかどうか	IsLive	boolean	true の場合、POI 一覧はライブです (下書きまたはリスト解除ではありません)

Country

国の詳細。

名前	パス	型	説明
ID	ID	integer	ID スキーマ
ISO コード	ISOCode	string	ISO コード スキーマ
大陸コード	ContinentCode	string	大陸コード スキーマ
肩書き	Title	string	肩書きスキーマ

AddressInfo

サイトおよび (最寄りの) 住所内容情報の地理的位置。

名前	パス	型	説明
ID	ID	integer	ID
住所	AddressLine1	string	最寄りの番地の 1 行目
住所行 2	AddressLine2	string	最寄りの番地の 2 行目
市町村	Town	string	市町村
都道府県	StateOrProvince	string	都道府県
Postcode	Postcode	string	郵便番号
Country ID	CountryID	integer	国の参照 ID
Country	Country	Country	国の詳細。
経度	Latitude	double	小数度で表したサイトの緯度座標
緯度	Longitude	double	小数度で表したサイトの経度座標
連絡先の電話番号	ContactTelephone1	string	基本連絡先の電話番号
連絡先の電話番号 2	ContactTelephone2	string	セカンダリ連絡先の電話番号
連絡先メール	ContactEmail	string	基本連絡先のメールアドレス
アクセス コメント	AccessComments	string	ユーザーが設備を使用または検索するためのガイダンス
関連 URL	RelatedURL	string	詳細情報用のオプション Web サイト
Distance	Distance	double	検索位置からの距離 (検索がポイント周辺の場合)
距離の単位	DistanceUnit	integer	距離に使用される単位、1= マイル、2 = キロメートル
肩書き	Title	string	ユーザーに役立つ、この場所の一般的なタイトル

UserComment

特定の充電ポイント (POI/サイト) に対するユーザー コメントまたはチェックイン。

名前	パス	型	説明
ID	ID	integer	識別子。
充電ポイント ID	ChargePointID	integer	充電ポイントの識別子。
コメントの種類 ID	CommentTypeID	integer	コメントの種類の識別子。
UserCommentType	CommentType	UserCommentType	一般的なコメント、エラー レポート (ユーザーおよびオペレーターへの通知) など、ユーザー コメントのカテゴリ。
Username	UserName	string	ユーザー名。
Comment	Comment	string	コメント。
関連 URL	RelatedURL	string	関連 URL アドレス。
Date Created	DateCreated	date-time	作成日。
ユーザー情報	User	UserInfo	特定の Open Charge Map ユーザーの短い公開概要プロファイル。
チェックイン状況の種類 ID	CheckinStatusTypeID	integer	チェックイン状況の種類の識別子。
CheckinStatusType	CheckinStatusType	CheckinStatusType	特定の充電場所を使用しているユーザーのコメントまたは体験の分類。

MediaItem

ユーザーが特定の充電ポイントまたはサイトに関連するメディア項目を送信しました。 現在、常に画像となります。

名前	パス	型	説明
ID	ID	integer	識別子。
充電ポイント ID	ChargePointID	integer	充電ポイントの識別子。
品目 URL	ItemURL	string	項目 URL アドレス。
項目のサムネイル URL	ItemThumbnailURL	string	項目のサムネイル URL アドレス。
Comment	Comment	string	コメント。
Is Enabled	IsEnabled	boolean	有効であるかどうか。
ビデオかどうか	IsVideo	boolean	ビデオかどうか。
おすすめの項目かどうか	IsFeaturedItem	boolean	おすすめの項目かどうか。
外部リソースかどうか	IsExternalResource	boolean	外部リソースかどうか。
ユーザー情報	User	UserInfo	特定の Open Charge Map ユーザーの短い公開概要プロファイル。
Date Created	DateCreated	string	作成日。

ConnectionInfo

設備タイプと電力容量の詳細。

名前	パス	型	説明
ID	ID	integer	識別子。
接続の種類 ID	ConnectionTypeID	integer	接続の種類を表す識別子。
ConnectionType	ConnectionType	ConnectionType	EVSE がサポートするエンドユーザー接続の種類。
信用照会	Reference	string	この接続/ポートに関するオプションのオペレーター参照
状態の種類 ID	StatusTypeID	integer	状態の種類の参照 ID 0 = 不明
StatusType	StatusType	StatusType	サイトまたは設備項目の状態の種類は、それが一般的に動作可能であるかどうかを示します。
レベル ID	LevelID	integer	電力容量を表す一般的なカテゴリ。 特定の機器の電力を kW 単位で表記することを優先するため非推奨になりました。
LevelType	Level	LevelType	機器の電力容量を表す一般的なカテゴリ。 一般的な使用では非推奨です。 現在、機器の電力に基づいて自動計算されています。
アンペア	Amps	integer	EVSE の最大供給電流 (アンペア)
電圧	Voltage	double	EVSE の供給電圧
電力 KW	PowerKW	double	ピーク時有効電力 (kW)
電流の種類 ID	CurrentTypeID	integer	供給タイプの参照 ID (例: DC など)
SupplyType	CurrentType	SupplyType	DC (直流)、AC (単相交流)、AC (三相交流) などの EVSE 電力供給タイプを示します。
品質	Quantity	integer	この仕様で利用可能な機器項目のオプションの概要数
Comments	Comments	string	コメント。

ConnectionType

EVSE がサポートするエンドユーザー接続の種類。

名前	パス	型	説明
正式名称	FormalName	string	この接続タイプの正式 (標準) 名称
廃止されたかどうか	IsDiscontinued	boolean	true の場合、これは廃止されたが使用されている接続タイプです
廃止	IsObsolete	boolean	true の場合、これは廃止された接続タイプであり、最新のインフラストラクチャには存在しない可能性があります
ID	ID	integer	識別子。
肩書き	Title	string	肩書き。

LevelType

機器の電力容量を表す一般的なカテゴリ。 一般的な使用では非推奨です。 現在、機器の電力に基づいて自動計算されています。

名前	パス	型	説明
ID	ID	integer	識別子。
肩書き	Title	string	肩書き。
Comments	Comments	string	コメント。
IsFastChargeCapable	IsFastChargeCapable	boolean	true の場合、このレベルは他のレベルに比べて「高速」充電と見なされます。

SupplyType

DC (直流)、AC (単相交流)、AC (三相交流) などの EVSE 電力供給タイプを示します。

名前	パス	型	説明
ID	ID	integer	識別子。
肩書き	Title	string	肩書き。

ユーザー情報

特定の Open Charge Map ユーザーの短い公開概要プロファイル。

名前	パス	型	説明
ID	ID	integer	識別子。
Username	Username	string	ユーザー名。
評価ポイント	ReputationPoints	integer	評価ポイント。
プロファイル画像 URL	ProfileImageURL	string	プロファイル画像の URL アドレス。

CheckinStatusType

特定の充電場所を使用しているユーザーのコメントまたは体験の分類。

名前	パス	型	説明
ID	ID	integer	識別子。
肩書き	Title	string	肩書き。
自動化されたチェックインかどうか	IsAutomatedCheckin	boolean	true の場合、自動システムによりチェックインまたはコメントが提供されました。
肯定的であるかどうか	IsPositive	boolean	true の場合、このタイプのチェックイン/コメントは肯定的と見なされます。

CoreReferenceData

他の API 結果と UI に使用される一連のコア参照データ。

名前	パス	型	説明
充電器の種類	ChargerTypes	array of LevelType	充電器の種類。
接続の種類	ConnectionTypes	array of ConnectionType	接続の種類。
チェックイン状況の種類	CheckinStatusTypes	array of CheckinStatusType	チェックイン状況の種類。
国	Countries	array of Country	国。
電流の種類	CurrentTypes	array of SupplyType	電流の種類。
データ プロバイダー	DataProviders	array of DataProvider	データ プロバイダー。
Operators	Operators	array of OperatorInfo	オペレーター
状態の種類	StatusTypes	array of StatusType	状態の種類。
送信状況の種類	SubmissionStatusTypes	array of SubmissionStatusType	送信状況の種類。
使用状況タイプ	UsageTypes	array of UsageType	使用状況タイプ。
ユーザー コメントの種類	UserCommentTypes	array of UserCommentType	ユーザー コメントの種類。

UserCommentType

一般的なコメント、エラー レポート (ユーザーおよびオペレーターへの通知) など、ユーザー コメントのカテゴリ。

名前	パス	型	説明
ID	ID	integer	識別子。
肩書き	Title	string	肩書き。

DataProviderStatusType

このデータ プロバイダーが現在有効になっているかどうか、およびソースの種類 (手動入力、インポートなど) を示す状態オブジェクト。

名前	パス	型	説明
プロバイダーが有効かどうか	IsProviderEnabled	boolean	false の場合、このデータ プロバイダーからの結果は現在有効になっていません
ID	ID	integer	このプロバイダーの状態タイプに対する参照 ID
説明設定	description	string	この状態タイプのタイトル