TrendRoute API Översikt över dokumentationen.
Metabeskrivning: REST-API:er för ruttoptimering och ETA. Integrera ruttoptimering, ETA-beräkning och geospatiala API:er i din logistikplattform. REST/JSON-API:er med autentisering via API-nyckel, utforska endpoints och snabbstartsexempel.
Integration i korthet
Din logistikplattform förblir det primära systemet. TrendRoute tar emot planeringsproblemet, bearbetar det genom sina optimerings- och geospatiala tjänster och returnerar strukturerade operativa resultat.
Din logistikplattform
Order, uppdrag, fordon, statiska rutter och operativa regler.
TrendRoute-API:er
Optimering, ruttutökning, ETA / omberäkning och geospatiala tjänster.
Operativt resultat
Rutter, tilldelningar, ETA:er, KPI:er, geometri och ej tilldelade order.
X-API-Key headern och standardiserade valideringssvar.
Förfrågningar kan använda geografiska koordinater eller
adresser där det stöds.Centrala API-tjänstefamiljer
Använd endast de tjänster som ditt arbetsflöde behöver — från optimering av en enskild rutt till ETA-omberäkning och geospatial infrastruktur.
Ruttoptimering
Optimera en rutt, fördela order över flera rutter eller lös flöden för upphämtning och leverans.
/api/v1/route-optimization/...Ruttutökning
Infoga nya kandidatorder i befintliga eller statiska rutter med valfri efteroptimering och skapande av extra rutter.
/api/v1/route-extension/multiRuttomberäkning & ETA
Behåll den angivna ruttsekvensen samtidigt som ETA:er och ruttprestanda beräknas, inklusive valfri anpassning efter budets prestation.
/api/v1/route-recalculation/...Geospatiala tjänster
Avstånds- och tidsmatriser, ruttanvisningar, geokodning, omvänd geokodning och anpassad ruttgeometri.
/api/v1/geospatial/...Katalog över API-tjänster
En övergripande kompatibilitetsöversikt för lösningsarkitekter och utvecklare som utvärderar hur TrendRoute passar in i en befintlig operativ plattform.
Operativa API:er
| Tjänst | Endpoint | Passar bäst för | Viktig data som utbyts | Integration |
|---|---|---|---|---|
| Enskild rutt | POST /route-optimization/ | Optimering av stoppsekvensen för ett fordon / en rutt. | Order, hubb, valfritt fordon, begränsningar, starttid och mål. | Låg |
| Flera rutter | POST /route-optimization/multi | Fördelning av order mellan fordon och optimering av samtliga resulterande rutter. | Order, hubb, fordon, kapaciteter, ruttbegränsningar och mål. | Medel |
| Sändning | POST /route-optimization/shipment | Express-, mat- och budflöden där upphämtning måste ske före leverans. | Upphämtnings-/leveranssteg, fordon, hubb, kapacitet och ruttbegränsningar. | Medel |
| Ruttutökning | POST /route-extension/multi | Tillägg av dynamiska order till befintliga eller statiska rutter. | Befintliga rutter, fordon, kandidatorder, hubb och begränsningar. | Medel |
| Omberäkning / ETA | POST /route-recalculation/ | Beräkning av ETA:er och rutt-KPI:er utan att ändra den angivna ruttsekvensen. | Ordnade stopp, hubb, starttid och valfri budkontext. | Låg |
| Omberäkning av sändning | POST /route-recalculation/shipment | Omberäkning av ETA och KPI för rutter med beroenden till upphämtningar. | Ordnade sändningsstopp, hubb, starttid och budkontext. | Låg–Medel |
Geospatiala API:er
| Tjänst | Endpoint | Syfte | Kompatibilitetsinformation |
|---|---|---|---|
| Matris | POST /geospatial/matrix | Generera parvisa matriser för resavstånd och restid. | Minst 2 geolokationer. |
| Ruttanvisningar | POST /geospatial/direction | Returnera ruttavstånd, varaktighet, kodad geometri och ordnade punktgrupper. | 2–500 punkter, ruttplanering för bil / cykel, anpassade positioner och gånggrupper. |
| Geokodning | POST /geospatial/geocode | Konvertera adresser till latitud / longitud samtidigt som anroparens ID:n bevaras. | 1–100 adresser per förfrågan. |
| Omvänd geokodning | POST /geospatial/reverse-geocode | Konvertera koordinater till adresser samtidigt som anroparens ID:n bevaras. | 1–100 koordinater per förfrågan. |
Kompatibilitet för datamodellen
TrendRoute utbyter den operativa data som din plattform redan arbetar med samtidigt som du behåller kontrollen över dina egna ID:n och affärsflöden.
IN Vanliga indata
- Order-/uppdrags-ID och stopp-ID
- Latitud / longitud eller adress
- Servicetid och tidsfönster
- Vikt / volym och fordonskapacitet
- Hubb / depå och ruttens starttid
- Fordonsbegränsningar för rutten och transportsätt
- Avstånd, varaktighet eller anpassat kostnadsmål
OUT Vanliga utdata
- Ordnade ruttsteg och fordonstilldelning
- ETA per steg och kumulativa resmått
- Totalt avstånd och restid
- Service- och väntetid
- Stopp/timme och ruttens varaktighet
- ID:n för ej tilldelade order där det är tillämpligt
- Ruttgeometri och ID:n för gånggrupper
Valfri återkopplingsloop
Operativa utföranderesultat kan valfritt skickas tillbaka till TrendRoute för analys, prestandaövervakning och — när kunden aktiverar det — ytterligare förbättring av ETA-modeller, klustring, kartintelligens och optimeringsbeteende.
Integrationsflöde
En tydlig implementeringsprocess i fem steg, från autentisering till skarp drift och valfri återkoppling.
Autentisera
Lagra TrendRoute API-nyckeln säkert och skicka den som X-API-Key.
Mappa data
Mappa dina order, fordon, rutter och begränsningar till förfrågningsschemat.
Anropa API
Välj optimering, ruttutökning, omberäkning / ETA eller geospatiala tjänster.
Hantera resultatet
Spara rutt-ID:n, stoppordning, ETA:er, tilldelningar och KPI:er i din plattform.
Drift & återkoppling
Publicera rutter och skicka valfritt tillbaka utföranderesultat för analys och förbättring.
Minimalt exempel med en enskild rutt
Ett kompakt exempel som visar grundstrukturen för en förfrågan om optimering av en enskild rutt.
POST /api/v1/route-optimization/
X-API-Key: <your-api-key>
Content-Type: application/json
{
"region_id": "stockholm",
"orders": [
{
"id": "o-101",
"stop_id": 1,
"latitude": 59.33,
"longitude": 18.08,
"service_time": 120
},
{
"id": "o-102",
"stop_id": 2,
"latitude": 59.31,
"longitude": 18.06,
"service_time": 120
}
],
"hub": {
"id": "hub-1",
"latitude": 59.31,
"longitude": 18.09
},
"vehicle": {
"id": "van-12",
"transport_mode": "car"
},
"optimization_criteria": "duration"
}Ett lyckat optimeringssvar returnerar rutten, eventuella ID:n för ej tilldelade order, sammanlagda nyckeltal och exekveringstid. Ruttsteg kan innehålla ETA:er, kumulativ tid och sträcka, service- eller väntetid, fordonslast och metadata för gånggrupper.
Checklista för integrationskomplexitet
Validera följande områden innan ni går från teknisk utvärdering till implementering.
Platsdata
Kan ni tillhandahålla stabila ID:n samt koordinater eller adresser?
Begränsningar
Vilka tidsfönster, kapaciteter, ruttbegränsningar och kostnadsmål måste bevaras?
Befintlig ruttmodell
Lagrar ni redan ordnade statiska rutter och tilldelade fordon?
ETA-flöde
Behöver ni ETA vid planering utan att ändra ruttsekvensen?
Mappning till efterföljande system
Kan er dispatch- eller förarapp hantera ruttsteg, tilldelningar och ETA:er?
Valfri återkopplingsloop
Vill ni skicka tillbaka utföranderesultat efter att rutterna har körts?
Säkerhet & fel
Hur ska autentiseringsuppgifter, återförsök och valideringsfel hanteras?
Testa era logistikscenarier innan ni skriver integrationskod.
Använd TrendRoute Sandbox för att bygga scenarier, granska rutter visuellt och utvärdera hur API:t passar in i er befintliga logistikplattform.