Compartilhar via


Abrir Mapa de Encargos (Editor Independente) (versão prévia)

O serviço Open Charge Map fornece acesso ao maior registro mundial de locais de carregamento. Você pode integrar esse serviço em seus próprios aplicativos ou serviços e exportar dados de localização de carregamento para seus próprios sistemas.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Metadados do conector
Publicador Troy Taylor
Site https://openchargemap.org/site
Política de privacidade https://openchargemap.org/site/about/terms
Categorias Dados

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API secureString A chave de API para esta api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Obter dados de referência

Retorna os dados de referência principais usados para pesquisar IDs como tipos de conexão, operadores, países etc.

Obter uma lista de POIs

Usado para buscar uma lista de POIs (sites) dentro de um limite geográfico ou perto de uma latitude/longitude específica.

Obter dados de referência

Retorna os dados de referência principais usados para pesquisar IDs como tipos de conexão, operadores, países etc.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do país
countryid array

Filtro opcional no identificador do país, correspondência exata em uma determinada ID de país numérico (lista separada por vírgulas)

Retornos

Conjunto de dados de referência principais usados para outros resultados de API e interface do usuário.

CoreReferenceData
CoreReferenceData

Obter uma lista de POIs

Usado para buscar uma lista de POIs (sites) dentro de um limite geográfico ou perto de uma latitude/longitude específica.

Parâmetros

Nome Chave Obrigatório Tipo Description
Cliente
client string

Cadeia de caracteres para identificar seu aplicativo cliente. Opcional, mas recomendado para distinguir seu cliente de outros bots/rastreadores

Máximo de resultados
maxresults integer

Limite no número máximo de resultados retornados

Código do país
countrycode string

Código de país ISO de 2 caracteres para filtrar para um país específico

ID do país
countryid array

Correspondência exata em uma determinada ID de país numérico (lista separada por vírgulas)

Latitude
latitude double

Latitude para cálculo e filtragem de distância

Longitude
longitude double

Longitude para cálculo e filtragem de distância

Distância
distance double

Opcionalmente, filtre os resultados por uma distância máxima da latitude/longitude fornecida

Unidade de Distância
distanceunit string

miles ou km unidade de distância

Opertator ID
operatorid array

Correspondência exata em uma determinada ID do operador EVSE (lista separada por vírgulas)

ID do tipo de conexão
connectiontypeid array

Correspondência exata em uma determinada ID de tipo de conexão (lista separada por vírgulas)

ID de nível
levelid array

Correspondência exata em uma determinada ID de nível de carregamento (1-3) (lista separada por vírgulas)

ID do tipo de uso
usagetypeid array

Correspondência exata em uma determinada ID de tipo de uso (lista separada por vírgulas)

ID do tipo de status
statustypeid array

Correspondência exata em uma determinada ID de tipo de status (lista separada por vírgulas)

ID do provedor de dados
dataproviderid array

Correspondência exata em uma determinada ID do provedor de dados (lista separada por vírgulas).

Abrir dados
opendata boolean

Use opendata=true somente para dados fornecidos pelo OCM ("Open").

Incluir Comentários
includecomments boolean

Se for true, os comentários do usuário e os itens de mídia serão incluídos no conjunto de resultados

Detalhado
verbose boolean

Defina como false para obter um conjunto de resultados menor com itens nulos removidos.

Compacto
compact boolean

