Zum Hauptinhalt springen

Calculate transportation costs from city names (POST variant)

POST 
/company/minimal/costs-routes

Berechnet die Transportkosten für ein Ursprungs-Ziel-Paar unter Verwendung von Stadtnamen als Standortkennungen anstelle von Koordinaten oder Datenbank-IDs. Dies ist die POST-Variante der Kostenberechnung, die die Daten im Anfragetext akzeptiert.

Ziel​

Bereitstellung eines benutzerfreundlichen Endpunkts zur Kostenberechnung mittels menschenlesbarer Stadtnamen, nützlich für Integrationen, in denen Koordinaten nicht verfügbar sind.

Anwendungsfälle​

  • Kostenberechnung mit Stadtnamen anstelle von Koordinaten
  • Integration aus externen Systemen, die stadtbasierte Daten senden
  • Schnelle Kostenschätzung für Planungstools
  • Vergleich von Frachtführergebühren nach Routennamen

Anfrageformat​

Erwartet ein JSON-Objekt mit:

  • origin (erforderlich): Name der Ursprungsstadt (z.B. Madrid, Barcelona)
  • destination (erforderlich): Name der Zielstadt (z.B. Vigo, Bilbao)
  • with_tolls (optional): Mautkosten in die Berechnung einbeziehen (Standard: false)

Berechnungsmethode​

Verwendet die gleiche Berechnungsengine wie GET /company/minimal/costs:

  • Die externe Routing-API liefert die Basiskosten
  • Kraftstoffkosten basierend auf Entfernung und Durchschnittsverbrauch
  • Mautkosten bei with_tolls=true
  • Wartungskosten (Öl, Reifen, Kupplung usw.)
  • Zeit-/Dauerkosten

Externe Integration​

Dieser Endpunkt integriert sich mit dem Routing-Dienst Transcend, um präzise Routen- und Mautdaten für europäische Strecken bereitzustellen.

Fehlerantworten​

  • 400: Ungültiger Anfragetext oder fehlende Pflichtfelder
  • 404: Ursprungs- oder Zielstandort nicht gefunden
  • 500: Fehler im externen Routing-Dienst

Request​

Responses​

Kostenberechnung erfolgreich abgeschlossen