Dodaj lokalizację (ID poleceń) / Dodanie lokalizacji przez wykonanie zadania
Funkcjonalność "Dodaj lokalizację (ID Poleceń)" dostępna jest w ramach ustawień Zadania, w sekcji Zaawansowane ustawienia.
Funkcja ta ma na celu stworzenie nowej lokalizacji w ramach grupy lokalizacji, w której zadanie ma zostać wykonane (czyli dodanie lokalizacji do grupy lokalizacji powiązanej z zdaniem) poprzez udzielenie odpowiedzi na polecenie adres.
Przykład biznesowy:
Handlowiec porusza się po danym obszarze, widzi potencjalnego kontrahenta i chce dodać jego lokalizację do swojej bazy zadań. Uruchamia specjalnie przygotowane do tego celu zadanie (lub część innego zadania) i uzupełnia informacje jak: ulica, numer domu, kod pocztowy, miasto, nazwa lokalizacji.
Po zakończeniu zadania, system łączy wprowadzone dane w jeden ciąg i odpytuje Google Maps API o koordynaty tego adresu (przy okazji dokonując walidacji, czy adres istnieje). Jeśli odpowiedź z Google została zwrócona - adres zostanie stworzony.
Walidacja ta odbywa się w tle, po stronie serwera aplikacji backend'owej w cyklach co minutę (zbierane są udzielone odpowiedzi w oknie ostatniej minuty wysyłane jest odpytanie do Google Maps API).
Uwaga:
Użytkownik nie ma informacji o sukcesie lub porażce (błędzie/nieistniejącym adresie) dodania adresu do bazy danych aplikacji.
Konfiguracja:
Użycie funkcji polega na dodaniu w sekcji Zaawansowane ustawienia tworzonego zadania parametrów (ID polecenia adres), z którego ma zostać stworzona lokalizacja. ID polecenia wprowadza się w polu Dodaj lokalizację (ID poleceń) (Rys.1.). Pole waliduje poprawność wprowadzonych ID czy należą do polecenia adres.
Aby funkcja działała w pełni, należy dodatkowo zaznaczyć opcję Tworzenie lokalizacji w sekcji zaawansowane ustawienia w poleceniu adres.
Polecenie adres zostało opisane w tym artykule.
Uwaga:
Usługa Google Maps API nie działa analogicznie jak usługa Google Maps. Jeśli adres będzie zbyt mało precyzyjny, np. sama ulica z numerem bez miejscowości, bez kodu lub czasem bez kraju Google Maps API może nie zwrócić współrzędnych takiego adresu, mimo że usługa Google Maps w przeglądarce taki adres zwraca.
Rys. 1. Wpisane przykładowe ID poleceń, z których ma zostać wytworzony adres.
Obok pola do wpisywania ID poleceń widoczny jest przycisk "Dopisz do lokalizacji po wykonaniu zdania" (Rys.2.). Po włączeniu spowoduje on, że użytkownik, który wykonał zadanie, zostanie automatycznie dopisany do tej lokalizacji w sekcji Użytkownicy lokalizacji (w przeciwnym razie lokalizacja powstanie, ale użytkownik nie będzie do niej dopisany).
Rys. 2. Włączona funkcja dopisująca użytkownika zadania do wytworzonej lokalizacji.
Parametry, jakie otrzyma dodana lokalizacja:
- Adres lokalizacji ze współrzędnymi. Udzielana przez użytkownika odpowiedź jest parsowana i wysyłana do Google Maps API. Następnie Google zwraca znormalizowany adres (modyfikuje nazwę oraz adres według swojego nazewnictwa);
- Nazwa lokalizacji. Będzie to nazwa wprowadzona w polu Nazwa lokalizacji.
- ID lokalizacji (External ID). Uzupełniane jest ono automatycznie jako kolejny numer, zaczynając od 10000.
- Radius lokalizacji. Jest możliwy do ustawienia jako jeden globalny parametr dla instancji (CreateLocationEntitiesFromCommandAnswersLocationRadius). Domyślnie jest to 10000 metrów.
Funkcjonalność wymaga konfiguracji w ustawieniach głównych aplikacji pozycji:
- EnableCreateLocationEntitiesFromCommandAnswersJob (aktywacja job parsującego adres i odpytującego Google API o współrzędne adresu, sekwencyjność pracy: co 1 minutę;
- CreateLocationEntitiesFromCommandAnswersLocationRadius (konfiguracja bazowej wielkości radiusa).
Uwaga:
Każde 1000 odpytań Google Maps API jest płatne (około 5 USD/1000). Dokładny i aktualny cennik znajduje się tutaj.