API do optymalizacji tras
routeOptimizer API to API do optymalizacji tras dla flot wielu pojazdów. Wysyłasz przystanki i pojazdy w jednym żądaniu i otrzymujesz zoptymalizowane trasy: który pojazd obsługuje który przystanek, w jakiej kolejności, z dystansem i czasem. API uwzględnia pojemność, okna czasowe, pary odbiór–doręczenie i ograniczenia dróg, więc trasy ostatniej mili planujesz automatycznie z poziomu ERP lub CRM.
Wszystkie narzędzia do skutecznej optymalizacji ostatniej mili
Routing API
Znacznie przyspiesza planowanie dostaw, zarządzanie strefami i trasami oraz zwiększa efektywność wykorzystania floty. Liczba adresów i ograniczeń nie ma już znaczenia — system od razu proponuje najlepiej zoptymalizowane trasy spośród wszystkich możliwych wariantów.
Distance Matrix API
Szybko wylicza odległości, czasy przejazdu i ETA między punktami startowymi i docelowymi — dla tysięcy punktów jednocześnie. Uwzględnia rodzaj pojazdu, jego ograniczenia techniczne, przewożony ładunek, trasę, infrastrukturę drogową i możliwe opóźnienia.
Geocoding API
Zamienia współrzędne i nazwy miejsc na adres lub kod pocztowy — i odwrotnie.
Obsługuje Google, OpenStreetMap i krajowe usługi geokodowania.
Ograniczenia w planowaniu tras
Ograniczenia trasy
- Czas i dystans
- Wiele kursów na pojazd
- Automatyczny podział zleceń z optymalizacją tras
- Limit odległości między punktami
- Priorytet według rodzaju towaru
- Ograniczenia stref/poligonów
Ograniczenia pojazdu
- Klasyfikacja
- Regulacja prędkości
- Wiele typów ładowności
- Koszty użycia i obsługi
- Wymiary i waga towaru
- Limit liczby i rodzaju przystanków
Ograniczenia czasowe
- Godziny pracy i przerwy
- Okna odbioru i doręczenia
- Maksymalny postój w punkcie
Ograniczenia punktów
- Priorytety miękkie i bezwzględne
- Czas obsługi
- Klasyfikacja punktów
- Lista dozwolonych pojazdów
- Okna czasowe odbioru i doręczenia
- Kontrola kolejności odbioru i doręczenia
Trasa
- Czas i dystans
- Wiele kursów na pojazd
- Automatyczny podział zleceń z optymalizacją tras
Pojazd
- Klasyfikacja, prędkość, ładowność, koszty użycia i obsługi
- Wymiary i waga towaru
Czas
- Godziny pracy i zmiany
- Okna odbioru i doręczenia
- Maksymalny postój w punkcie
Punkt
- Priorytety miękkie i bezwzględne
- Czas obsługi
- Klasyfikacja
- Lista dozwolonych pojazdów
- Okna czasowe odbioru i doręczenia
- Kontrola kolejności odbioru i doręczenia
Jak działa routeOptimizer API?
- Uwierzytelnij się. Wywołaj
POST /login, aby otrzymać ciasteczko sesji, i wysyłaj je z każdym kolejnym żądaniem. - Wyślij przystanki i pojazdy. Wywołaj
POST /optimizationsz tablicą points (współrzędne, ładunek i czas obsługi) oraz tablicą vehicles (pojemność i opcjonalne ograniczenia). Punkt 0 jest bazą, chyba że pojazd ma własny początek i koniec. - Odbierz trasy. Odpowiedź przypisuje punkty do pojazdów i podaje kolejność wizyt na każdej trasie wraz z dystansem, czasem i godzinami przyjazdu. Punkty, których nie da się obsłużyć, są zwracane jako nieprzypisane.
- W razie potrzeby popraw. Zmieniaj kolejność przystanków, przenoś punkty między pojazdami, dodawaj pominięte punkty z powrotem do planu, wykluczaj odcinki dróg lub obszary i dołączaj własne metadane.
Przykładowe żądanie
POST /optimizations
{
"response_format": "v2",
"capacity_measurement_type": "volume",
"search_time_limit": 15,
"vehicles": [
{ "id": 1, "capacity": { "general": 6 } },
{ "id": 2, "capacity": { "general": 6 } }
],
"points": [
{ "id": 0, "la": 59.444701, "lo": 24.723633 },
{ "id": 1, "volume": 3, "la": 59.438947, "lo": 24.711118, "st": 900 },
{ "id": 2, "volume": 3, "la": 59.444348, "lo": 24.713008, "st": 1800 }
]
}
Przykładowa odpowiedź (skrócona)
{
"code": 200,
"data": {
"id": 1502,
"result_body": {
"routes": [
{
"veh_id": 1,
"num": 2,
"duration": 3198,
"leg_rings": [[
{ "from": 0, "to": 1, "duration": 243.1,
"time": { "min": "2025-02-09 08:04:03" } },
{ "from": 1, "to": 2, "duration": 106,
"time": { "min": "2025-02-09 08:20:49" } }
]]
}
]
}
}
}
Jakie ograniczenia obsługuje API?
Pojemność pojazdu według wagi, objętości lub sztuk, także z podziałem na komory; okna czasowe klientów; pary odbiór–doręczenie z odbiorem przed doręczeniem; limity wizyt u typów klientów na pojazd; priorytety przystanków; ograniczenia dróg przez wykluczone odcinki lub wielokąty.
Czy są limity?
Konto demo jest ograniczone do 50 przystanków na żądanie. W sprawie wolumenów produkcyjnych skontaktuj się z nami.
Gdzie jest pełna dokumentacja?
Wszystkie endpointy, schematy i przykłady są w dokumentacji routeOptimizer API. Aby wypróbować API na swoich danych, umów prezentację. Porównujesz platformy? Zobacz City & Carrier kontra Route4Me.