Budget tempo dell'itinerario

Margine, trabocco, utilizzo e un indicatore fits tornano con le ore raccomandate per riga, così un pianificatore umano e un client API condividono una sola aritmetica. Budget nulli o negativi, transito o riposo negativi e una coppia riservata che già supera la giornata falliscono con invalid_input invece di inventare un orario.

Come transito e riposo riservati restringono l'involucro delle attività

Un budget tempo dell'itinerario tratta la finestra di veglia come un involucro rigido, non come una lista di desideri. Transito e riposo si sottraggono per primi perché in una giornata realistica non sono facoltativi. Ogni attività conserva un nome e una cifra di ore previste così che un blocco del Louvre, un mercato e una passeggiata sul fiume restino distinti. Ore previste uguali restano uguali dopo la scala; una cattedrale di quattro ore accanto a un museo di due conserva il rapporto due a uno. La polvere in virgola mobile viene assorbita nell'ultima attività prevista positiva così che le ore raccomandate sommino esattamente il pozzo restante in una giornata di trabocco. Il campo available_hours è quell'involucro: quattordici ore dalla colazione all'albergo, oppure dieci ore tra una partenza tarda e una prenotazione a cena. Camminare tra musei, un salto di metropolitana, un taxi al belvedere e i minuti persi alle biglietterie vivono in transit_hours. Pasti, un caffè seduti, il check-in in albergo e la pausa di cui il viaggiatore ha davvero bisogno vivono in rest_hours. La loro somma è reserved_hours. Ciò che resta è remaining_for_activities, l'unico pozzo che le tappe previste possono spendere. Quando la somma prevista sta nel pozzo restante, le ore raccomandate eguagliano le previste e slack_hours è il residuo inutilizzato. Quando la somma prevista è maggiore, ogni attività è scalata per remaining_for_activities diviso la somma prevista affinché la giornata raccomandata si chiuda ancora. L'utilizzo può superare il cento per cento quando committed_hours secondo il piano sfora il budget; quello è il segnale di tagliare, non di fingere che l'orologio si allunghi.

Contratto di ingresso, forma della risposta ed errori

Il campo activities è un array non vuoto di oggetti, ciascuno con un name non vuoto e un hours finito non negativo, al massimo cinquanta righe su questo percorso parse gratuito. Colleghi il modulo gratuito del browser alla pianificazione umana e chiami lo stesso contratto da un costruttore di viaggi quando l'automazione serve cifre identiche. Invii per POST un corpo JSON con quattro campi obbligatori. Il campo available_hours è un numero finito strettamente maggiore di zero e al massimo centosessantotto, sufficiente per una giornata lunga o un involucro breve di più giorni. I campi transit_hours e rest_hours sono finiti e non negativi, ciascuno anch'esso limitato a centosessantotto. La loro somma non deve superare available_hours; una coppia riservata che già mangia l'intero budget e oltre fallisce con invalid_input perché non resta un involucro onesto di attività da assegnare. Campi assenti, elenchi vuoti, righe che non sono oggetto, nomi in bianco, numeri non finiti, ore negative e un budget disponibile nullo o negativo falliscono con invalid_input e non vengono fatturati. In successo il corpo ripete i tre ingressi orari, riporta reserved_hours, remaining_for_activities, planned_activity_hours, recommended_activity_hours, committed_hours, slack_hours, overflow_hours, un indicatore booleano fits, uno status fra fits, tight o overflow, utilization_percent, scale_factor e activity_count. Ogni riga di attività porta index, name, planned_hours, recommended_hours, share_of_activities e percent_of_day. Method è reserve_then_scale. Formula riafferma che remaining è available meno transit meno rest, e che recommended_i è planned_i per il minimo di uno e remaining sulla somma prevista. Una giornata tight è una giornata che entra il cui margine è al massimo il dieci per cento di available_hours. Le chiamate API riuscite usano il prezzo base pubblicato $0.002 per voce; i fallimenti di convalida non consumano il saldo prepagato.

Dove un budget tempo giornaliero dell'itinerario rende

Il percorso di trabocco restituisce una raccomandazione scalata invece di un overbook silenzioso, che è ciò di cui un orario rivolto all'ospite ha bisogno prima di stampare un quadro. Chi costruisce un anello zaino in spalla coglie l'errore classico di impilare sei attrazioni in una giornata che ha già speso tre ore sui treni. Accoppi questo allocatore con aiuti di tempo a piedi o di distanza a più tappe quando conosce già i minuti tra i pin e deve solo far quadrare la giornata. Chi viaggia per piacere può incollare un sabato in bozza, leggere di colpo il margine o il trabocco e lasciare una tappa prima di prenotare biglietti a orario che non raggiungerà mai. I tour operator usano un calcolatore di budget tempo dell'itinerario perché un modello di fuga in città sopravviva a una finestra di luce invernale più corta: conservi le stesse tappe previste, alzi transit_hours quando il gruppo cammina più lento e riesegua. Chi organizza ritiri aziendali riserva pranzo e navetta dell'albergo come rest e transit, poi verifica se tre workshop stanno ancora in una giornata di dieci ore. Poiché l'implementazione è parse di livello A pura, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita.