Compartir a través de


Mapa de cargo abierto (publicador independiente) (versión preliminar)

El servicio Open Charge Map proporciona acceso al registro más grande del mundo de ubicaciones de carga. Puede integrar este servicio en sus propias aplicaciones o servicios y exportar datos de ubicación de carga en sus propios sistemas.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Troy Taylor
URL https://www.hitachisolutions.com
Correo Electrónico ttaylor@hitachisolutions.com
Metadatos del conector
Publicador Troy Taylor
Sitio web https://openchargemap.org/site
Directiva de privacidad https://openchargemap.org/site/about/terms
Categorías Data

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API securestring La clave de API de esta API Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Obtención de datos de referencia

Devuelve los datos de referencia principales usados para buscar identificadores como tipos de conexión, operadores, países, etc.

Obtener una lista de las POIs

Se usa para capturar una lista de pois (sitios) dentro de un límite geográfico o cerca de una latitud o longitud específica.

Obtención de datos de referencia

Devuelve los datos de referencia principales usados para buscar identificadores como tipos de conexión, operadores, países, etc.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de país
countryid array

Filtro opcional en el identificador de país, coincidencia exacta en un identificador numérico determinado (lista separada por comas)

Devoluciones

Conjunto de datos de referencia principales usados para otros resultados de api y interfaz de usuario.

CoreReferenceData
CoreReferenceData

Obtener una lista de las POIs

Se usa para capturar una lista de pois (sitios) dentro de un límite geográfico o cerca de una latitud o longitud específica.

Parámetros

Nombre Clave Requerido Tipo Description
Client
client string

Cadena para identificar la aplicación cliente. Opcional, pero recomendado para distinguir el cliente de otros bots o rastreadores

Resultados máximos
maxresults integer

Límite en el número máximo de resultados devueltos

Código de país
countrycode string

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

Id. de país
countryid array

Coincidencia exacta en un identificador de país numérico determinado (lista separada por comas)

Latitud
latitude double

Latitud para el cálculo y el filtrado de distancia

Longitud
longitude double

Longitud para el cálculo y el filtrado de distancia

Distancia
distance double

Opcionalmente, filtre los resultados por una distancia máxima desde la latitud y longitud especificadas.

Unidad de distancia
distanceunit string

miles o km unidad de distancia

Id. de opertator
operatorid array

Coincidencia exacta en un identificador de operador EVSE determinado (lista separada por comas)

Identificador de tipo de conexión
connectiontypeid array

Coincidencia exacta en un identificador de tipo de conexión determinado (lista separada por comas)

Id. de nivel
levelid array

Coincidencia exacta en un nivel de carga determinado (1-3) identificador (lista separada por comas)

Id. de tipo de uso
usagetypeid array

Coincidencia exacta en un identificador de tipo de uso determinado (lista separada por comas)

Id. de tipo de estado
statustypeid array

Coincidencia exacta en un identificador de tipo de estado determinado (lista separada por comas)

Identificador del proveedor de datos
dataproviderid array

Coincidencia exacta en un identificador de proveedor de datos determinado (lista separada por comas).

Abrir datos
opendata boolean

Use opendata=true solo para los datos proporcionados por OCM ("Abrir").

Incluir comentarios
includecomments boolean

Si es true, los comentarios del usuario y los elementos multimedia se incluirán en el conjunto de resultados.

Detallado
verbose boolean

Establézcalo en false para obtener un conjunto de resultados más pequeño con elementos NULL quitados.

Compacto
compact boolean

Establézcalo en true para quitar objetos de datos de referencia de la salida (solo devuelve identificadores para datos de referencia comunes, como DataProvider, etc.).

Camelcase
camelcase boolean

Establézcalo en true para obtener un nombre de propiedad en formato camelCase.

Id. de punto de carga
chargepointid string

Coincidencia exacta en un identificador de POI de OCM determinado (lista separada por comas)

Rectángulo de selección
boundingbox array

Filtre los resultados en un cuadro de límite determinado. especifique las esquinas del cuadro superior izquierdo e inferior derecho como: (lat,lng),(lat2,lng2)

Polygon
polygon string

Filtre los resultados dentro de un polígono determinado. Especifique una polilínea codificada para la forma de polígono. El polígono se cerrará automáticamente desde el último punto hasta el primer punto.

Polilínea
polyline string

Filtre los resultados a lo largo de una polilínea codificada, use con parámetros de distancia para aumentar la distancia de búsqueda a lo largo de la línea. La polilínea se expande en un polígono para cubrir la distancia de búsqueda.

Devoluciones

