Xinya Dongfang Electricity Technology Co., Ltd.
La presencia de un cargador en un mapa no significa que ya esté disponible un conector utilizable. Los feeds de estado pueden ser retrasados, incompletos, agregados a nivel de sitio o carecer de la fecha de validación necesaria para evaluar su actualidad. Si una integración trata un registro de ubicación como si fuera disponible de forma inmediata, los conductores pueden ser dirigidos hacia un conector defectuoso, una zona ocupada o información que ya no coincide con las tarifas o las normas de acceso. El riesgo de adquisición radica en elegir una API basada en la cobertura o la documentación sin tener en cuenta quién es el propietario de cada campo y cómo se representan las excepciones. Este artículo establece un camino de decisión para las integraciones de estado en tiempo real: definir la granularidad de estado requerida, verificar el momento y la titularidad de las actualizaciones, manejar estados desconocidos explícitamente y probar el comportamiento de repliegue antes del lanzamiento. El enfoque se centra en una interpretación confiable, no simplemente en añadir otro feed de mapas.
La conclusión práctica es sencilla: elige una API de carga de EV Al rastrear cada campo hasta su propietario, hora de creación, hora de validación y uso permitido. OCPP lleva a cabo mensajes operativos entre un punto de carga y su sistema de gestión de estaciones de carga (CSMS), mientras que OCPI intercambia información de itinerancia y ubicación entre partes como un CPO y eMSP. Su aplicación aún necesita una política de frescor, un modelo tarifario, controles de autenticación y una solución de respaldo en caso de que una fuente de energía esté inactiva.
¿Qué puede informar un API de carga de vehículos eléctricos a su aplicación o a su equipo de operaciones?
Una API es una forma acordada de solicitar registros estructurados: datos sobre el sitio, la estación de carga, el conector, el estado, la potencia, el acceso, la tarifa o los fallos. Una bandera “disponible” a nivel de estación puede ocultar un detalle crucial: una estación de carga puede tener dos conectores con estados diferentes.
Individual ¿Dónde está?, ¿Qué puede hacer? y ¿Qué está sucediendo ahora? La fuente de la información, el tiempo observado, el tiempo efectivo (si se proporciona) y la confianza para cada campo volátil.
Los datos de mapeo públicos son útiles para la detección, pero no son automáticamente una fuente de información operativa. La documentación del API de Open Charge Map describe el acceso a la información sobre ubicaciones de carga; debe validarse la cobertura, actualizarse el comportamiento y los términos antes de presentarlo como inventario en tiempo real. Una integración con Google Maps puede ayudar a renderizar el mapa o a descubrir ubicaciones, pero la frase API de estaciones de carga de vehículos eléctricos de Google Maps No debe considerarse una prueba de un feed dedicado y sin restricciones sobre el estado del cargador. Consulte los términos aplicables de Google Maps Platform, las reglas de atribución y la documentación específica del producto.
¿Cómo dividen OCPP y OCPI la tarea?
OCPP, mantenido por la Open Charge Alliance, lleva a cabo las operaciones, los valores de los medidores, las notificaciones de estado y las acciones remotas entre un punto de carga y su CSMS. Se basa en la autenticidad del dispositivo y depende de la conectividad y el procesamiento del CSMS.
OCPI intercambia ubicaciones, puntos de carga (EVSE)/conectores, tarifas, sesiones, CDRs y tokens entre los participantes en itinerancia. No sustituye a OCPP: un CPO puede recibir una avería a través de OCPP, normalizarla y luego publicar un estado OCPI posterior.
Esta transferencia genera latencia. Registre el último momento en que se vio la información y considere los datos obsoletos como “ignorados” o “verificados”; no están disponibles. Use webhooks para solucionar problemas cuando estén disponibles; la consulta continua siendo útil para la conciliación.
| Ruta de datos | Áreas útiles | Fuerza | Riesgo para gestionar |
|---|---|---|---|
| Cargador → CSMS (OCPP) | Estado, valores del contador, alarmas, resultados de operación remota | Más cercano a la telemetría del dispositivo | Las brechas de conectividad, el comportamiento del firmware y el procesamiento del CSMS pueden retrasar los eventos. |
| Intercambio de CPO/eMSP (OCPI) | Localizaciones, cargadores de vehículos eléctricos/conectores, tarifas, sesiones, CDRs | Roaming interoperable y datos comerciales | Mapado de partners, cadencia de actualizaciones y campos específicos del contrato |
| API de mapeo público | Coordenadas, detalles del lugar, búsqueda y contexto del mapa | Amplia gama de funciones de descubrimiento y mapas fáciles de usar | Licenciación, atribución, cobertura y registros no en vivo |
| API propiedad del operador | Inventario privado, órdenes de trabajo, reglas de precios, alertas | Autoritativo para la sucesión de ese operador | Autorización de acceso, cambios en el esquema y aislamiento de los inquilinos |
¿Cómo deberían limpiar los equipos los datos de estado, conectores y precios?
Utilice un modelo canónico que preserve los valores originales. Mapee los tipos de conectores a un vocabulario controlado, mantenga las ID de los conectores y mantenga la potencia máxima separada de la potencia entregada actualmente; el “cargador rápido” por sí solo no es suficiente para la gestión de la red o la adquisición.
Los aranceles pueden depender de la energía, el tiempo, la sesión, el estacionamiento, la reserva, la membresía o el impuesto. Mantenga la moneda, la unidad, el tratamiento fiscal, el periodo de validez y los componentes. El precio a nivel de conector es importante cuando los puntos de carga de un mismo lugar difieren; indique los precios indicativos en la pantalla de la etiqueta.
Compare las actualizaciones de eventos con instantáneas, marque las transiciones imposibles y alerta cuando un precio no tenga un tiempo efectivo.
¿Qué configuración de API se adapta a un producto para CPO, flotas o mapas?
La mejor opción depende de si usted tiene cargadores, si realiza agregación de datos durante la itinerancia o si solo necesita descubrir dispositivos. Las mejores APIs de carga para estaciones de carga en tiempo real Es una pregunta de calificación, no de ranking.
| Necesidad primaria | Patrón recomendado | Test de decisión |
|---|---|---|
| Administrar un sitio propio | API de CSMS más pipeline de eventos OCPP | ¿Puede el sistema mostrar el estado a nivel de conectores, los timestamps y el historial de fallos? |
| Ofrece roaming en una aplicación eMSP | Localizaciones, tarifas y sesiones del OCPI, con validación específica para cada socio | ¿Son explícitas la frescura, los componentes arancelarios y las autorizaciones comerciales? |
| Ayuda a los usuarios a encontrar los cargadores | API de mapeo y búsqueda con licencia combinada con feeds de operadores verificados | ¿Puede cumplir con los requisitos de atribución, almacenamiento en caché y visualización? |
| Planar las rutas de la flota de forma privada | Inventario propiedad del operador unido a un servicio de envío | ¿Puede el modelo distinguir entre acceso privado, reservas y cierres de mantenimiento? |
Solicite a los fabricantes o integradores una versión del esquema, credenciales de sandbox, ejemplos de errores y avisos de cambio. XYDF puede proporcionar soporte para el equipo y la documentación; el comprador debe asignar la propiedad a cada campo y alerta API.
¿Qué debería incluir una integración segura y sostenible?
Aplique las directrices de seguridad de la API de NIST: utilice tokens con alcance, TLS, almacenamiento de claves, rotación, registros de auditoría y el mínimo de privilegios. Nunca coloque una clave privilegiada en un cliente móvil. Lea los límites de velocidad de cada proveedor, agregue un retardo exponencial, almacene solo lo permitido y muestre un estado degradado. No prometa un porcentaje de tiempo de actividad sin un compromiso escrito.
Utilice esta lista de verificación previa al lanzamiento:
- Fuente del documento, propietario, hora de creación y regla de frescor para cada campo mostrado.
- Testeo del estado del conector, componentes de la tarifa, cambios de horario de verano y interrupciones parciales.
- Confirme las licencias de mapeo, la atribución, los límites de almacenamiento en caché permitidos y la retención de datos.
- Verifique las firmas de los webhook o la autenticación mediante votación, la rotación de claves y los contactos de incidentes.
- Reconcile los eventos con los snapshots y mantenga un historial de auditoría visible para el operador.
Equipos que comparan un API de estaciones de carga de vehículos eléctricos también debería revisar el contexto de la tecnología y la ciberseguridad en este ámbito. Guía de solicitud de información sobre ciberseguridad para cargadores de vehículos eléctricos comerciales y la visión general práctica del roaming en Explica cómo funciona la rotación de carga de vehículos eléctricos.
Preguntas frecuentes sobre las API de carga de vehículos eléctricos
¿Qué es un API de carga de vehículos eléctricos?
Se trata de una interfaz documentada para cargar datos como ubicaciones, puntos de carga para vehículos eléctricos (EVSE), conectores, tarifas, sesiones o estado. Verifique la fuente, el alcance y la actualidad.
¿Qué API puede proporcionar el estado y la disponibilidad del cargador en tiempo real?
Un operador o una API de CSMS respaldada por OCPP suele tener la información más actualizada sobre el estado del dispositivo. El OCPI puede distribuir el estado de itinerancia, pero la latencia depende del CPO, el eMSP y el proceso de actualización. Requiere la existencia de marcadores temporales y un manejo adecuado de los datos obsoletos.
¿Cómo proporcionan las APIs los datos sobre el tipo de conector, la potencia y el precio?
Exponen los objetos EVSE/conectores, los campos de capacidad y los componentes tarifarios. Los normalizan manteniendo los valores originales, la moneda, el tratamiento fiscal y el periodo de validez.
¿Pueden los APIs de Google Maps o Open Charge Map mostrar los cargadores de vehículos eléctricos cercanos?
Pueden soportar la búsqueda dentro de productos y términos documentados. No se debe asumir que estos representen una fuente operativa en tiempo real; combinar el mapeado con datos verificados de los operadores y mostrar el tiempo de actualización.
¿Cuáles son los límites de velocidad y los requisitos de tiempo de actividad para una API de carga?
No hay cuotas ni promesas de disponibilidad generalizadas para la industria. Lea el plan y el SLA del proveedor y luego diseñe medidas de retención de datos, almacenamiento en caché, monitoreo y modo de degradación en función de los límites establecidos.
¿Cómo deberían proteger los operadores las claves API y prevenir la entrada de datos incorrectos en las estaciones?
Almacene los secretos de la aplicación en el servidor, alcance y rota los mismos, utilice TLS, valide las firmas de webhook y registre los accesos. Use validación de esquemas, marcadores de tiempo y pruebas de reconciliación; indique que la disponibilidad de los datos es desconocida si ha transcurrido más de un día.
Referencias autorizadas
- Alianza Open Charge: Protocolo Open Charge Point
- Repositorio EVRoam/OCPI
- Documentación de la API Open Charge Map
- Condiciones de Google Maps Platform
- Guía de seguridad de la API de NIST
Una API de carga de vehículos eléctricos solo es útil cuando cada valor tiene un propietario, un timestamp, un significado y un comportamiento de respaldo claros. Por lo tanto, es necesario seleccionar la integración de estado en vivo en este orden: definir los campos requeridos a nivel de conector, confirmar si los proporciona OCPP o OCPI, comprobar la frescura y las reglas tarifarias, proteger las credenciales y probar estados desconocidos o antiguos antes de que los conductores confiemos en el resultado. La cobertura por sí sola no prueba la disponibilidad, y un registro de ubicación no puede sustituir al estado actual del conector. La integración también debe documentar la licencia, los límites de velocidad, los webhooks, la conciliación y la respuesta cuando el feed de operadores está en silencio. Para los equipos que relacionan los datos de software con el equipo físico, Productos de carga de EV de XYDF Esto puede ser revisado en función de los requisitos de conector, monitoreo y despliegue antes de que se finalice el contrato de API.
