Карта open Charge Map (Независимый издатель) (предварительная версия)

Служба Open Charge Map предоставляет доступ к крупнейшему в мире реестру мест зарядки. Эту службу можно интегрировать в собственные приложения или службы и экспортировать данные о расположении зарядки в собственные системы.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Трой Тейлор
URL https://www.hitachisolutions.com
Адрес электронной почты ttaylor@hitachisolutions.com
Метаданные соединителя
Publisher Трой Тейлор
Веб-сайт https://openchargemap.org/site
Политика конфиденциальности https://openchargemap.org/site/about/terms
Категории Данные

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Ключ API securestring Ключ API для этого API True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Получение списка POIS

Используется для получения списка POIs (сайтов) в пределах географической границы или вблизи определенной широты или долготы.

Получение ссылочных данных

Возвращает основные справочные данные, используемые для поиска идентификаторов, таких как типы подключений, операторы, страны и т. д.

Получение списка POIS

Используется для получения списка POIs (сайтов) в пределах географической границы или вблизи определенной широты или долготы.

Параметры

Имя Ключ Обязательно Тип Описание
Клиент
client string

Строка для идентификации клиентского приложения. Необязательно, но рекомендуется отличать клиента от других ботов или обходчиков

Максимальное значение результатов
maxresults integer

Ограничение на максимальное число возвращаемых результатов

Код страны
countrycode string

2-символьный код страны ISO для фильтрации по одной конкретной стране

Идентификатор страны
countryid array

Точное совпадение с заданным числовым идентификатором страны (разделенный запятыми список)

Широта
latitude double

Широта для вычисления расстояния и фильтрации

Долгота
longitude double

Долгота для вычисления расстояния и фильтрации

Расстояние
distance double

При необходимости фильтруйте результаты по максимальному расстоянию от заданной широты или долготы

Ед. изм. расстояния
distanceunit string

miles или km единица расстояния

Идентификатор опертатора
operatorid array

Точное совпадение с заданным идентификатором оператора EVSE (разделенный запятыми список)

Идентификатор типа подключения
connectiontypeid array

Точное совпадение с заданным идентификатором типа подключения (разделенный запятыми список)

Идентификатор уровня
levelid array

Точное совпадение на заданном уровне зарядки (1-3) идентификатор (разделенный запятыми список)

Идентификатор типа использования
usagetypeid array

Точное совпадение с заданным идентификатором типа использования (разделенный запятыми список)

Идентификатор типа состояния
statustypeid array

Точное совпадение с заданным идентификатором типа состояния (разделенный запятыми список)

Идентификатор поставщика данных
dataproviderid array

Точное совпадение с заданным идентификатором поставщика данных (разделенный запятыми список).

Открытие данных
opendata boolean

Используйте opendata=true только для предоставленных данных OCM ("Open").

Включение комментариев
includecomments boolean

Если значение true, комментарии пользователей и элементы мультимедиа будут включены в результирующий набор

Verbose
verbose boolean

Установите значение false, чтобы получить меньший результирующий набор с удаленными элементами NULL.

Компактный
compact boolean

Задайте значение true, чтобы удалить объекты ссылочных данных из выходных данных (просто возвращает идентификаторы для общих ссылочных данных, таких как DataProvider и т. д.).

Верблюдьи
camelcase boolean

Задайте значение true, чтобы получить имена свойств в формате верблюдьего Регистра.

Идентификатор точки оплаты
chargepointid string

Точное совпадение с заданным идентификатором POI OCM (разделенный запятыми список)

Ограничивающий прямоугольник
boundingbox array

Фильтруйте результаты в заданное ограничивающее поле. укажите верхний левый и нижний правые прямоугольники следующим образом: (lat,lng),(lat2,lng2)

Polygon
polygon string

Фильтрация результатов в заданном многоугольнике. Укажите закодированную многолинейную линию для фигуры многоугольника. Многоугольник будет автоматически закрыт с последней точки до первой точки.

Полилайн
polyline string

Фильтруйте результаты вдоль закодированной полилайна, используйте с параметром расстояния для увеличения расстояния поиска вдоль линии. Полилайн расширяется в многоугольник для покрытия расстояния поиска.

Возвращаемое значение

response
array of POI

