Strona główna / routeOptimizer

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.

route optimization

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

Vector 93
geocoding API

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
geocoding API

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?

  1. Uwierzytelnij się. Wywołaj POST /login, aby otrzymać ciasteczko sesji, i wysyłaj je z każdym kolejnym żądaniem.
  2. Wyślij przystanki i pojazdy. Wywołaj POST /optimizations z 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.
  3. 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.
  4. 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.

Branże

Dostawy natychmiastowe / usługi kurierskie

Dystrybucja /
e-commerce

Gospodarka odpadami / serwis