Partilhar via


Open Charge Map (Editora Independente) (Pré-visualização)

O serviço Open Charge Map fornece acesso ao maior registo de locais de carregamento do mundo. Pode integrar este serviço nas suas próprias aplicações ou serviços e exportar dados de localização de carregamento para os seus próprios sistemas.

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

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Troia Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Metadados do conector
Editora Troia Taylor
Sítio Web https://openchargemap.org/site
Política de privacidade https://openchargemap.org/site/about/terms
Categorias Data

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Obtenha uma lista de POIs

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

Obter dados de referência

Devolve os principais dados de referência utilizados para procurar IDs, tais como Tipos de Ligação, Operadores, Países, etc.

Obtenha uma lista de POIs

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

Parâmetros

Name Chave Necessário Tipo Description
Client
client string

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

Resultados Máximos
maxresults integer

Limite do número máximo de resultados retornados

Código do país
countrycode string

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

ID do país
countryid array

Correspondência exata em um determinado ID de país numérico (lista separada por vírgula)

Latitude
latitude double

Latitude para cálculo de distância e filtragem

Longitude
longitude double

Longitude para cálculo de distância e filtragem

Distância
distance double

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

Unidade de Distância
distanceunit string

miles ou km unidade de distância

Opertator ID
operatorid array

Correspondência exata em um determinado ID de operador EVSE (lista separada por vírgula)

ID do tipo de conexão
connectiontypeid array

Correspondência exata em um determinado ID de tipo de conexão (lista separada por vírgula)

ID de nível
levelid array

Correspondência exata num determinado nível de carregamento (1-3) id (lista separada por vírgula)

ID do tipo de uso
usagetypeid array

Correspondência exata em um determinado id de tipo de uso (lista separada por vírgula)

ID do tipo de status
statustypeid array

Correspondência exata em um determinado id de tipo de status (lista separada por vírgula)

ID do Provedor de Dados
dataproviderid array

Correspondência exata em um determinado ID do provedor de dados (lista separada por vírgula).

Dados abertos
opendata boolean

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

Incluir comentários
includecomments boolean

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

Verbose
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 propriedades no formato camelCase.

ID do ponto de carga
chargepointid string

Correspondência exata em um determinado ID OCM POI (lista separada por vírgula)

Caixa delimitadora
boundingbox array

Filtre os resultados para uma determinada caixa delimitadora. Especifique os cantos superiores esquerdo e inferior direito da caixa como: (lat,lng),(lat2,lng2)

Polygon
polygon string

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

Polilina
polyline string

Filtre os resultados ao longo de uma polilinha codificada, use com distância param para aumentar a distância de pesquisa ao longo da linha. Polyline é expandido em um polígono para cobrir a distância de pesquisa.

Devoluções

response
array of POI

Obter dados de referência

Devolve os principais dados de referência utilizados para procurar IDs, tais como Tipos de Ligação, Operadores, Países, etc.

Parâmetros

Name Chave Necessário Tipo Description
ID do país
countryid array

Filtro opcional no identificador do país, correspondência exata num determinado ID numérico do país (lista separada por vírgula)

Devoluções

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

CoreReferenceData
CoreReferenceData

Definições

POI

Um POI (Ponto de Interesse), também referido como um 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.

Name Caminho Tipo Description
ID
ID integer

O ID de referência OCM para este POI (Ponto de Interesse).

Identificador Único Universal (UUID)
UUID uuid

Um identificador universalmente único usado como chave substituta. ID e UUID devem ser preservados ao enviar informações de atualização de POI.

Comentários de usuários
UserComments array of UserComment

Uma lista de comentários de usuários 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 calculado dinamicamente indicando que qualquer atividade de confirmação recente tenha ocorrido para este site (check-ins positivos, etc.)

Data da última verificação
DateLastVerified date-time

Um valor calculado dinamicamente, a data e hora (UTC, ISO 8601) este POI foi confirmado pela última vez por uma edição do usuário ou comentário do usuário relacionado

ID do ponto de carga pai
ParentChargePointID string

Se estiverem presentes, estes dados neste POI substituem a informação de outro POI. Geralmente não relevante para os consumidores.

ID do Provedor de Dados
DataProviderID integer

O ID de referência para o Provedor de Dados desta POI

Referência do provedor de dados
DataProvidersReference string

Se presente, esta é a chave própria dos Provedores de Dados para esse POI dentro de seu conjunto de dados de origem

ID do operador
OperatorID integer

O ID de referência do operador ou proprietário da rede do equipamento

Referência dos 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

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

Custo de Utilização
UsageCost string

Descrição em texto livre dos prováveis custos de utilização associados a este site. Geralmente se relaciona com as taxas de estacionamento se a rede opera este site como Livre

EndereçoInfo
AddressInfo AddressInfo

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

Connections
Connections array of ConnectionInfo

Lista de informações resumidas sobre o equipamento para este sítio

Número de Pontos
NumberOfPoints integer

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

Observações na generalidade
GeneralComments string

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