Получение ссылочных данных

Возвращает основные справочные данные, используемые для поиска идентификаторов, таких как типы подключений, операторы, страны и т. д.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор страны
countryid array

Необязательный фильтр по идентификатору страны, точное совпадение с заданным числовым идентификатором страны (разделенный запятыми список)

Возвращаемое значение

Набор основных ссылочных данных, используемых для других результатов API и пользовательского интерфейса.

CoreReferenceData
CoreReferenceData

Определения

ПОИ

POI (точка интереса), также называемый Site или ChargePoint, является набором информации верхнего уровня относительно географического сайта с одним или несколькими электрическим оборудованием зарядки транспортного средства.

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор ссылки OCM для этого POI (точка интереса).

UUID (Универсальный уникальный идентификатор)
UUID uuid

Универсальный уникальный идентификатор, используемый в качестве суррогатного ключа. Идентификатор и UUID должны быть сохранены при отправке сведений об обновлении POI.

Комментарии пользователей
UserComments array of UserComment

Список примечаний пользователей или входов для этого сайта

Элементы мультимедиа
MediaItems array of MediaItem

Список отправленных пользователем фотографий для этого сайта

Недавно проверено
IsRecentlyVerified boolean

Динамическое вычисленное значение, указывающее на какое-либо недавно подтвержденное действие для этого сайта (положительные проверки и т. д.)

Дата последней проверки
DateLastVerified date-time

Динамическое вычисляемое значение, дата и время (UTC, ISO 8601) этот POI был в последний раз подтвержден изменением или соответствующим комментарием пользователя.

Идентификатор родительской точки оплаты
ParentChargePointID string

Если они присутствуют, эти данные в этом POI заменяют сведения в другом POI. Как правило, не относится к потребителям.

Идентификатор поставщика данных
DataProviderID integer

Идентификатор ссылки для поставщика данных данного POI

Справочник по поставщику данных
DataProvidersReference string

В этом случае поставщики данных имеют собственный ключ для этого POI в исходном наборе данных.

Идентификатор оператора
OperatorID integer

Справочный идентификатор сетевого оператора оборудования или владельца

Справочник по операторам
OperatorsReference string

Сетевые операторы имеют ссылку на этот сайт (может быть ссылкой на сайт или одной ссылкой на оборудование).

Идентификатор типа использования
UsageTypeID integer

Идентификатор ссылки для типа использования сайта, 0 == Неизвестно

Затраты на использование
UsageCost string

Описание бесплатного текста о вероятных затратах на использование, связанных с этим сайтом. Как правило, относится к платам за парковку, работает ли сеть на этом сайте как бесплатный

AddressInfo
AddressInfo AddressInfo

Географическое положение для сведений о компоненте сайта и (ближайшего) адреса.

Connections
Connections array of ConnectionInfo

Список сведений об оборудовании для этого сайта

Количество точек
NumberOfPoints integer

Количество заливов или сдержанных станций, доступных в целом на этом сайте. Это означает ограничение числа одновременных пользователей сайта.

Общие комментарии
GeneralComments string

Общие дополнительные сведения о факте для POI. Пользователям не рекомендуется использовать это поле для мнения о качестве сайта и т. д.

Дата планирования
DatePlanned date-time

Дата и время (UTC, ISO 8601) этот POI или планируется для ввода в эксплуатацию. В общих запланированных версиях POIs не следует представлять конечным пользователям до тех пор, пока не подтвердите работу.

Дата последнего подтверждения
DateLastConfirmed date-time

Дата и время (UTC, ISO 8601) последний раз подтвердился в соответствии с поставщиком данных или пользователем. Сведения о динамически вычисляемой дате см. в разделе DateLastVerified на основе нескольких сигналов.

Идентификатор типа состояния
StatusTypeID integer

Общий идентификатор ссылочного типа рабочего состояния для данного POI (т. е. операционный и т. д.). 0 == Неизвестно

Обновление последнего состояния даты
DateLastStatusUpdate date-time

Дата и время (UTC, ISO 8601) этот POI или непосредственно связанные дочерние свойства были обновлены.

Значения метаданных
MetadataValues array of

Необязательный массив значений метаданных. Обычно используется для указания присвоения данных, но также предназначен для дальнейшего использования для указания окружающих аментов, ссылок или значений внешнего ключа в других наборах данных.

