ForHosting KIT · Voyages et géographie

Temps de charge complète VE

Une batterie de 75 kWh à 20 % sur une borne de 50 kW demande environ 100 minutes pour être pleine : une heure à pleine puissance, puis une phase plus lente au-delà de 80 %. Voyez les deux phases avant de prévoir un arrêt. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Capacité de la batterie (kWh): 75
Niveau de charge (%): 20
Puissance du chargeur (kW): 50

Vous obtenez

Efficacité: 0,9
Début de la réduction (%): 80
Facteur de puissance final: 0,2
Énergie nécessaire (kWh): 60

Savoir quand un véhicule électrique atteindra la charge complète n'est pas la même chose qu'estimer un complément plat de vingt à quatre-vingts pour cent. La chimie du pack, les limites thermiques et le système de gestion de la batterie ralentissent délibérément le dernier tronçon afin que les cellules restent dans des fenêtres sûres de tension et de température. Ce calculateur de temps jusqu'à la charge complète d'un VE transforme la capacité de la batterie en kilowattheures, l'état de charge actuel et la puissance de crête du chargeur en une durée réaliste qui inclut le taper lent final après le seuil par défaut de quatre-vingts pour cent. Vous obtenez l'énergie encore nécessaire, les heures de phase constante à puissance de crête, les heures de phase de taper sous puissance décroissante, et le total d'heures et de minutes que vous pouvez afficher dans un planificateur de trajet, un tableau de bord de dépôt ou un planning de charge nocturne à domicile.

Ce que le modèle calcule et pourquoi le dernier tronçon est plus lent

Il calcule d'abord energy_needed_kWh comme battery_kWh multiplié par (cent moins le SOC actuel) divisé par cent — les kilowattheures qui doivent encore entrer dans les cellules. Cette énergie n'est pas livrée à un rythme constant jusqu'au plein. Jusqu'au pourcentage de début du taper (quatre-vingts par défaut), le modèle suppose que le chargeur maintient ses kilowatts de crête et que le pack accepte cette puissance après un facteur d'efficacité qui vaut par défaut quatre-vingt-dix pour cent pour les pertes de conversion et de câble.

Au-delà du seuil, la puissance de crête diminue linéairement vers une fraction résiduelle de la crête à cent pour cent (vingt pour cent de la crête par défaut). Ce taper linéaire est une approximation d'ingénierie transparente du ralentissement de type courant constant puis tension constante que les conducteurs remarquent sur les chargeurs publics à courant continu rapide et lors de nombreuses sessions Niveau 2 près du plein.

L'intégration de l'énergie sur une puissance décroissante produit un logarithme en forme fermée pour le segment de taper, de sorte que le résultat est exact pour la courbe déclarée plutôt qu'une moyenne grossière.

Où le temps jusqu'au plein avec taper apporte de la valeur sur la route et dans le logiciel

La charge nocturne à domicile sur un wallbox de sept virgule quatre ou onze kilowatts est souvent planifiée contre une heure de départ stricte : les conducteurs veulent savoir si, en branchant à vingt pour cent après un retour tardif, la voiture atteint encore le plein le matin une fois le taper final compté.

Les planificateurs d'arrêts en voyage utilisent le même point de terminaison pour décider s'il faut attendre quatre-vingt-quinze ou cent pour cent sur un chargeur rapide à courant continu ou débrancher près de quatre-vingts et repartir, car la phase de taper sur une borne de cinquante, cent cinquante ou trois cent cinquante kilowatts peut coûter plus de minutes que la phase constante qui a rempli le milieu du pack.

Comme l'implémentation est parse pure de niveau A, il n'y a pas de jetons de modèle, pas de réseau sortant et pas d'horloge ni d'aléa dans le gestionnaire — seulement de l'arithmétique que vous pouvez tester unitairement pour toujours.

Cas d’usage

Charge complète nocturne à domicile avant le départ

À partir du SOC du soir, des kWh du pack et des kW du wallbox, voyez si la voiture atteint 100 % avant le départ du matin une fois le taper final inclus.

Arrêt de charge rapide DC : attendre le plein ou repartir tôt

Comparez les minutes de phase constante et de phase de taper au-dessus de 80 % sur une borne publique pour décider si attendre le vrai plein en vaut la peine.

Questions fréquentes

En quoi cela diffère-t-il d'une simple énergie divisée par la puissance du chargeur ?

Une estimation plate suppose une puissance de crête constante jusqu'à 100 %. Ce calculateur applique la pleine puissance seulement jusqu'au début du taper (80 % par défaut), puis une baisse linéaire jusqu'à une fraction résiduelle de la crête au plein, ce qui allonge le dernier tronçon de façon réaliste.

Puis-je viser 80 % au lieu du plein ?

Non. Cette capacité vise toujours la charge complète à 100 %. Pour des fenêtres de pourcentages de-à arbitraires sans taper, utilisez plutôt un outil de temps de charge par plage.

Que se passe-t-il si ma batterie est déjà à 100 % ?

Aucune erreur n'est levée pour un pack déjà plein.

Pourquoi la fin de la recharge est-elle si lente ?

Parce que la batterie ralentit volontairement près du plein pour garder les cellules dans des limites sûres de tension et de température. Au-delà de 80 % par défaut, la puissance baisse régulièrement jusqu'au cinquième du maximum de la borne à 100 %.

