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

この状態タイプのタイトル