response
array of POI

Definiciones

POI

Un POI (Punto de interés), también conocido como o SiteChargePoint, es el conjunto de información de nivel superior sobre un sitio geográfico con uno o varios equipos de carga de vehículos eléctricos presentes.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador de referencia de OCM para este PUNTO de interés (punto de interés).

Identificador Único Universal (UUID)
UUID uuid

Identificador único universal que se usa como clave suplente. El identificador y el UUID deben conservarse al enviar información de actualización de PUNTOS de interés.

Comentarios del usuario
UserComments array of UserComment

Lista de comentarios o check-ins de usuario para este sitio

Elementos multimedia
MediaItems array of MediaItem

Lista de fotos enviadas por el usuario para este sitio

Se ha comprobado recientemente
IsRecentlyVerified boolean

Valor calculado dinámicamente que indica que se ha realizado alguna actividad de confirmación recientemente para este sitio (registros positivos, etc.)

Fecha de última comprobación
DateLastVerified date-time

Un valor calculado dinámicamente, la fecha y hora (UTC, ISO 8601) este POI fue confirmado por última vez por un usuario editando o comentando el usuario relacionado.

Id. de punto de carga primario
ParentChargePointID string

Si está presente, estos datos de esta POI superponen información en otro PUNTO de interés. Por lo general, no es relevante para los consumidores.

Identificador del proveedor de datos
DataProviderID integer

Identificador de referencia para el proveedor de datos de este POI

Referencia del proveedor de datos
DataProvidersReference string

Si está presente, se trata de la clave propia de los proveedores de datos para este PUNTO de interés dentro de su conjunto de datos de origen.

Identificador de operador
OperatorID integer

Identificador de referencia del operador de red o propietario del equipo

Referencia de operadores
OperatorsReference string

Los operadores de red poseen referencia para este sitio (puede ser una referencia de sitio o una sola referencia de equipo)

Id. de tipo de uso
UsageTypeID integer

Identificador de referencia para el tipo de uso del sitio, 0 == Desconocido

Costo de uso
UsageCost string

Descripción de texto libre de los costos de uso probables asociados a este sitio. Por lo general, se relaciona con los cargos de estacionamiento si la red opera este sitio como gratuito

AddressInfo
AddressInfo AddressInfo

La posición geográfica para la información del componente de dirección del sitio y (más cercano).

Connections
Connections array of ConnectionInfo

Lista de información de resumen de equipos para este sitio

Número de puntos
NumberOfPoints integer

El número de bahías o estaciones discretas disponibles en general en este sitio. Esto indica la limitación del número de usuarios simultáneos del sitio.

Comentarios generales
GeneralComments string

Información fáctica adicional general para el POI. No se recomienda que los usuarios usen este campo para obtener opiniones sobre la calidad del sitio, etc.

Fecha planeada
DatePlanned date-time

La fecha y hora (UTC, ISO 8601) este POI es o estaba planeado para la puesta en marcha. En general, las POIs planeadas no deben presentarse a los usuarios finales hasta que se confirmen las operaciones.

Fecha de la última confirmación
DateLastConfirmed date-time

La fecha y hora (UTC, ISO 8601) este POI se confirmó por última vez según el proveedor de datos o un usuario. Consulte DateLastVerified para obtener una fecha calculada dinámicamente en función de varias señales.

Id. de tipo de estado
StatusTypeID integer

Identificador de referencia del tipo de estado operativo general para este POI (es decir, Operativo, etc.). 0 == Desconocido

Fecha de la última actualización de estado
DateLastStatusUpdate date-time

La fecha y hora (UTC, ISO 8601) este POI o las propiedades secundarias relacionadas directamente se actualizaron.

Valores de metadatos
MetadataValues array of

Matriz opcional de valores de metadatos. Se usa generalmente para indicar la atribución de datos, pero también está pensado para su uso futuro para indicar los alrededores, vínculos o valores de clave externa en otros conjuntos de datos.

Nivel de calidad de datos
DataQualityLevel integer

Métrica aplicada durante las importaciones para indicar un nivel de calidad en función de los detalles de la información disponible (5 == mejor). Actualmente no se está usando.

Fecha de creación
DateCreated date-time

Fecha y hora (UTC, ISO 8601) esta POI se agregó a la base de datos De mapa de cargos abiertos

Id. de tipo de estado de envío
SubmissionStatusTypeID integer

Identificador de referencia del tipo de estado de envío que se aplicó a esta POI.

DataProvider
DataProvider DataProvider

