Tempo até carga completa VE

O que o modelo calcula e por que o trecho final é mais lento

Travel.ev_time_to_full responde a uma pergunta prática: a partir do estado de carga que você tem agora, quanto tempo até o pacote reportar cem por cento neste carregador. A resposta portanto separa constant_phase_hours e taper_phase_hours para que você possa explicar por que os últimos dez ou vinte pontos de SOC dominam o tempo de sessão em postos de alta potência, e por que muitos planejadores de rota preferem partir perto de oitenta por cento quando os minutos importam mais do que o cheio absoluto.

Entradas, padrões, validação e leitura da resposta

A efficiency opcional tem padrão zero ponto nove e deve ficar no intervalo maior que zero até um inclusive. Três campos são obrigatórios e devem ser números finitos: battery_kwh (capacidade útil do pacote, estritamente maior que zero), soc_percent (estado de carga atual de zero a cem inclusive; os aliases current_soc e soc são aceitos) e charger_kw (potência de pico do carregador em quilowatts, estritamente maior que zero). O taper_start_percent opcional tem padrão oitenta e deve estar entre zero e cem. O taper_end_factor opcional tem padrão zero ponto dois e deve ser maior que zero e no máximo um — se fosse zero, a integral divergiria ao atingir a potência o eixo no cheio. Quando o SOC já é cem, a capacidade devolve zero horas e minutos com already_full true em vez de inventar uma sessão negativa. Qualquer outra falha lança um erro tipado invalid_input que nomeia o campo culpado; validação falha não é cobrada. Em caso de sucesso você recebe as entradas ecoadas, energy_needed_kwh, constant_phase_hours, taper_phase_hours, horas totais, minutos totais (derivados do total de horas sem arredondar antes do arredondamento de exibição), already_full e uma string curta de fórmula que documenta o modelo integral. Combine os números com seu próprio modelo térmico ou de química de bateria só se precisar de curvas específicas do veículo; este endpoint permanece deliberadamente simples em carregador e pacote para que um formulário, bot SMS ou API de frota possa chamá-lo sem mapas BMS proprietários.

Onde o tempo até o cheio com taper agrega valor na estrada e no software

A carga noturna em casa em um wallbox de sete ponto quatro ou onze quilowatts costuma ser planejada contra um horário rígido de partida: os motoristas querem saber se, ao plugar a vinte por cento após um retorno tarde, o carro ainda chega ao cheio de manhã uma vez contado o taper final. Planejadores de paradas em viagens usam o mesmo endpoint ao decidir se esperam noventa e cinco ou cem por cento em um carregador rápido de corrente contínua ou desconectam perto de oitenta e seguem, porque a fase de taper em um posto de cinquenta, cento e cinquenta ou trezentos e cinquenta quilowatts pode custar mais minutos do que a fase constante que encheu o meio do pacote. Software de frota de pátio e de local de trabalho agrupa milhares de chamadas a US$ 0,002 cada uma para agendar passagens de turno quando cada veículo deve sair com estado de carga completo documentado em vez de um reabastecimento parcial. Use os padrões para uma primeira estimativa sensata, depois ajuste taper_start_percent e taper_end_factor quando tiver telemetria de uma família específica de veículo e carregador, e mantenha o detalhamento de energia e fases ao lado do total para que os operadores entendam para onde foram os minutos.