Passa al contenuto principale

Calculate transportation costs from city names (POST variant)

POST 
/company/minimal/costs-routes

Calcola i costi di trasporto per una coppia origine-destinazione utilizzando nomi di città come identificatori di ubicazione invece di coordinate o ID di database. È la variante POST del calcolo dei costi, che accetta i dati nel corpo della richiesta.

Obiettivo​

Fornire un endpoint di calcolo dei costi facile da usare tramite nomi di città leggibili dall'uomo, utile per integrazioni in cui le coordinate non sono disponibili.

Casi d'Uso​

  • Calcolare i costi utilizzando nomi di città invece di coordinate
  • Integrazione da sistemi esterni che inviano dati basati sulla città
  • Stima rapida dei costi per strumenti di pianificazione
  • Confronto delle tariffe dei vettori per nome del percorso

Formato della Richiesta​

Si aspetta un oggetto JSON con:

  • origin (obbligatorio): Nome della città di origine (es: Madrid, Barcelona)
  • destination (obbligatorio): Nome della città di destinazione (es: Vigo, Bilbao)
  • with_tolls (opzionale): Includere i costi dei pedaggi nel calcolo (predefinito: false)

Metodo di Calcolo​

Utilizza lo stesso motore di calcolo di GET /company/minimal/costs:

  • L'API di routing esterna fornisce i costi base
  • Costo del carburante basato su distanza e consumo medio
  • Costi dei pedaggi quando with_tolls=true
  • Costi di manutenzione (olio, pneumatici, frizione, ecc.)
  • Costi di tempo/durata

Integrazione Esterna​

Questo endpoint si integra con il servizio di routing Transcend per fornire dati precisi su percorsi e pedaggi nelle rotte europee.

Risposte di Errore​

  • 400: Corpo della richiesta non valido o campi obbligatori mancanti
  • 404: Ubicazione di origine o destinazione non trovata
  • 500: Errore del servizio di routing esterno

Request​

Responses​

Calcolo dei costi completato correttamente.