Defina como true para remover objetos de dados de referência da saída (apenas retorna IDs para dados de referência comuns, como DataProvider etc.

Camelcase
camelcase boolean

Defina como true para obter nomes de propriedade no formato camelCase.

ID do ponto de carga
chargepointid string

Correspondência exata em uma determinada ID de POI do OCM (lista separada por vírgulas)

Caixa delimitadora
boundingbox array

Filtrar os resultados para uma determinada caixa delimitadora. especifique cantos superiores esquerdos e inferiores da caixa direita como: (lat,lng),(lat2,lng2)

Polygon
polygon string

Filtrar os resultados em um determinado Polígono. Especifique uma polilinha codificada para a forma de polígono. O polígono será fechado automaticamente do último ponto para o primeiro ponto.

Polilinha
polyline string

Filtre os resultados ao longo de uma polilinha codificada, use com o parâmetro de distância para aumentar a distância de pesquisa ao longo da linha. A polilinha é expandida para um polígono para cobrir a distância de pesquisa.

Retornos

response
array of POI

Definições

POI

Uma POI (Ponto de Interesse), também conhecida como a Site ou ChargePoint, é o conjunto de informações de nível superior sobre um local geográfico com um ou mais equipamentos de carregamento de veículos elétricos presentes.

Nome Caminho Tipo Description
ID
ID integer

A ID de referência do OCM para essa POI (Ponto de Interesse).

Identificador Único Universal (UUID)
UUID uuid

Um identificador universalmente exclusivo usado como chave substituta. A ID e a UUID devem ser preservadas ao enviar informações de atualização de POI.

Comentários do usuário
UserComments array of UserComment

Uma lista de comentários do usuário ou check-ins para este site

Itens de Mídia
MediaItems array of MediaItem

Uma lista de fotos enviadas pelo usuário para este site

Foi verificado recentemente
IsRecentlyVerified boolean

Um valor computado dinamicamente indicando que qualquer atividade de confirmação recente ocorreu para este site (check-ins positivos etc)

Data Da Última Verificação
DateLastVerified date-time

Um valor computado dinamicamente, a data e hora (UTC, ISO 8601) essa POI foi confirmada pela última vez por um comentário de usuário ou edição de usuário relacionado

ID do ponto de encargo pai
ParentChargePointID string

Se estiverem presentes, esses dados nessa POI substituirão as informações em outra POI. Geralmente não é relevante para os consumidores.

ID do provedor de dados
DataProviderID integer

A ID de referência para o provedor de dados dessa POI

Referência do provedor de dados
DataProvidersReference string

Se estiver presente, essa é a própria chave dos Provedores de Dados para essa POI em seu conjunto de dados de origem

ID do operador
OperatorID integer

A ID de referência do operador ou proprietário da rede de equipamentos

Referência de operadores
OperatorsReference string

A própria referência dos operadores de rede para este site (pode ser uma referência de site ou uma única referência de equipamento)

ID do tipo de uso
UsageTypeID integer

A ID de referência para o tipo de uso do site, 0 == Desconhecido

Custo de Utilização
UsageCost string

Descrição de texto gratuito dos custos de uso prováveis associados a este site. Geralmente está relacionado a encargos de estacionamento se a rede opera este site como Gratuito

AddressInfo
AddressInfo AddressInfo

A posição geográfica para informações do componente de endereço do site e (mais próximo).

Conexões
Connections array of ConnectionInfo

Lista de informações de resumo de equipamentos para este site

Número de pontos
NumberOfPoints integer

O número de baias ou estações discretas disponíveis no geral neste site. Isso indica a limitação do número de usuários simultâneos do site.

Comentários Gerais
GeneralComments string

Informações factuais adicionais gerais para a POI. Os usuários são desencorajados a usar esse campo para obter opiniões sobre a qualidade do site etc.

Data planejada
DatePlanned date-time

A data e hora (UTC, ISO 8601) essa POI é ou foi planejada para comissionamento. Em geral, as POIs planejadas não devem ser apresentadas aos usuários finais até que a operação seja confirmada.

Data confirmada pela última vez
DateLastConfirmed date-time

A data e hora (UTC, ISO 8601) dessa POI foi confirmada pela última vez de acordo com o provedor de dados ou um usuário. Consulte DateLastVerified para obter uma data computada dinamicamente com base em vários sinais.

ID do tipo de status
StatusTypeID integer

A ID de referência geral do tipo de status operacional para essa POI (ou seja, operacional etc). 0 == Desconhecido

Atualização do último status da data
DateLastStatusUpdate date-time

A data e hora (UTC, ISO 8601) dessa POI ou propriedades filho diretamente relacionadas foram atualizadas.

Valores de metadados
MetadataValues array of

Matriz opcional de valores de metadados. Geralmente usado para indicar a atribuição de dados, mas também destina-se a uso futuro para indicar amenties, links ou valores de chave estrangeira em outros conjuntos de dados.

Nível de qualidade de dados
DataQualityLevel integer

Uma métrica aplicada durante as importações para indicar um nível de qualidade com base nos detalhes de informações disponíveis (5 == melhor). Em grande parte não utilizado no momento.

Data criada
DateCreated date-time

A data e hora (UTC, ISO 8601) que essa POI foi adicionada ao banco de dados open charge map

ID do tipo de status de envio
SubmissionStatusTypeID integer

A ID de referência para o tipo de status de envio aplicado a essa POI.

DataProvider
DataProvider DataProvider

Um Provedor de Dados é o controlador do conjunto de dados de origem usado para construir os detalhes dessa POI. Os dados foram transformados e interpretados do formulário original. Cada Provedor de Dados fornece dados por uma licença ou contrato explícito.

OperatorInfo
OperatorInfo OperatorInfo

Um Operador é a organização pública que controla uma rede de pontos de carregamento.

UsageType
UsageType UsageType

O tipo de uso de um site indica as restrições gerais de uso.

TipoDeStatus
StatusType StatusType

O tipo de status de um item de site ou de equipamento indica se ele está em operação geral.

SubmissionStatusType
SubmissionStatus SubmissionStatusType

Objeto Status de Envio, detalhando o status de listagem de POI.

DataProvider

Um Provedor de Dados é o controlador do conjunto de dados de origem usado para construir os detalhes dessa POI. Os dados foram transformados e interpretados do formulário original. Cada Provedor de Dados fornece dados por uma licença ou contrato explícito.

Nome Caminho Tipo Description
URL do site
WebsiteURL string

URL do site para esse provedor de dados

Comments
Comments string

Comentários públicos gerais com informações sobre esse Provedor de Dados.

DataProviderStatusType
DataProviderStatusType DataProviderStatusType

Objeto status que descreve se esse provedor de dados está habilitado no momento e o tipo de origem (entrada manual, importada etc).

É Editar Restrito
IsRestrictedEdit boolean

Atualmente não implementado. Indica uma possível restrição de edição.

É licenciado por dados abertos
IsOpenDataLicensed boolean

Se for true, o provedor de dados usará uma licença open data

Importação aprovada
IsApprovedImport boolean

Se for falso, os dados podem não ser importados para esse provedor.

Licença
License string

Resumo do licenciamento que se aplica a esse Provedor de Dados. Cada Provedor de Dados tem uma licença ou contrato específico. O uso dos dados requer a aceitação da licença fornecida.

Data Da Última Importação
DateLastImported date-time

Data e hora (UTC) a última importação foi executada para esse provedor de dados (se uma importação).

ID
ID integer

A ID de referência para este provedor de dados

Title
Title string

O título deste Provedor de Dados

OperatorInfo

Um Operador é a organização pública que controla uma rede de pontos de carregamento.

Nome Caminho Tipo Description
URL do site
WebsiteURL string

Site para obter mais informações sobre essa rede

Comments
Comments string
Telefone de contato primário
PhonePrimaryContact string

Número de contato primário para usuários de rede

Telefone de contato secundário
PhoneSecondaryContact string

Número de contato secundário

É Particular Individual
IsPrivateIndividual boolean

Se verdadeiro, esse operador representa um indivíduo privado

AddressInfo
AddressInfo AddressInfo

A posição geográfica para informações do componente de endereço do site e (mais próximo).

URL de reserva
BookingURL string

A URL da reserva.

Email de contato
ContactEmail string

O endereço de email de contato.

Email do Relatório de Falhas
FaultReportEmail string

Usado para enviar uma notificação automatizada ao operador de rede se um usuário enviar um comentário/check-in de relatório de falha

É Editar Restrito
IsRestrictedEdit boolean

Se for true, essa rede restringirá as edições da comunidade para dados do OCM

ID
ID integer

ID

Title
Title string

Title

UsageType

O tipo de uso de um site indica as restrições gerais de uso.

Nome Caminho Tipo Description
É pago no local
IsPayAtLocation boolean

Se verdadeiro, o uso requer pagamento no local

A associação é necessária
IsMembershipRequired boolean

Se for true, esse tipo de uso requer registro ou associação a um serviço.

É necessária a chave de acesso
IsAccessKeyRequired boolean

Se verdadeiro, esse uso exigiu uma chave de acesso físico

ID
ID integer

O identificador.

Title
Title string

O título.

TipoDeStatus

O tipo de status de um item de site ou de equipamento indica se ele está em operação geral.

Nome Caminho Tipo Description
Está operacional
IsOperational boolean

Se está operacional.

É selecionável pelo usuário
IsUserSelectable boolean

Se o usuário pode ser selecionado.

ID
ID integer

O identificador.

Title
Title string

O título.

SubmissionStatusType

Objeto Status de Envio, detalhando o status de listagem de POI.

Nome Caminho Tipo Description
ID
ID integer

ID de referência do tipo de status de envio

Title
Title string

O título.

Está ao vivo
IsLive boolean

Se for true, a listagem de POI estará ativa (não é rascunho ou desnudada)

País

Os detalhes do país.

Nome Caminho Tipo Description
ID
ID integer

O esquema de ID

Código ISO
ISOCode string

O esquema de código ISO

Código do continente
ContinentCode string

O esquema de código do continente

Title
Title string

O esquema de título

AddressInfo

A posição geográfica para informações do componente de endereço do site e (mais próximo).

Nome Caminho Tipo Description
ID
ID integer

ID

Linha de Endereço
AddressLine1 string

Primeira linha de endereço de rua próximo

Linha de endereço 2
AddressLine2 string

Segunda linha de endereço de rua próximo

Cidade ou Cidade
Town string

Cidade ou Cidade

Estado
StateOrProvince string

Estado

Cp
Postcode string

Cep ou Cep

ID do país
CountryID integer

A ID de referência para o país

País
Country Country

Os detalhes do país.

Latitude
Latitude double

Coordenada de latitude do site em graus decimais

Longitude
Longitude double

Coordenada de longitude do site em graus decimais

Telefone de Contato
ContactTelephone1 string

Número de contato primário

Telefone de Contato 2
ContactTelephone2 string

Número de contato secundário

Email de contato
ContactEmail string

Email de contato primário

Comentários do Access
AccessComments string

Diretrizes para os usuários usarem ou localizarem o equipamento

URL relacionada
RelatedURL string

Site opcional para obter mais informações

Distância
Distance double

Distância do local da pesquisa, se a pesquisa estiver em torno de um ponto

Unidade de Distância
DistanceUnit integer

Unidade usada para distância, 1= Milhas, 2 = KM

Title
Title string

Título geral para este local para ajudar o usuário

UserComment

Um comentário do usuário ou check-in para um ponto de carregamento específico (POI/Site).

Nome Caminho Tipo Description
ID
ID integer

O identificador.

ID do ponto de carga
ChargePointID integer

O identificador do ponto de carga.

ID do tipo de comentário
CommentTypeID integer

O identificador de tipo de comentário.

UserCommentType
CommentType UserCommentType

Categoria para um comentário do usuário, por exemplo, Comentário Geral, Relatório de Falhas (Aviso aos usuários e operador).

Nome de usuário
UserName string

O nome de usuário.

Comment
Comment string

O comentário.

URL relacionada
RelatedURL string

O endereço de URL relacionado.

Data criada
DateCreated date-time

A data criada.

Informações do usuário
User UserInfo

O breve perfil de resumo público de um usuário específico do Open Charge Map.

ID do tipo de status check-in
CheckinStatusTypeID integer

O identificador de tipo de status de check-in.

CheckinStatusType
CheckinStatusType CheckinStatusType

Classificação para o comentário ou experiência dos usuários usando um local de carregamento específico.

MediaItem

Um item de mídia enviado pelo usuário relacionado a um ponto de cobrança ou site específico. Atualmente sempre uma imagem.

Nome Caminho Tipo Description
ID
ID integer

O identificador.

ID do ponto de carga
ChargePointID integer

O identificador do ponto de carga.

Item URL
ItemURL string

O endereço da URL do item.

URL da Miniatura do Item
ItemThumbnailURL string

O endereço de URL da miniatura do item.

Comment
Comment string

O comentário.

Está habilitado
IsEnabled boolean

Se está habilitado.

É Vídeo
IsVideo boolean

Se é vídeo.

É item em destaque
IsFeaturedItem boolean

Se é um item em destaque.

É recurso externo
IsExternalResource boolean

Se é um recurso externo.

Informações do usuário
User UserInfo

O breve perfil de resumo público de um usuário específico do Open Charge Map.

Data criada
DateCreated string

A data criada.

Informações de conexão

Detalhes sobre o tipo de equipamento e a capacidade de energia.

Nome Caminho Tipo Description
ID
ID integer

O identificador.

ID do tipo de conexão
ConnectionTypeID integer

O identificador de tipo de conexão.

Tipo de Conexão
ConnectionType ConnectionType

O tipo de conexão de usuário final que um EVSE dá suporte.

Referência
Reference string

Referência de operadores opcionais para essa conexão/porta

ID do tipo de status
StatusTypeID integer

ID de referência do tipo de status. 0 = Desconhecido

TipoDeStatus
StatusType StatusType

O tipo de status de um item de site ou de equipamento indica se ele está em operação geral.

ID de nível
LevelID integer

Uma categoria geral para capacidade de energia. Preterido em favor da documentação de energia de equipamentos específicos em kW.

LevelType
Level LevelType

Uma categoria geral para a capacidade de energia do equipamento. Preterido para uso geral. Atualmente computado automaticamente com base na potência do equipamento.

Ampères
Amps integer

Fornecimento de EVSE máximo atual em amps

Voltagem
Voltage double

Tensão de fornecimento de EVSE

Power KW
PowerKW double

Pico de energia disponível em kW

ID do tipo atual
CurrentTypeID integer

A ID de referência do tipo de fornecimento (por exemplo, DC etc)

SupplyType
CurrentType SupplyType

Indica o tipo de fonte de alimentação EVSE, por exemplo, DC (Corrente Direta), AC (Fase Única), AC (3 Fase).

Quantidade
Quantity integer

Número de resumo opcional de itens de equipamento disponíveis com esta especificação

Comments
Comments string

Os comentários.

Tipo de Conexão

O tipo de conexão de usuário final que um EVSE dá suporte.

Nome Caminho Tipo Description
Nome Formal
FormalName string

Nome formal (padrão) para esse tipo de conexão

É descontinuado
IsDiscontinued boolean

Se verdadeiro, esse é um tipo de conexão descontinuado, mas usado

Está Obsoleto
IsObsolete boolean

Se for verdade, esse é um tipo de conexão obsoleto e é improvável que a parte superior esteja presente na infraestrutura moderna

ID
ID integer

O identificador.

Title
Title string

O título.

LevelType

Uma categoria geral para a capacidade de energia do equipamento. Preterido para uso geral. Atualmente computado automaticamente com base na potência do equipamento.

Nome Caminho Tipo Description
ID
ID integer

O identificador.

Title
Title string

O título.

Comments
Comments string

Os comentários.

IsFastChargeCapable
IsFastChargeCapable boolean

Se for true, esse nível será considerado uma cobrança 'rápida', em relação a outros níveis.

SupplyType

Indica o tipo de fonte de alimentação EVSE, por exemplo, DC (Corrente Direta), AC (Fase Única), AC (3 Fase).

Nome Caminho Tipo Description
ID
ID integer

O identificador.

Title
Title string

O título.

Informações do usuário

O breve perfil de resumo público de um usuário específico do Open Charge Map.

Nome Caminho Tipo Description
ID
ID integer

O identificador.

Nome de usuário
Username string

O nome de usuário.

Pontos de reputação
ReputationPoints integer

Os pontos de reputação.

URL da Imagem de Perfil
ProfileImageURL string

O endereço da URL da imagem do perfil.

CheckinStatusType

Classificação para o comentário ou experiência dos usuários usando um local de carregamento específico.

Nome Caminho Tipo Description
ID
ID integer

O identificador.

Title
Title string

O título.

O check-in é automatizado
IsAutomatedCheckin boolean

Se for true, o check-in ou o comentário foi fornecido por um sistema automatizado.

É Positivo
IsPositive boolean

Se verdadeiro, esse tipo de check-in/comentário é considerado positivo.

CoreReferenceData

Conjunto de dados de referência principais usados para outros resultados de API e interface do usuário.

Nome Caminho Tipo Description
Tipos de carregador
ChargerTypes array of LevelType

Os tipos de carregador.

Tipos de conexão
ConnectionTypes array of ConnectionType

Os tipos de conexão.

Tipos de status de check-in
CheckinStatusTypes array of CheckinStatusType

Os tipos de status de check-in.

Países/Regiões
Countries array of Country

Os países.

Tipos atuais
CurrentTypes array of SupplyType

Os tipos atuais.

Provedores de dados
DataProviders array of DataProvider

Os provedores de dados.

Operadores
Operators array of OperatorInfo

Os operadores.

Tipos de status
StatusTypes array of StatusType

Os tipos de status.

Tipos de status de envio
SubmissionStatusTypes array of SubmissionStatusType

Os tipos de status de envio.

Tipos de uso
UsageTypes array of UsageType

Os tipos de uso.

Tipos de comentário do usuário
UserCommentTypes array of UserCommentType

Os tipos de comentário do usuário.

UserCommentType

Categoria para um comentário do usuário, por exemplo, Comentário Geral, Relatório de Falhas (Aviso aos usuários e operador).

Nome Caminho Tipo Description
ID
ID integer

O identificador.

Title
Title string

O título.

DataProviderStatusType

Objeto status que descreve se esse provedor de dados está habilitado no momento e o tipo de origem (entrada manual, importada etc).

Nome Caminho Tipo Description
O provedor está habilitado
IsProviderEnabled boolean

Se for falso, os resultados desse provedor de dados não estão habilitados no momento

ID
ID integer

A ID de referência para esse tipo de status de provedor

Description
description string

O título desse tipo de status