Un proveedor de datos es el controlador del conjunto de datos de origen que se usa para construir los detalles de este PUNTO de interés. Los datos se han transformado e interpretado a partir de su forma original. Cada proveedor de datos proporciona datos mediante una licencia explícita o un contrato.

OperatorInfo
OperatorInfo OperatorInfo

Un operador es la organización pública que controla una red de puntos de carga.

UsageType
UsageType UsageType

El tipo de uso de un sitio indica las restricciones generales sobre el uso.

TipoDeEstado
StatusType StatusType

El tipo de estado de un sitio o un elemento de equipo indica si está operativo con carácter general.

SubmissionStatusType
SubmissionStatus SubmissionStatusType

Objeto Estado de envío, que detalla el estado de la lista de puntos de interés.

DataProvider

Un proveedor de datos es el controlador del conjunto de datos de origen que se usa para construir los detalles de este PUNTO de interés. Los datos se han transformado e interpretado a partir de su forma original. Cada proveedor de datos proporciona datos mediante una licencia explícita o un contrato.

Nombre Ruta de acceso Tipo Description
URL del sitio web
WebsiteURL string

Dirección URL del sitio web de este proveedor de datos

Comentarios
Comments string

Comentarios públicos generales con información sobre este proveedor de datos.

DataProviderStatusType
DataProviderStatusType DataProviderStatusType

Objeto de estado que describe si este proveedor de datos está habilitado actualmente y el tipo de origen (entrada manual, importado, etc.).

Está restringido editar
IsRestrictedEdit boolean

Actualmente no se implementa. Indica una posible restricción de edición.

Tiene licencia de datos abiertos
IsOpenDataLicensed boolean

Si es true, el proveedor de datos usa una licencia de Open Data

Importación aprobada
IsApprovedImport boolean

Si es false, es posible que los datos no se importen para este proveedor.

Licencia
License string

Resumen de las licencias que se aplican a este proveedor de datos. Cada proveedor de datos tiene una licencia o contrato específico. El uso de los datos requiere la aceptación de la licencia especificada.

Fecha de la última importación
DateLastImported date-time

Fecha y hora (UTC) la última importación se realizó para este proveedor de datos (si es una importación).

identificación
ID integer

Identificador de referencia de este proveedor de datos

Title
Title string

Título de este proveedor de datos

OperatorInfo

Un operador es la organización pública que controla una red de puntos de carga.

Nombre Ruta de acceso Tipo Description
URL del sitio web
WebsiteURL string

Sitio web para obtener más información sobre esta red

Comentarios
Comments string
Teléfono de contacto principal
PhonePrimaryContact string

Número de contacto principal para usuarios de red

Teléfono de contacto secundario
PhoneSecondaryContact string

Número de contacto secundario

Es individual privado
IsPrivateIndividual boolean

Si es true, este operador representa a un individuo privado.

AddressInfo
AddressInfo AddressInfo

La posición geográfica para la información del componente de dirección del sitio y (más cercano).

Dirección URL de reserva
BookingURL string

Dirección URL de la reserva.

Correo electrónico de contacto
ContactEmail string

Dirección de correo electrónico de contacto.

Correo electrónico del informe de errores
FaultReportEmail string

Se usa para enviar notificaciones automatizadas al operador de red si un usuario envía un comentario o comprobación del informe de errores.

Está restringido editar
IsRestrictedEdit boolean

Si es true, esta red restringe las modificaciones de la comunidad para los datos de OCM.

identificación
ID integer

Id

Title
Title string

Title

UsageType

El tipo de uso de un sitio indica las restricciones generales sobre el uso.

Nombre Ruta de acceso Tipo Description
¿Se paga en la ubicación?
IsPayAtLocation boolean

Si es true, el uso requiere pagar en la ubicación

¿Se requiere pertenencia?
IsMembershipRequired boolean

Si es true, este tipo de uso requiere registro o pertenencia a un servicio.

¿Se requiere la clave de acceso?
IsAccessKeyRequired boolean

Si es true, este uso requiere una clave de acceso físico

identificación
ID integer

Identificador.

Title
Title string

Título.

TipoDeEstado

El tipo de estado de un sitio o un elemento de equipo indica si está operativo con carácter general.

Nombre Ruta de acceso Tipo Description
Está operativo
IsOperational boolean

Si está operativo.

¿Se puede seleccionar el usuario?
IsUserSelectable boolean

Indica si es seleccionable por el usuario.

identificación
ID integer

Identificador.

Title
Title string

Título.

SubmissionStatusType

Objeto Estado de envío, que detalla el estado de la lista de puntos de interés.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Id. de referencia del tipo de estado de envío

