ForHosting KIT · Strumenti per sviluppatori

Costo dello scalo notturno rispetto al volo diretto

Una coincidenza notturna può trasformare una tariffa aerea più bassa nel viaggio più costoso quando si aggiungono alloggio, pasti e spostamenti tra aeroporto e hotel.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Questo calcolatore riunisce le spese per una persona o un gruppo e le confronta con il sovrapprezzo richiesto per il volo diretto. Inserisca tutti gli importi nella stessa valuta e utilizzi prezzi comprensivi di imposte e commissioni prevedibili. Il risultato mostra la soglia di pareggio e quale itinerario costa meno.

Prepari una stima completa dello scalo notturno

Parta dalla tariffa dell’hotel che potrebbe realmente prenotare, non dal prezzo minimo pubblicizzato su una pagina di ricerca. Includa nella tariffa per notte le imposte di soggiorno, i supplementi della struttura, i costi per il check-in tardivo e ogni altro importo inevitabile. Indichi separatamente camere e notti, così il calcolo funziona per chi viaggia da solo, famiglie, colleghi e coincidenze insolitamente lunghe. Per i pasti, inserisca una cifra realistica per un pasto a persona e scelga quanti pasti a pagamento serviranno a ciascun viaggiatore. Cibo in lounge, buoni della compagnia, colazione inclusa o provviste portate da casa possono giustificare un numero inferiore. Il trasporto va inserito una sola volta per l’intero gruppo e deve coprire l’andata e il ritorno completi fra aeroporto e alloggio. Taxi, servizio con conducente, treno, navetta, parcheggio o una combinazione rientrano in tale cifra. Tutti gli importi devono usare la stessa valuta, poiché il calcolatore li somma direttamente senza conversione.

Confronti il vero supplemento del volo diretto

Il supplemento del volo diretto non è il prezzo totale del biglietto senza scali. È la differenza tra la tariffa complessiva dell’opzione diretta e quella dell’itinerario con scalo notturno per tutte le persone in viaggio. Se l’itinerario con scalo costa meno prima delle spese notturne, sottragga la sua tariffa aerea da quella diretta e inserisca la differenza. Il calcolatore moltiplica la tariffa alberghiera per notti e camere, moltiplica il budget per i pasti per numero di pasti e viaggiatori, aggiunge il trasporto del gruppo e confronta il totale con il supplemento. Un risparmio positivo indica che lo scalo resta più economico dopo le spese. Un valore negativo indica che il volo diretto costa meno. La parità identifica l’esatto punto di pareggio. Il supplemento di pareggio mostrato coincide con l’intera spesa dello scalo: al di sopra conviene lo scalo, mentre al di sotto conviene il volo diretto.

Usi il risultato come base economica della scelta

Il calcolo misura intenzionalmente le spese esplicite senza assegnare un prezzo a ogni disagio. Non valuta il sonno perso, le ore di lavoro, il tempo aggiuntivo, i requisiti per il visto, il deposito bagagli, il rischio di orario o la possibilità che un ritardo elimini il pernottamento previsto. Valuti questi aspetti dopo aver trovato la differenza economica. Se le opzioni sono vicine, anche un valore modesto attribuito al riposo o al tempo può rendere preferibile il volo diretto. Se lo scalo produce un grande risparmio, il risultato mostra il margine disponibile per gli imprevisti. Provi anche uno scenario prudente con un hotel più caro, un pasto aggiuntivo e trasporti maggiorati, soprattutto quando i prezzi non sono ancora bloccati. Verifichi se la compagnia offre hotel, buoni pasto o trasferimenti per una coincidenza idonea; inserisca zero soltanto per costi davvero coperti. L’API costa $0.002 per richiesta, mentre lo stesso calcolo deterministico può funzionare nel browser senza inviare dati di viaggio a un servizio di rete.

Casi d'uso

Scegliere tra due itinerari

Confronti il supplemento del volo diretto con le inevitabili spese notturne prima di prenotare.

Preventivare una coincidenza di gruppo

Consideri più viaggiatori e camere trattando il trasporto condiviso come un’unica spesa del gruppo.

Provare uno scenario prudente

Aumenti le stime di hotel, pasti o trasporti per verificare se lo scalo consente ancora un risparmio.

Domande frequenti

Quanto costa usare il calcolatore tramite API?

Ogni richiesta API costa $0.002. Il calcolo nel browser usa la stessa logica deterministica.

Che cosa devo inserire come supplemento del volo diretto?

Inserisca la tariffa totale dell’itinerario diretto meno quella dello scalo per tutto il gruppo, non il prezzo completo del volo diretto.

Posso usare qualsiasi valuta?

Sì. Usi la stessa valuta per tutti gli importi. Il calcolatore non identifica né converte le valute.

Come vengono calcolati hotel e pasti?

L’hotel è la tariffa notturna moltiplicata per notti e camere. I pasti sono il budget individuale moltiplicato per pasti e viaggiatori.

Che cosa significa un risparmio negativo?

Significa che le spese dello scalo superano di tale importo il supplemento del volo diretto, quindi il volo diretto costa meno.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/travel/overnight-layover-cost

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/travel/overnight-layover-cost \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_nightly_rate":145,"meal_budget_per_person":22.5,"transport_cost":48,"direct_flight_premium":390}'

const res = await fetch("https://api.kit.forhosting.com/travel/overnight-layover-cost", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "hotel_nightly_rate": 145,
    "meal_budget_per_person": 22.5,
    "transport_cost": 48,
    "direct_flight_premium": 390
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/overnight-layover-cost",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "hotel_nightly_rate": 145,
    "meal_budget_per_person": 22.5,
    "transport_cost": 48,
    "direct_flight_premium": 390
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/overnight-layover-cost", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"hotel_nightly_rate":145,"meal_budget_per_person":22.5,"transport_cost":48,"direct_flight_premium":390}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"hotel_nightly_rate":145,"meal_budget_per_person":22.5,"transport_cost":48,"direct_flight_premium":390}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/overnight-layover-cost", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "hotel_nightly_rate": 145,
  "meal_budget_per_person": 22.5,
  "transport_cost": 48,
  "direct_flight_premium": 390
}

Esempio di risposta

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →