Jak to działa — w skrócie
Są dwie rzeczy, które robisz osobno:
- Mapa — robisz ją aplikacją Immersal Mapper ze zdjęć sklepu. Dzięki niej nawigator rozpoznaje
po obrazie z kamery, gdzie stoisz.
- Układ — nagrywasz go w nawigatorze (✎): punkty trasy w alejkach i produkty. Z niego aplikacja liczy,
jak dojść do produktu, i rysuje wstęgę na podłodze.
Układ należy do konkretnej mapy. Nowa mapa z Mappera ma nowe ID i własne współrzędne, więc układ trzeba
nagrać na niej od nowa.
1. Zrób mapę w Immersal Mapper
- W Mapperze utwórz nową mapę i rób zdjęcia, idąc alejkami. Na koniec wyślij ją do przetworzenia.
- Co nam zadziałało (Lidl, 29.09): każdą alejkę przejdź dwa razy — raz lewą stroną, raz prawą,
z kamerą skierowaną na regały. To samo miejsce widziane z dwóch stron dało 50% udanych lokalizacji wobec 29%
przy jednym ciągłym przejściu.
- Nie dokładaj zdjęć regału, który jest już dobrze pokryty — to nie pomaga. Lepiej sfotografuj nowe miejsca
albo to samo z innej strony.
- Przetwarzanie trwa chwilę. Na liście w nawigatorze mapa jest najpierw „w budowie”, potem gotowa.
2. Wybierz mapę w nawigatorze
- Adres: nawigator-sklepowy.pages.dev. Token wpisujesz raz (Ustawienia Immersal), zostaje w telefonie.
- Gdy żadna mapa nie jest wybrana, aplikacja sama bierze najnowszą gotową. Po nagraniu nowej pojawi się
przycisk „Użyj najnowszej mapy” pod „Start AR”.
- Pełna lista z nazwami i datami jest w „Ustawieniach Immersal” → „Moje mapy”. ID można też wpisać ręcznie.
3. Start AR — ustalenie pozycji
- „Start AR w sklepie” i powoli rozejrzyj się po regałach.
- Działa, gdy na regałach pojawią się żółte punkty (to Twoja mapa) i komunikat „Znaleziono Twoją pozycję”.
- Długo nic? Stań tam, gdzie robiłeś zdjęcia w Mapperze, i celuj w regały, nie w podłogę ani sufit.
- „Utracono śledzenie” — skieruj kamerę na regały i chwilę się porozglądaj; pozycja wróci po nowym dopasowaniu.
4. Nagraj układ (✎)
- Naciśnij ✎ u góry ekranu.
- Włącz „Auto-punkty” i idź spokojnie środkiem alejki: co 2 m sam doda się punkt trasy połączony
z poprzednim. Przejście obok istniejącego punktu nie dubluje go, tylko łączy trasę.
- Przy półce wpisz nazwę produktu (i alejkę) i naciśnij „Dodaj „…” tutaj”. To miejsce będzie można
wyszukać.
- Czerwone kropki to punkty niepołączone z resztą. Stań przy nich i naciśnij „Połącz z najbliższym”.
- „Cofnij punkt” usuwa ostatnio dodany punkt. Bez auto-punktów dodawaj je ręcznie co 1–3 m.
- Układ zapisuje się w telefonie i sam kopiuje na serwer (status „☁ Kopia na serwerze”). Bez internetu
wyśle się później. Na innym telefonie wczyta się sam po starcie AR na tej mapie.
5. Sprawdź gotową mapę
a) Czy lokalizacja działa wszędzie — mapa pokrycia. W trybie ✎ na mapce widać kratki:
zielone — działa, żółte — średnio,
czerwone — Immersal tu nie rozpoznaje miejsca. Przejdź całą trasę w AR
i spójrz na napis „Pokrycie: …%”. W czerwonych miejscach dorób zdjęcia w Mapperze.
b) Czy nawigacja prowadzi dobrze. Wyjdź z ✎, wpisz produkt w wyszukiwarkę i wybierz go. Idź za wstęgą
na podłodze i strzałką. Na miejscu (do 1,5 m) aplikacja to pokaże. Sprawdź kilka produktów w różnych
częściach sklepu.
c) Czy pozycja się zgadza. 🔊 „Gdzie jestem” mówi, przy którym punkcie stoisz — porównaj z tym, co widzisz.
d) Wstęga idzie przez regał? W tej alejce brakuje punktów albo jakieś połączenie idzie na skos.
Popraw w ✎: dodaj punkty środkiem alejki.
Tryb demo (bez kamery) — do czego służy?
Do pokazania komuś, jak działa nawigacja, albo sprawdzenia wyszukiwania i tras w domu —
na przykładowym sklepie, bez kamery i bez Immersala.
- Dotknij mapy — tam „stoisz”. Wyszukaj produkt — pojawi się trasa.
- „Symuluj przejście” przeprowadzi kropkę trasą do produktu.
Demo nie sprawdza Twojej mapy ani lokalizacji. Nie ma w nim kopii na serwerze, auto-punktów
ani mapy pokrycia.
Gdy coś nie działa
- Pusta lista map / błąd listy — sprawdź token i internet. ID mapy możesz wpisać ręcznie.
- „☁ brak połączenia” — układ jest bezpieczny w telefonie, kopia wyśle się sama.
- „☁ serwer nie przyjął tokenu” — token w telefonie jest inny niż na serwerze; wpisz właściwy.
- AR nie startuje — Chrome na Androidzie i zgoda na kamerę.
- Długo bez pozycji — patrz punkt 3; jeśli w tym miejscu kratki są czerwone, mapa wymaga dorobienia zdjęć.