Title
Title string

Título.

Is Live
IsLive boolean

Si es true, la lista de puntos de interés está activa (no es borrador o desenlazado)

País

Detalles del país.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Esquema de identificador

Código ISO
ISOCode string

Esquema de código ISO

Código de continente
ContinentCode string

Esquema de código del continente

Title
Title string

Esquema de título

AddressInfo

La posición geográfica para la información del componente de dirección del sitio y (más cercano).

Nombre Ruta de acceso Tipo Description
identificación
ID integer

identificación

Línea de dirección
AddressLine1 string

Primera línea de dirección postal cercana

Línea de dirección 2
AddressLine2 string

Segunda línea de dirección postal cercana

Ciudad o ciudad
Town string

Ciudad o ciudad

Provincia
StateOrProvince string

Provincia

Cp
Postcode string

Código postal o Código postal

Id. de país
CountryID integer

Identificador de referencia del país

País
Country Country

Detalles del país.

Latitud
Latitude double

Coordenada de latitud del sitio en grados decimales

Longitud
Longitude double

Coordenada de longitud del sitio en grados decimales

Teléfono de contacto
ContactTelephone1 string

Número de contacto principal

Teléfono de contacto 2
ContactTelephone2 string

Número de contacto secundario

Correo electrónico de contacto
ContactEmail string

Correo electrónico de contacto principal

Comentarios de acceso
AccessComments string

Instrucciones para que los usuarios usen o busquen el equipo

Dirección URL relacionada
RelatedURL string

Sitio web opcional para obtener más información

Distancia
Distance double

Distancia desde la ubicación de búsqueda, si la búsqueda está alrededor de un punto

Unidad de distancia
DistanceUnit integer

Unidad usada para la distancia, 1= Millas, 2 = KM

Title
Title string

Título general de esta ubicación para ayudar al usuario

UserComment

Comentario o registro de entrada de un usuario para un punto de carga específico (POI/Sitio).

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Id. de punto de carga
ChargePointID integer

Identificador del punto de carga.

Id. de tipo de comentario
CommentTypeID integer

Identificador de tipo de comentario.

UserCommentType
CommentType UserCommentType

Categoría de un comentario de usuario, por ejemplo, Comentario general, Informe de errores (aviso a usuarios y operador).

Nombre de usuario
UserName string

Nombre de usuario.

Comentario
Comment string

Comentario.

Dirección URL relacionada
RelatedURL string

Dirección URL relacionada.

Fecha de creación
DateCreated date-time

Fecha de creación.

Información de usuario
User UserInfo

Perfil de resumen público corto para un usuario específico de Open Charge Map.

Id. de tipo de estado de comprobación
CheckinStatusTypeID integer

Identificador del tipo de estado de comprobación.

CheckinStatusType
CheckinStatusType CheckinStatusType

Clasificación para el comentario o la experiencia de los usuarios mediante una ubicación de carga específica.

MediaItem

Un usuario envió un elemento multimedia relacionado con un punto de carga o sitio específico. Actualmente, siempre es una imagen.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Id. de punto de carga
ChargePointID integer

Identificador del punto de carga.

Dirección URL del elemento
ItemURL string

Dirección URL del elemento.

Dirección URL de miniatura de elemento
ItemThumbnailURL string

Dirección URL de miniatura del elemento.

Comentario
Comment string

Comentario.

Está habilitado
IsEnabled boolean

Indica si está habilitado.

Es vídeo
IsVideo boolean

Si es vídeo.

Elemento destacado
IsFeaturedItem boolean

Indica si se trata de un elemento destacado.

Es recurso externo
IsExternalResource boolean

Si es un recurso externo.

Información de usuario
User UserInfo

Perfil de resumen público corto para un usuario específico de Open Charge Map.

Fecha de creación
DateCreated string

Fecha de creación.

ConnectionInfo (Información de conexión)

Detalles sobre el tipo de equipo y la capacidad de alimentación.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Identificador de tipo de conexión
ConnectionTypeID integer

Identificador del tipo de conexión.

Tipo de conexión
ConnectionType ConnectionType

Tipo de conexión de usuario final compatible con EVSE.

Referencia
Reference string

Referencia de operadores opcionales para esta conexión o puerto

Id. de tipo de estado
StatusTypeID integer

Identificador de referencia del tipo de estado. 0 = Desconocido

TipoDeEstado
StatusType StatusType

El tipo de estado de un sitio o un elemento de equipo indica si está operativo con carácter general.

Id. de nivel
LevelID integer

