ForHosting KIT · Viaggi e geografia

Calcolo del costo di un viaggio in bike sharing

Un viaggio di 24 minuti di un abbonato con 10 minuti inclusi addebita 14 minuti, più il costo di sblocco, che resta dovuto; così vede separate la parte fissa e quella al minuto della tariffa. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Esempio risolto

Se inserisce

Tariffa di sblocco: 1
Tariffa al minuto: 0,25
Durata (min): 24
Minuti gratuiti: 10

Ottiene

Minuti gratuiti applicati: 10
Minuti fatturabili: 14
Costo di utilizzo: 3,5
Costo totale: 4,5

Questo calcolatore trasforma la struttura tariffaria di un servizio di bike sharing in una stima chiara. Inserisca il costo di sblocco, la tariffa per minuto e la durata del viaggio. Se la persona è abbonata, aggiunga i minuti gratuiti inclusi: verranno detratti prima di calcolare il consumo. Il risultato distingue quota fissa, tempo fatturabile, costo di utilizzo e totale, risultando utile sia per controllare una ricevuta sia per pianificare una corsa prima della partenza.

Trasformi il listino dell'operatore nei dati richiesti

Parta dalle condizioni pubblicate dall'operatore. Il costo di sblocco è l'importo fisso addebitato all'inizio del viaggio, anche se la corsa dura pochissimo. La tariffa al minuto è la somma aggiunta per ogni minuto fatturabile.

Inserisca entrambi gli importi nella stessa valuta, perché il calcolatore non effettua conversioni. Indichi poi la durata in minuti. Sono ammessi valori decimali quando il servizio misura il tempo con maggiore precisione.

Se l'operatore arrotonda ogni corsa al minuto superiore prima dell'addebito, arrotondi prima la durata affinché il dato rispecchi la regola. Lo strumento non presume alcun criterio di arrotondamento. La distinzione è importante quando una corsa supera di poco un minuto intero e i vari gestori adottano politiche diverse.

Verifichi sempre le condizioni aggiornate per città, abbonamento e tipo di bicicletta interessati.

Applichi correttamente i minuti gratuiti dell'abbonamento

La franchigia viene applicata solo quando il campo relativo all'abbonamento è vero. Senza abbonamento, l'intera durata resta fatturabile anche se è stata inserita una quantità positiva di minuti gratuiti. Per un membro, il calcolatore sottrae i minuti inclusi senza consentire che il tempo fatturabile scenda sotto zero.

Con dieci minuti inclusi e una corsa di otto minuti, il costo di utilizzo è nullo, ma la quota di sblocco rimane. Per una corsa di quattordici minuti, se ne fatturano quattro. Mostrare separatamente parte fissa e variabile facilita il confronto tra piani che offrono tempo gratuito ma conservano il costo iniziale.

Inserisca zero se il piano non include minuti. Non usi questo campo per crediti, coupon, massimali giornalieri, pause, prenotazioni o imposte: seguono regole diverse e non sono comprese nel modello.

Legga il risultato e ne controlli le ipotesi

Il risultato riporta il costo di sblocco e la durata originali, i minuti gratuiti effettivamente utilizzati, quelli ancora fatturabili, il costo di utilizzo e il totale. Quest'ultimo equivale alla quota fissa più i minuti fatturabili moltiplicati per la tariffa al minuto. I valori sono stabilizzati a dieci cifre decimali per evitare rumore da virgola mobile senza imporre un arrotondamento monetario a due decimali.

Restano così possibili tariffe in frazioni di centesimo o subtotali arrotondati dall'operatore solo alla fine. Una durata negativa viene rifiutata perché il tempo trascorso non può essere negativo; lo stesso vale per costi, tariffe e franchigie inferiori a zero. Consideri il risultato una stima trasparente e lo confronti con il regolamento completo.

Minimi, tetti giornalieri, imposte, supplementi elettrici, parcheggio fuori zona, penali e abbonamenti possono modificare la ricevuta e vanno aggiunti separatamente.

Casi d'uso

Stimare il tragitto di un abbonato

Applichi i minuti inclusi e visualizzi l'addebito residuo prima di scegliere una bicicletta.

Controllare una ricevuta di base

Ricostruisca la quota fissa e il subtotale a tempo per individuare l'origine di una differenza.

Confrontare due piani tariffari

Calcoli la stessa durata con costi, tariffe e franchigie diversi per confrontare le spese di base.

Domande frequenti

I minuti gratuiti valgono per chiunque?

No. Vengono detratti solo se il campo dell'abbonamento è vero; altrimenti l'intera durata è fatturabile.

I minuti gratuiti eliminano il costo di sblocco?

No. La franchigia riduce soltanto il tempo fatturabile, quindi la quota di sblocco rimane nel totale.

Sono accettate frazioni di minuto?

Sì. Inserisca una durata decimale finita se corrisponde alla misurazione e all'arrotondamento dell'operatore.

Sono comprese imposte, tetti, penali o supplementi elettrici?

No. Il modello considera solo sblocco, tariffa al minuto e franchigia per gli abbonati.

Come si calcola il costo totale?

Il totale è il costo di sblocco più i minuti addebitabili moltiplicati per la tariffa al minuto. Per gli abbonati i minuti inclusi vengono prima tolti dalla durata, e il tempo addebitato non scende mai sotto zero.

Strumenti correlati

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/bike-share-trip-cost-calc

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/bike-share-trip-cost-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"unlock_fee":1,"per_minute_rate":0.25,"duration_minutes":24}'

const res = await fetch("https://api.kit.forhosting.com/travel/bike-share-trip-cost-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "unlock_fee": 1,
    "per_minute_rate": 0.25,
    "duration_minutes": 24
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/bike-share-trip-cost-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "unlock_fee": 1,
    "per_minute_rate": 0.25,
    "duration_minutes": 24
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/bike-share-trip-cost-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"unlock_fee":1,"per_minute_rate":0.25,"duration_minutes":24}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"unlock_fee":1,"per_minute_rate":0.25,"duration_minutes":24}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/bike-share-trip-cost-calc", 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

{
  "unlock_fee": 1,
  "per_minute_rate": 0.25,
  "duration_minutes": 24
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.bike_share_trip_cost_calc",
  "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.

Note tecniche

Trasformi il listino dell'operatore nei dati richiesti

La versione API costa $0.002 per richiesta e il calcolo deterministico non consulta tariffe in tempo reale.

Domande tecniche

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002.

Che cosa accade con una durata negativa?

La richiesta restituisce l'errore invalid_input, perché un viaggio non può avere durata negativa.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Trasformi il listino dell'operatore nei dati richiesti

Applichi correttamente i minuti gratuiti dell'abbonamento

Legga il risultato e ne controlli le ipotesi

Casi d'uso

Stimare il tragitto di un abbonato

Controllare una ricevuta di base

Confrontare due piani tariffari

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Errori

Note tecniche

Trasformi il listino dell'operatore nei dati richiesti

Domande tecniche

grazie