Уровень качества данных
DataQualityLevel integer

Метрика, применяемая во время импорта, для указания уровня качества на основе доступных сведений (5 == лучше). В настоящее время в значительной степени не используется.

Дата создания
DateCreated date-time

Дата и время (UTC, ISO 8601) этот POI был добавлен в базу данных карты open Charge Map

Идентификатор типа состояния отправки
SubmissionStatusTypeID integer

Идентификатор ссылки для типа состояния отправки, применяемого к этому POI.

DataProvider
DataProvider DataProvider

Поставщик данных — это контроллер исходного набора данных, используемый для создания сведений для этого POI. Данные преобразуются и интерпретируются из исходной формы. Каждый поставщик данных предоставляет данные по явной лицензии или соглашению.

OperatorInfo
OperatorInfo OperatorInfo

Оператор является общественной организацией, которая управляет сетью зарядных точек.

UsageType
UsageType UsageType

Тип использования сайта указывает общие ограничения на использование.

ТипСтатуса
StatusType StatusType

Тип состояния сайта или элемента оборудования указывает, является ли он обычно операционным.

SubmissionStatusType
SubmissionStatus SubmissionStatusType

Объект "Состояние отправки" с подробными сведениями о состоянии описания POI.

DataProvider

Поставщик данных — это контроллер исходного набора данных, используемый для создания сведений для этого POI. Данные преобразуются и интерпретируются из исходной формы. Каждый поставщик данных предоставляет данные по явной лицензии или соглашению.

Имя Путь Тип Описание
URL-адрес веб-сайта
WebsiteURL string

URL-адрес веб-сайта для этого поставщика данных

Comments
Comments string

Общие публичные комментарии с информацией об этом поставщике данных.

DataProviderStatusType
DataProviderStatusType DataProviderStatusType

Объект состояния, описывающий, включен ли этот поставщик данных и тип источника (запись вручную, импортированная и т. д.).

Ограничение правки
IsRestrictedEdit boolean

В настоящее время не реализовано. Указывает потенциальное ограничение редактирования.

Лицензия на открытые данные
IsOpenDataLicensed boolean

Если значение true, поставщик данных использует лицензию Open Data

Утвержден импорт
IsApprovedImport boolean

Если значение false, данные не могут быть импортированы для этого поставщика.

Лицензия
License string

Сводка о лицензировании, которое применяется для этого поставщика данных. У каждого поставщика данных есть одна лицензия или соглашение. Использование данных требует принятия данной лицензии.

Дата последнего импорта
DateLastImported date-time

Дата и время (UTC) последний импорт был выполнен для этого поставщика данных (если импорт).

Идентификатор
ID integer

Идентификатор ссылки для этого поставщика данных

Название
Title string

Заголовок этого поставщика данных

OperatorInfo

Оператор является общественной организацией, которая управляет сетью зарядных точек.

Имя Путь Тип Описание
URL-адрес веб-сайта
WebsiteURL string

Веб-сайт для получения дополнительных сведений об этой сети

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 integer

Идентификатор

Название
Title string

Название

UsageType

Тип использования сайта указывает общие ограничения на использование.

Имя Путь Тип Описание
Оплата по месту
IsPayAtLocation boolean

Если значение true, использование требует оплаты в расположении

Требуется членство
IsMembershipRequired boolean

Если задано значение true, этот тип использования требует регистрации или членства в службе.

Требуется ключ доступа
IsAccessKeyRequired boolean

Если используется значение true, требуется физический ключ доступа

Идентификатор
ID integer

Идентификатор.

Название
Title string

Заголовок.

ТипСтатуса

Тип состояния сайта или элемента оборудования указывает, является ли он обычно операционным.

Имя Путь Тип Описание
Работает
IsOperational boolean

Работает ли он.

Доступен ли выбор пользователей
IsUserSelectable boolean

Можно ли выбрать пользователя.

Идентификатор
ID integer

Идентификатор.

Название
Title string

Заголовок.

SubmissionStatusType

Объект "Состояние отправки" с подробными сведениями о состоянии описания POI.

Имя Путь Тип Описание
Идентификатор
ID integer