Categoría general para la capacidad de energía. En desuso a favor de documentar la potencia específica del equipo en kW.

LevelType
Level LevelType

Categoría general para la capacidad de potencia del equipo. En desuso para uso general. Actualmente se calcula automáticamente en función de la potencia del equipo.

Amperios
Amps integer

Corriente máxima de suministro EVSE en amps

Voltaje
Voltage double

Voltaje de suministro evse

KW de energía
PowerKW double

Potencia máxima disponible en kW

Identificador de tipo actual
CurrentTypeID integer

Identificador de referencia de tipo de fuente (por ejemplo, DC, etc.)

SupplyType
CurrentType SupplyType

Indica el tipo de fuente de alimentación EVSE, por ejemplo, DC (corriente directa), AC (fase única), AC (3 fase).

Cantidad
Quantity integer

Número de resumen opcional de los elementos de equipo disponibles con esta especificación

Comentarios
Comments string

Comentarios.

Tipo de conexión

Tipo de conexión de usuario final compatible con EVSE.

Nombre Ruta de acceso Tipo Description
Nombre formal
FormalName string

Nombre formal (estándar) para este tipo de conexión

Está descontinuado
IsDiscontinued boolean

Si es true, se trata de un tipo de conexión descontinuado pero usado.

Está obsoleto
IsObsolete boolean

Si es true, se trata de un tipo de conexión obsoleto y es poco probable que esté presente en la infraestructura moderna.

identificación
ID integer

Identificador.

Title
Title string

Título.

LevelType

Categoría general para la capacidad de potencia del equipo. En desuso para uso general. Actualmente se calcula automáticamente en función de la potencia del equipo.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Title
Title string

Título.

Comentarios
Comments string

Comentarios.

IsFastChargeCapable
IsFastChargeCapable boolean

Si es true, este nivel se considera "rápido", en relación con otros niveles.

SupplyType

Indica el tipo de fuente de alimentación EVSE, por ejemplo, DC (corriente directa), AC (fase única), AC (3 fase).

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Title
Title string

Título.

Información de usuario

Perfil de resumen público corto para un usuario específico de Open Charge Map.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Nombre de usuario
Username string

Nombre de usuario.

Puntos de reputación
ReputationPoints integer

Los puntos de reputación.

Dirección URL de la imagen de perfil
ProfileImageURL string

Dirección URL de la imagen de perfil.

CheckinStatusType

Clasificación para el comentario o la experiencia de los usuarios mediante una ubicación de carga específica.

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Title
Title string

Título.

¿Está automatizada la comprobación?
IsAutomatedCheckin boolean

Si es true, un sistema automatizado proporcionó la comprobación o el comentario.

Es positivo
IsPositive boolean

Si es true, este tipo de registro o comentario se considera positivo.

CoreReferenceData

Conjunto de datos de referencia principales usados para otros resultados de api y interfaz de usuario.

Nombre Ruta de acceso Tipo Description
Tipos de cargador
ChargerTypes array of LevelType

Los tipos de cargador.

Tipos de conexión
ConnectionTypes array of ConnectionType

Los tipos de conexión.

Tipos de estado de comprobación
CheckinStatusTypes array of CheckinStatusType

Tipos de estado de comprobación.

Países
Countries array of Country

Los países.

Tipos actuales
CurrentTypes array of SupplyType

Los tipos actuales.

Proveedores de datos
DataProviders array of DataProvider

Proveedores de datos.

Operadores
Operators array of OperatorInfo

Los operadores.

Tipos de estado
StatusTypes array of StatusType

Tipos de estado.

Tipos de estado de envío
SubmissionStatusTypes array of SubmissionStatusType

Tipos de estado de envío.

Tipos de uso
UsageTypes array of UsageType

Tipos de uso.

Tipos de comentarios de usuario
UserCommentTypes array of UserCommentType

Tipos de comentarios de usuario.

UserCommentType

Categoría de un comentario de usuario, por ejemplo, Comentario general, Informe de errores (aviso a usuarios y operador).

Nombre Ruta de acceso Tipo Description
identificación
ID integer

Identificador.

Title
Title string

Título.

DataProviderStatusType

Objeto de estado que describe si este proveedor de datos está habilitado actualmente y el tipo de origen (entrada manual, importado, etc.).

Nombre Ruta de acceso Tipo Description
¿Está habilitado el proveedor?
IsProviderEnabled boolean

Si es false, los resultados de este proveedor de datos no están habilitados actualmente.

identificación
ID integer

Identificador de referencia para este tipo de estado de proveedor

Description
description string

Título de este tipo de estado