Que change le réglage de rendement ?

C'est la part de la puissance de la borne qui arrive vraiment à la batterie. La valeur par défaut de 0,9 suppose que 10 % se perdent dans la conversion et le câble, donc une valeur plus basse allonge la séance.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/travel/ev-time-to-full

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/travel/ev-time-to-full \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"battery_kwh":75,"soc_percent":20,"charger_kw":50}'

const res = await fetch("https://api.kit.forhosting.com/travel/ev-time-to-full", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "battery_kwh": 75,
    "soc_percent": 20,
    "charger_kw": 50
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/ev-time-to-full",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "battery_kwh": 75,
    "soc_percent": 20,
    "charger_kw": 50
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/ev-time-to-full", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"battery_kwh":75,"soc_percent":20,"charger_kw":50}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"battery_kwh":75,"soc_percent":20,"charger_kw":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/ev-time-to-full", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "battery_kwh": 75,
  "soc_percent": 20,
  "charger_kw": 50
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.ev_time_to_full",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Ce que le modèle calcule et pourquoi le dernier tronçon est plus lent

Travel.ev_time_to_full répond à une question pratique : à partir de l'état de charge que vous avez maintenant, combien de temps jusqu'à ce que le pack indique cent pour cent sur ce chargeur. La réponse sépare donc constant_phase_hours et taper_phase_hours afin que vous puissiez expliquer pourquoi les dix ou vingt derniers points de SOC dominent le temps de session sur les bornes haute puissance, et pourquoi de nombreux planificateurs d'itinéraire préfèrent repartir autour de quatre-vingts pour cent lorsque les minutes comptent plus que le plein absolu.

Entrées, valeurs par défaut, validation et lecture de la réponse

L'efficiency optionnelle vaut par défaut zéro virgule neuf et doit se situer dans l'intervalle strictement supérieur à zéro jusqu'à un inclus. Trois champs sont obligatoires et doivent être des nombres finis : battery_kwh (capacité utile du pack, strictement supérieure à zéro), soc_percent (état de charge actuel de zéro à cent inclus ; les alias current_soc et soc sont acceptés) et charger_kw (puissance de crête du chargeur en kilowatts, strictement supérieure à zéro). Le taper_start_percent optionnel vaut par défaut quatre-vingts et doit être compris entre zéro et cent. Le taper_end_factor optionnel vaut par défaut zéro virgule deux et doit être supérieur à zéro et au plus un — s'il était zéro, l'intégrale divergerait lorsque la puissance atteint l'axe au plein. Lorsque le SOC est déjà cent, la capacité renvoie zéro heures et minutes avec already_full à true au lieu d'inventer une session négative. Toute autre défaillance lève une erreur typée invalid_input qui nomme le champ en cause ; une validation échouée n'est pas facturée. En cas de succès vous recevez les entrées renvoyées en écho, energy_needed_kwh, constant_phase_hours, taper_phase_hours, heures totales, minutes totales (dérivées du total d'heures non arrondi avant l'arrondi d'affichage), already_full, et une courte chaîne de formule documentant le modèle intégral. Associez les chiffres à votre propre modèle thermique ou de chimie de batterie seulement si vous avez besoin de courbes spécifiques au véhicule ; ce point de terminaison reste volontairement simple côté chargeur et pack pour qu'un formulaire, un bot SMS ou une API de flotte puisse l'appeler sans cartes BMS propriétaires.

Où le temps jusqu'au plein avec taper apporte de la valeur sur la route et dans le logiciel

Les logiciels de flotte de dépôt et d'entreprise regroupent des milliers d'appels à $0.002 chacun pour planifier les relais d'équipe lorsque chaque véhicule doit partir avec un état de charge plein documenté plutôt qu'un complément partiel. Utilisez les valeurs par défaut pour une première estimation raisonnable, puis ajustez taper_start_percent et taper_end_factor lorsque vous disposez de télémétrie d'une famille précise de véhicule et de chargeur, et conservez la répartition énergie et phases à côté du total pour que les opérateurs comprennent où sont allées les minutes.

Cas d'intégration

Planification de charge complète en dépôt de flotte

Regroupez des appels API à $0.002 par véhicule pour planifier des sessions nocturnes de dépôt qui doivent livrer un SOC documenté à 100 %.

Questions techniques

Que signifie taper_end_factor ?

C'est la puissance du chargeur à 100 % de SOC en fraction de la crête. La valeur par défaut 0.2 signifie que la puissance chute linéairement jusqu'à 20 % de la crête au plein. Elle doit rester supérieure à zéro pour que l'intégrale reste finie.

Combien coûte le calculateur de temps jusqu'à la charge complète VE ?

Le widget du navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce que le modèle calcule et pourquoi le dernier tronçon est plus lent

Où le temps jusqu'au plein avec taper apporte de la valeur sur la route et dans le logiciel

Cas d’usage

Charge complète nocturne à domicile avant le départ

Arrêt de charge rapide DC : attendre le plein ou repartir tôt

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Ce que le modèle calcule et pourquoi le dernier tronçon est plus lent

Entrées, valeurs par défaut, validation et lecture de la réponse

Où le temps jusqu'au plein avec taper apporte de la valeur sur la route et dans le logiciel

Cas d'intégration

Planification de charge complète en dépôt de flotte

Questions techniques

merci