Справочник по типу состояния отправки

Название
Title string

Заголовок.

Находится в режиме реального времени
IsLive boolean

Если значение true, то список POI находится в режиме реального времени (не черновик или не указан в списке).

Страна

Сведения о стране.

Имя Путь Тип Описание
Идентификатор
ID integer

Схема идентификатора

ISO-код
ISOCode string

Схема кода ISO

Код континента
ContinentCode string

Схема кода континента

Название
Title string

Схема заголовка

AddressInfo

Географическое положение для сведений о компоненте сайта и (ближайшего) адреса.

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор

Адресная строка
AddressLine1 string

Первая линия соседнего уличного адреса

Строка адреса 2
AddressLine2 string

Вторая линия соседнего уличного адреса

Город или город
Town string

Город или город

Штат или провинция
StateOrProvince string

Штат или провинция

Почтовый индекс
Postcode string

Почтовый индекс или zipcode

Идентификатор страны
CountryID integer

Идентификатор ссылки для страны

Страна
Country Country

Сведения о стране.

Широта
Latitude double

Координата широты сайта в десятичных градусах

Долгота
Longitude double

Координата долготы сайта в десятичных градусах

Контактный телефон
ContactTelephone1 string

Основной контактный номер

Контактный телефон 2
ContactTelephone2 string

Дополнительный контактный номер

Контактный адрес электронной почты
ContactEmail string

Основной адрес электронной почты контакта

Примечания доступа
AccessComments string

Руководство по использованию или поиску оборудования для пользователей

Связанный URL-адрес
RelatedURL string

Дополнительные сведения о необязательном веб-сайте

Расстояние
Distance double

Расстояние от расположения поиска, если поиск находится вокруг точки

Ед. изм. расстояния
DistanceUnit integer

Единица, используемая для расстояния, 1= Миль, 2 = KM

Название
Title string

Общее название этого расположения для помощи пользователю

UserComment

Комментарий пользователя или вход для определенной точки зарядки (POI/Site).

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Идентификатор точки оплаты
ChargePointID integer

Идентификатор точки оплаты.

Идентификатор типа комментария
CommentTypeID integer

Идентификатор типа комментария.

UserCommentType
CommentType UserCommentType

Категория для комментария пользователя, например общие комментарии, отчет об ошибке (обратите внимание на пользователей и оператор).

Имя пользователя
UserName string

Имя пользователя.

Комментарий
Comment string

Комментарий.

Связанный URL-адрес
RelatedURL string

Связанный URL-адрес.

Дата создания
DateCreated date-time

Дата создания.

Информация о пользователе
User UserInfo

Краткий общедоступный профиль сводки для конкретного пользователя Open Charge Map.

Проверка идентификатора типа состояния
CheckinStatusTypeID integer

Идентификатор типа состояния для проверки.

CheckinStatusType
CheckinStatusType CheckinStatusType

Классификация для пользователей примечания или взаимодействия с определенным расположением зарядки.

MediaItem

Пользователь отправил элемент мультимедиа, связанный с определенной точкой оплаты или сайтом. В настоящее время всегда изображение.

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Идентификатор точки оплаты
ChargePointID integer

Идентификатор точки оплаты.

URL-адрес элемента
ItemURL string

URL-адрес элемента.

URL-адрес эскиза элемента
ItemThumbnailURL string

URL-адрес эскиза элемента.

Комментарий
Comment string

Комментарий.

Включен
IsEnabled boolean

Включена ли функция.

Видео
IsVideo boolean

Является ли видео.

Элемент", "Избранный"
IsFeaturedItem boolean

Указывает, является ли элемент избранным.

Внешний ресурс
IsExternalResource boolean

Независимо от того, является ли внешний ресурс.

Информация о пользователе
User UserInfo

Краткий общедоступный профиль сводки для конкретного пользователя Open Charge Map.

Дата создания
DateCreated string

Дата создания.

Информация о подключении

Сведения о типе оборудования и возможностях питания.

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Идентификатор типа подключения
ConnectionTypeID integer

Идентификатор типа подключения.

Тип соединения
ConnectionType ConnectionType

Тип подключения конечных пользователей, поддерживаемый EVSE.

Reference
Reference string

Ссылка на необязательные операторы для этого подключения или порта