Data prevista
DatePlanned date-time

A data e hora (UTC, ISO 8601) deste POI é ou foi planejado para comissionamento. Em geral, as POIs planeadas não devem ser apresentadas aos utilizadores finais até que se confirme a sua operacionalidade.

Data da última confirmação
DateLastConfirmed date-time

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

ID do tipo de status
StatusTypeID integer

O ID de referência do tipo de estado operacional global para este POI (ou seja, Operacional, etc.). 0 == Desconhecido

Data da última atualização de status
DateLastStatusUpdate date-time

A data e a hora (UTC, ISO 8601) deste POI ou propriedades filhas 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 se destina a uso futuro para indicar comodidades circundantes, links ou valores de chave estrangeira em outros conjuntos de dados.

Nível de qualidade dos dados
DataQualityLevel integer

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

Data de Criação
DateCreated date-time

A data e hora (UTC, ISO 8601) deste POI foi adicionado à base de dados Open Charge Map

ID do tipo de status de envio
SubmissionStatusTypeID integer

O ID de referência para o tipo de status de envio que se aplicou a este POI.

Provedor de dados
DataProvider DataProvider

Um Provedor de Dados é o controlador do conjunto de dados de origem usado para construir os detalhes para este POI. Os dados foram transformados e interpretados a partir da sua forma original. Cada Provedor de Dados fornece dados por meio de uma licença ou contrato explícito.

OperatorInfo
OperatorInfo OperatorInfo

Um operador é o organismo público que controla uma rede de pontos de carregamento.

Tipo de uso
UsageType UsageType

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

Tipo de Estado
StatusType StatusType

O tipo de status de um local ou item de equipamento indica se ele está geralmente operacional.

SubmissionStatusType
SubmissionStatus SubmissionStatusType

Objeto Status de envio, detalhando o status da listagem de POI.

Provedor de dados

Um Provedor de Dados é o controlador do conjunto de dados de origem usado para construir os detalhes para este POI. Os dados foram transformados e interpretados a partir da sua forma original. Cada Provedor de Dados fornece dados por meio de uma licença ou contrato explícito.

Name Caminho Tipo Description
URL do site
WebsiteURL string

URL do site para este provedor de dados

Comments
Comments string

Comentários do público em geral com informações sobre este Provedor de Dados.

DataProviderStatusType
DataProviderStatusType DataProviderStatusType

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

A edição é restrita
IsRestrictedEdit boolean

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

Os dados abertos são licenciados
IsOpenDataLicensed boolean

Se verdadeiro, o provedor de dados usa uma licença de Dados Abertos

É Importação Aprovada
IsApprovedImport boolean

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

Licença
License string

Resumo do licenciamento aplicável a este Fornecedor de Dados. Cada Provedor de Dados tem uma licença ou contrato específico. A utilização dos dados requer a aceitação da licença dada.

Data da última importação
DateLastImported date-time

Data e hora (UTC) a última importação foi realizada para este 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 é o organismo público que controla uma rede de pontos de carregamento.

Name Caminho Tipo Description
URL do site
WebsiteURL string

Sítio Web para mais informações sobre esta rede

Comments
Comments string
Telefone de contato principal
PhonePrimaryContact string

Número de contacto principal para utilizadores da rede

Telefone de contato secundário
PhoneSecondaryContact string

Número de contacto secundário

É Pessoa Física
IsPrivateIndividual boolean

Se for verdade, este operador representa um particular

EndereçoInfo
AddressInfo AddressInfo

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

URL da reserva
BookingURL string

O URL da reserva.

E-mail de contato
ContactEmail string

O endereço de e-mail de contato.

E-mail de relatório de falhas
FaultReportEmail string

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

A edição é restrita
IsRestrictedEdit boolean

Se verdadeiro, essa rede restringe as edições da comunidade para dados OCM

ID
ID integer

Id

Title
Title string

Title

Tipo de uso

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

Name Caminho Tipo Description
É pago no local
IsPayAtLocation boolean

Se for verdade, o uso requer pagamento no local

É Necessário Ser Membro
IsMembershipRequired boolean

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

A chave de acesso é necessária
IsAccessKeyRequired boolean

Se verdadeiro, esse uso exigia uma chave de acesso física

ID
ID integer

O identificador.

Title
Title string

O título.

Tipo de Estado

O tipo de status de um local ou item de equipamento indica se ele está geralmente operacional.

Name Caminho Tipo Description
Está operacional
IsOperational boolean

Se está operacional.

É selecionável pelo usuário
IsUserSelectable boolean

Se é selecionável pelo usuário.

ID
ID integer

O identificador.

Title
Title string

O título.

SubmissionStatusType

Objeto Status de envio, detalhando o status da listagem de POI.

Name Caminho Tipo Description
ID
ID integer

ID de referência do tipo de status de envio

Title
Title string

O título.

É ao vivo
IsLive boolean

Se verdadeiro, a listagem de POI está ativa (não rascunho ou retirada da lista)

