Integracje / Transport, spedycja i magazyny / Flota i telematyka / Mapy Google
Transport, spedycja i magazyn
Integracja AI: Mapy Google
Podłączamy cztery usługi Google Maps Platform: Geocoding API do weryfikacji adresów klientów, Routes API do liczenia czasu dojazdu i Distance Matrix API do planowania tras dla całej ekipy serwisowej. Asystent geokoduje zlecenia przy wejściu, układa kolejność wizyt i wylicza koszt dojazdu do każdej wyceny.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.
W skrócie
Jak asystent AI łączy się z systemem Mapy Google?
Łączymy się z Google Maps Platform przez HTTPS, wysyłając zapytania REST bezpośrednio z serwera portalu. Nie ma pliku wymiany ani bazy do podłączenia.
- Na start potrzebujemy
- Konto Google Cloud z aktywnym projektem i skonfigurowanym billing account (bez niego API zwraca REQUEST_DENIED).
- Czego asystent nie robi
- Nie zastępuje nawigacji GPS w samochodzie, serwisant do bieżącej trasy używa aplikacji na telefonie.
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Dane z Mapy Google w czacie i we własnym module
Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Zlecenia i trasy z Maps. Budujemy w portalu moduł, który pobiera zlecenia z kolejki i geokoduje każdy adres przez Geocoding API. Widzicie status każdego adresu: ROOFTOP, APPROXIMATE lub sygnał partial_match, a trasy do zleceń gotowych oblicza Routes API z historycznymi wzorcami ruchu.
- Geokoduje adres każdego zlecenia i pokazuje typ wyniku: ROOFTOP, APPROXIMATE lub błąd
- Oznacza zlecenia z partial_match i APPROXIMATE do weryfikacji przez Waszego operatora
- Oblicza trasę i dystans przez Routes API z typowymi wzorcami ruchu drogowego
- Układa kolejność wizyt serwisantów przez Distance Matrix API dla całej ekipy
- Pokazuje kandydatury z Places API dla niekompletnych adresów ze zgłoszeń klientów
Pytanie w czacie
Asystent wywołuje Routes API z adresem Waszej bazy jako punktem startowym i adresem klienta jako celem. Wynik z dystansem i szacowanym czasem trafia do wyceny po Waszym zatwierdzeniu.
Handlowiec prosi o pomoc: klient Nowa Klimatyzacja w Wilanowie pyta o wycenę wizyty serwisowej. Ile kilometrów ma dojazd z naszej bazy na Pradze i jaki jest szacowany czas przejazdu według Maps?
Karta w narzędziu
Karta zlecenia pokazuje pełny wynik geokodowania, kandydatury z Places API i historię weryfikacji adresu. Wasz serwisant wyjeżdża dopiero po zatwierdzeniu adresu przez operatora.
Moduł pokazuje Waszym dyspozytorowi status geokodowania każdego zlecenia i gotowe trasy. Adresy ROOFTOP jadą od razu, a wątpliwe trafiają do korekty zanim serwisant wyjedzie.
Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie Mapy Google włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyPola formatted_address, geometry.location (lat/lng) i location_type (ROOFTOP albo APPROXIMATE) dla wpisanego adresu.
AsystentZapisuje współrzędne do karty zlecenia i oznacza adresy z location_type APPROXIMATE do weryfikacji przez operatora przed wyjazdem serwisanta.
CzytamySygnał partial_match: true przy adresach niekompletnych lub budzących wątpliwości w odpowiedzi Geocoding API.
AsystentZatrzymuje geokod przed zapisem do zlecenia i inicjuje weryfikację: pokazuje operatorowi kandydatury albo wysyła SMS do klienta z prośbą o potwierdzenie.
CzytamyPola duration i distanceMeters dla podanego origin, destination i departureTime z historycznymi wzorcami ruchu.
AsystentWstawia do wyceny pozycję dojazdu z dokładnym dystansem i szacowanym czasem przejazdu, przeliczonym według stawki z konfiguracji narzędzia.
CzytamyTabela czasów przejazdu i odległości między każdą parą adresów startowych i docelowych w jednym zapytaniu do API.
AsystentPrzypisuje zlecenia do konkretnych serwisantów i układa kolejność wizyt dla każdego z nich, biorąc pod uwagę punkt startowy i priorytety zleceń.
CzytamyLista kandydatów adresowych z dokładnymi adresami z bazy Google dla fragmentu nazwy ulicy lub opisu miejsca.
AsystentPokazuje operatorowi dwa, trzy propozycje do kliknięcia po tym, jak Geocoding API zwróci partial_match dla adresu ze zlecenia.
CzytamyHistoryczne wzorce ruchu dla konkretnej godziny i dnia tygodnia, aktywowane przez parametr departureTime w zapytaniu.
AsystentPodaje realistyczny czas dojazdu w planie dnia i wycenie, zamiast czasu liczonego bez uwzględnienia typowego natężenia ruchu w tej porze.
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „O której dotrze serwisant do klienta w Legionowie, jeśli wyjedzie o 8:00?”
- „Jaką trasę powinni dziś pokonać nasi trzej serwisanci, żeby nie krążyć po całym mieście?”
- „Ile kilometrów ma dojazd do klienta w Wilanowie i ile to będzie kosztować?”
- „Czy adres podany przez klienta w zgłoszeniu jest poprawny i czy da się go znaleźć na mapie?”
Co się zmienia
Serwisanci wyjeżdżają z gotowym planem dnia, wyceny uwzględniają realny dojazd, a zlecenia spoza obszaru obsługi trafiają do flagi już przy wejściu do kolejki.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
Google Maps Platform to zestaw osobnych usług REST API od Google, z których każda ma własny endpoint i sposób rozliczania. Firmy serwisowe, hydrauliczne, montażowe i inne wysyłające pracowników do klientów używają jej do przeliczania adresów na współrzędne, liczenia czasów przejazdu z uwzględnieniem pory dnia oraz planowania kolejności wizyt dla całej ekipy.
W codziennej pracy dane geograficzne przychodzą z API w czasie rzeczywistym, bo Google nie udostępnia bazy adresowej do pobrania na własny serwer. Każde obliczenie, geokod adresu, czas trasy czy macierz odległości, trafia do systemu zleceń jako wynik zapytania i od razu wchodzi do planowania lub wyceny.
Gdzie to działa najlepiej
dyspozytor firmy serwisowej
Rano przed wysyłką ekipy dyspozytor otwiera widok planu dnia. W kolejce jest 12 zleceń, serwisantów trzech, każdy startuje z innego miejsca. Chce wiedzieć, kogo dokąd wysłać i w jakiej kolejności, żeby ekipa nie jeździła przez całe miasto.
Z asystentem: Asystent pobiera adresy z kolejki, geokoduje je i wysyła do Distance Matrix API. Dyspozytor dostaje gotowy podział zleceń i kolejność wizyt dla każdego serwisanta z szacowanymi godzinami dojazdu.
operator przyjmujący zgłoszenia
Klient dzwoni i podaje adres: 'Lipowa, Marki, obok kościoła'. Operator wpisuje to do formularza. Geocoding API zwraca APPROXIMATE. Na ekranie pojawiają się trzy propozycje ulic Lipowej w okolicach Marek do wyboru.
Z asystentem: Operator klika właściwą ulicę i dopisuje numer domu z notatki telefonicznej. Poprawiony geokod trafia do karty zlecenia i serwisant wyjeżdża na właściwy adres, bez dzwonienia do biura z trasy.
handlowiec wystawiający wycenę
Nowy klient spod Legionowa składa zapytanie przez formularz. Handlowiec otwiera kartę i chce doliczyć pozycję za dojazd, ale nie zna dokładnej odległości z bazy na obrzeżach Warszawy ani typowego czasu przejazdu.
Z asystentem: Asystent wywołuje Routes API z adresem bazy jako origin i adresem klienta jako destination. Do wyceny trafia pozycja z dystansem w km, czasem przejazdu i kwotą wyliczoną według stawki z konfiguracji narzędzia.
Jak się łączymy
Łączymy się z Google Maps Platform przez HTTPS, wysyłając zapytania REST bezpośrednio z serwera portalu. Nie ma pliku wymiany ani bazy do podłączenia. Każde wywołanie, geokod adresu, prośba o trasę czy macierz odległości, idzie do właściwego endpointu i wraca jako JSON. Klucz API trzymamy w zaszyfrowanych ustawieniach narzędzia portalu, nie w kodzie ani w pliku tekstowym.
Asystent pracuje w trybie odczytu: odpytuje API Google i zapisuje wynik do karty zlecenia w bazie portalu. Zapis poprawionego adresu następuje dopiero po kliknięciu przez operatora. Klucz API zalecamy ograniczyć w Google Cloud Console do adresu IP serwera i do wybranych usług, co blokuje nieautoryzowane użycie przy ewentualnym wycieku klucza.
Czego potrzebujemy od Was
- Konto Google Cloud z aktywnym projektem i skonfigurowanym billing account (bez niego API zwraca REQUEST_DENIED).
- Klucz API z Google Cloud Console, ograniczony do adresu IP serwera i wybranych usług Maps.
- Włączone usługi: Geocoding API, Routes API, Distance Matrix API i Places API w projekcie Google Cloud.
- Dostęp do Google Cloud Console po stronie firmy do zarządzania kluczem i podglądu limitów zapytań.
- Pole z szacowanym czasem wizyty w kartach zleceń, gdy asystent ma planować kolejność z uwzględnieniem czasu pracy.
Czego asystent nie robi
- Nie zastępuje nawigacji GPS w samochodzie, serwisant do bieżącej trasy używa aplikacji na telefonie.
- Nie zna bieżącego wypadku ani zamkniętej drogi, Routes API korzysta z historycznych wzorców, nie danych na żywo.
- Nie zmienia adresu w karcie zlecenia bez kliknięcia operatora, przy niepewnym geokodzie czeka na potwierdzenie.
- Nie sprawdza obszaru obsługi, jeśli zasięg nie jest wcześniej zdefiniowany w konfiguracji narzędzia.
Częste pytania
Czy asystent może wysyłać SMS do klienta, gdy adres jest błędny?
Tak. Gdy Geocoding API zwróci partial_match i operatora nie ma przy komputerze, asystent może automatycznie wysłać SMS z prośbą o potwierdzenie adresu i linkiem do prostego formularza. Poprawiony adres wraca do karty zlecenia i zostaje zapisany obok oryginału.
Czy mogę zdefiniować obszar obsługi jako wielokąt, nie tylko jako okrąg?
Tak. W konfiguracji narzędzia obszar definiujecie albo jako okrąg ze środkiem i promieniem, albo jako wielokąt z listą współrzędnych punktów granicznych. Drugi sposób sprawdza się, gdy obsługiwany teren ma nieregularny kształt, na przykład wzdłuż trasy albo obejmuje kilka oddzielnych powiatów.
Czy asystent uwzględnia okna czasowe klientów przy planowaniu wizyt?
Tak, jeśli okna czasowe są zapisane w kartach zleceń. Przy układaniu kolejności wizyt asystent uwzględnia dostępność klienta, punkt startowy serwisanta, priorytet zlecenia i szacowany czas wizyty z pola czas_uslugi. Bez tego pola kolejność wynika z samego czasu przejazdu między punktami.
Skąd asystent bierze punkt startowy serwisanta przy planowaniu trasy?
Punktem startowym może być adres magazynu, siedziba firmy albo adres ostatniego klienta z poprzedniego dnia, zależnie od ustawień narzędzia. Jeśli serwisanci zaczynają z różnych miejsc albo z domu, każdy może mieć własny adres startowy zapisany przy koncie, co asystent uwzględnia przy podziale zleceń.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Inne programy: transport, spedycja i magazyn
W tej samej branży: flota i telematyka
Mapy Google jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.