Идентификатор типа состояния
StatusTypeID integer

Идентификатор ссылки типа состояния. 0 = Неизвестно

ТипСтатуса
StatusType StatusType

Тип состояния сайта или элемента оборудования указывает, является ли он обычно операционным.

Идентификатор уровня
LevelID integer

Общая категория возможностей питания. Устарело в пользу документирования конкретной мощности оборудования в KW.

LevelType
Level LevelType

Общая категория для возможностей питания оборудования. Не рекомендуется использовать для общего использования. В настоящее время вычисляется автоматически на основе мощности оборудования.

Усилители
Amps integer

EVSE предоставляет максимальное текущее время в amps

Напряжение
Voltage double

Напряжение питания EVSE

Power KW
PowerKW double

Пиковая доступность мощности в kW

Идентификатор текущего типа
CurrentTypeID integer

Ссылочный идентификатор типа предложения (например, DC и т. д.)

SupplyType
CurrentType SupplyType

Указывает тип питания EVSE, например DC (Direct Current), AC (один этап), AC (3 этап).

Количество
Quantity integer

Необязательный сводный номер элементов оборудования, доступных в этой спецификации

Comments
Comments string

Комментарии.

Тип соединения

Тип подключения конечных пользователей, поддерживаемый EVSE.

Имя Путь Тип Описание
Официальное имя
FormalName string

Формальное (стандартное) имя для этого типа подключения

Прекращено
IsDiscontinued boolean

Если значение true, это прекращено, но используется тип подключения.

Устарело
IsObsolete boolean

Если значение true, это устаревший тип подключения и вряд ли будет присутствовать в современной инфраструктуре

Идентификатор
ID integer

Идентификатор.

Название
Title string

Заголовок.

LevelType

Общая категория для возможностей питания оборудования. Не рекомендуется использовать для общего использования. В настоящее время вычисляется автоматически на основе мощности оборудования.

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Название
Title string

Заголовок.

Comments
Comments string

Комментарии.

IsFastChargeCapable
IsFastChargeCapable boolean

Если значение true, этот уровень считается "быстрым" зарядом относительно других уровней.

SupplyType

Указывает тип питания EVSE, например DC (Direct Current), AC (один этап), AC (3 этап).

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Название
Title string

Заголовок.

Информация о пользователе

Краткий общедоступный профиль сводки для конкретного пользователя Open Charge Map.

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Имя пользователя
Username string

Имя пользователя.

Точки репутации
ReputationPoints integer

Точки репутации.

URL-адрес изображения профиля
ProfileImageURL string

URL-адрес образа профиля.

CheckinStatusType

Классификация для пользователей примечания или взаимодействия с определенным расположением зарядки.

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Название
Title string

Заголовок.

Автоматический вход
IsAutomatedCheckin boolean

Если значение true, проверка или комментарий предоставлена автоматизированной системой.

Является положительным
IsPositive boolean

Если задано значение true, этот тип проверки или комментария считается положительным.

CoreReferenceData

Набор основных ссылочных данных, используемых для других результатов API и пользовательского интерфейса.

Имя Путь Тип Описание
Типы зарядных устройств
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 array of OperatorInfo

Операторы.

Типы состояний
StatusTypes array of StatusType

Типы состояния.

Типы состояния отправки
SubmissionStatusTypes array of SubmissionStatusType

Типы состояния отправки.

Типы использования
UsageTypes array of UsageType

Типы использования.

Типы комментариев пользователей
UserCommentTypes array of UserCommentType

Типы комментариев пользователя.

UserCommentType

Категория для комментария пользователя, например общие комментарии, отчет об ошибке (обратите внимание на пользователей и оператор).

Имя Путь Тип Описание
Идентификатор
ID integer

Идентификатор.

Название
Title string

Заголовок.

DataProviderStatusType

Объект состояния, описывающий, включен ли этот поставщик данных и тип источника (запись вручную, импортированная и т. д.).

Имя Путь Тип Описание
Включен поставщик
IsProviderEnabled boolean

Если значение false, результаты этого поставщика данных в настоящее время не включены

Идентификатор
ID integer

Идентификатор ссылки для этого типа состояния поставщика

Description
description string

Заголовок этого типа состояния