Country

Os detalhes do país.

Name Caminho Tipo Description
ID
ID integer

O esquema de id

Código ISO
ISOCode string

O esquema do código ISO

Código do Continente
ContinentCode string

O esquema do código Continente

Title
Title string

O esquema de título

EndereçoInfo

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

Name Caminho Tipo Description
ID
ID integer

ID

Linha de endereço
AddressLine1 string

Primeira linha de endereço nas proximidades

Endereço Linha 2
AddressLine2 string

Segunda linha de endereço nas proximidades

Cidade
Town string

Cidade

Estado ou Província
StateOrProvince string

Estado ou Província

Código postal
Postcode string

Código postal ou código postal

ID do país
CountryID integer

O ID de referência do país

Country
Country Country

Os detalhes do país.

Latitude
Latitude double

Coordenadas de latitude do local em graus decimais

Longitude
Longitude double

Coordenadas de longitude do local em graus decimais

Telefone de Contacto
ContactTelephone1 string

Número de contacto principal

Telefone de Contacto 2
ContactTelephone2 string

Número de contacto secundário

E-mail de contato
ContactEmail string

E-mail de contato principal

Aceder aos comentários
AccessComments string

Orientações para os utilizadores utilizarem ou encontrarem o equipamento

URL relacionada
RelatedURL string

Site opcional para mais informações

Distância
Distance double

Distância do local de 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

Comentário do usuário

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

Name 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 utilizador
UserName string

O nome de usuário.

Comment
Comment string

O comentário.

URL relacionada
RelatedURL string

O endereço URL relacionado.

Data de Criação
DateCreated date-time

A data criada.

Informações do usuário
User UserInfo

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

ID do tipo de status de 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 carga ou site específico. Atualmente sempre uma imagem.

Name 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 URL do item.

URL da miniatura do item
ItemThumbnailURL string

O endereço URL da miniatura do item.

Comment
Comment string

O comentário.

Está ativado
IsEnabled boolean

Se está habilitado.

É vídeo
IsVideo boolean

Se é vídeo.

É item em destaque
IsFeaturedItem boolean

Se é item em destaque.

É recurso externo
IsExternalResource boolean

Se é recurso externo.

Informações do usuário
User UserInfo

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

Data de Criação
DateCreated string

A data criada.

ConnectionInfo

Detalhes sobre o tipo de equipamento e capacidade de potência.

Name 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 suportado por um EVSE.

Reference
Reference string

Referência de operadores opcionais para esta ligação/porta

ID do tipo de status
StatusTypeID integer

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

Tipo de Estado
StatusType StatusType

O tipo de status de um local ou item de equipamento indica se ele está geralmente operacional.

ID de nível
LevelID integer

Uma categoria geral para a capacidade de potência. Preterido em favor da documentação da potência específica do equipamento em kW.

Tipo de Nível
Level LevelType

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

Amplificadores
Amps integer

Corrente máxima de fornecimento EVSE em Amperes

Tensão
Voltage double

Tensão de alimentação EVSE

Potência KW
PowerKW double

Potência máxima disponível em kW

ID do tipo atual
CurrentTypeID integer

O ID de referência do tipo de alimentação (por exemplo, CC, etc.)

Tipo de Fornecimento
CurrentType SupplyType

Indica o tipo de fonte de alimentação EVSE, por exemplo, CC (corrente contínua), CA (monofásica), CA (3 fases).

Quantidade
Quantity integer

Número 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 suportado por um EVSE.

Name Caminho Tipo Description
Nome formal
FormalName string

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

É descontinuado
IsDiscontinued boolean

Se verdadeiro, este é um tipo de conexão descontinuada, mas usada

está obsoleta
IsObsolete boolean

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

ID
ID integer

O identificador.

Title
Title string

O título.

Tipo de Nível

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

Name 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 verdade, este nível é considerado carregamento 'rápido', em relação a outros níveis.

Tipo de Fornecimento

Indica o tipo de fonte de alimentação EVSE, por exemplo, CC (corrente contínua), CA (monofásica), CA (3 fases).

Name 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 para um usuário específico do Open Charge Map.

Name Caminho Tipo Description
ID
ID integer

O identificador.

Nome de utilizador
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 URL da imagem de perfil.

CheckinStatusType

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

Name Caminho Tipo Description
ID
ID integer

O identificador.

Title
Title string

O título.

O check-in é automatizado
IsAutomatedCheckin boolean

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

É positivo
IsPositive boolean

Se verdadeiro, este 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.

Name 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
Countries array of Country

Os países.

Tipos atuais
CurrentTypes array of SupplyType

Os tipos atuais.

Fornecedores de Dados
DataProviders array of DataProvider

Os fornecedores 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ários 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).

Name Caminho Tipo Description
ID
ID integer

O identificador.

Title
Title string

O título.

DataProviderStatusType

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

Name Caminho Tipo Description
O provedor está habilitado
IsProviderEnabled boolean

Se false, os resultados deste 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 deste tipo de status