User Guide (All Roles)
RaceMaps User Guide
The core idea of RaceMaps is "organizer prepares the event -> participants share location -> followers see a live overview." It can be used for many types of activities, not only sports, such as group trips, caravans, training groups, large-area events, route surveys, or field team operations.
What RaceMaps does
Admin
- Create events and race categories (event name, class name)
- Record race routes on maps and link them to categories
- Control Event: Start/Finish + monitor racer status
Racer
- Register for an event/category
- Enable tracking
- Send live location to the map
Viewer
- Scan QR or choose an event
- Pick a category + choose racers to follow
- View map + list panel + focus a racer
Core idea: Admin prepares -> Racer sends location -> Viewer sees the live overview
This guide shows screenshots by topic (Admin / Racer / Viewer) and includes the full gallery at the end.
1) Getting started
1.1 Choose your role
- Open the app -> choose Viewer, Racer, or Admin
- Check your profile (name/photo) so it shows correctly in the racer list
Tip: Racer/Admin modes should test Location + internet before the event day
2) Admin guide
2.1 Manage events (Event)
- Go to Event Categories
- Create a new event (name/date) or select an existing event
- Check setup status: are Category/Route ready?
Best practice: Use formal event names so they are easy to search and recognize
2.2 Manage categories
Categories separate classes/fields/time slots inside an event, such as IRON SILVER
- From the event page -> go to Manage Categories
- Create/edit a category: name, description, start/end time
- Use Show QR (if available) to help viewers enter quickly
2.3 Record Route + Assign Routes
A route is the race path. Record it first, then link it to a category so viewers can see the route on the map.
2.3.1 Record Route
- Go to Record Route
- Press start -> walk/ride along the real route
- Add key points (checkpoints/hazard points) as supported by the UI
- Stop recording -> name the route clearly, then save
2.3.2 Assign Routes
- Go to Assign Routes
- Select a category -> choose a recorded route
- Verify every category is linked to the correct route
Warning: If you do not assign a route, viewers may see racers but no route line
2.4 Control Event
- Go to Control Event
- Press Start when ready / press Finish when done
- Track racer names/status (search/filter)
- Manage status approvals (approved/pending) for racer categories
Large events: Use the "Racer Slot Status" page + search to manage big lists faster
3) Racer guide
3.1 Register + Enable Tracking
- Go to Racer Events
- Select an event -> choose the category you race in
- Allow Location -> turn on Enable Tracking
- During the race: avoid closing the app or turning off internet
Tip: Fully charge + high GPS accuracy helps keep tracking stable
4) Viewer guide
4.1 Enter an event
- Enter Viewer mode
- Select an event from the list, or use Scan QR Code
- Select the Category you want to view
Concept: Viewers pick racers by slot so the map stays light and smooth
4.2 Viewer map + choose racers
- Open the Racers panel -> choose racers to display on the map
- Use search to select faster
- Confirm -> see locations in real time
- Tap a name/pin to focus a racer (per UI)
Note: If positions do not move, the racer may not have tracking on, the network is weak, or the category has not started
5) Location & Privacy
- Racer: must allow Location to send continuous positions
- Viewer: generally does not need to share Location to watch racers
- Access: should be controlled by QR/permissions set in the system
Example Android Location settings
6) Common issues
6.1 Viewer sees the map but not racers
- Is the correct category selected?
- Have racers been selected (are there slots left)?
- Has the category started / has the racer enabled tracking?
6.2 Racer enabled tracking but location jumps/disappears
- GPS/network unstable -> move location / enable high GPS accuracy
- Battery saver -> allow the app to run in background
6.3 Route not showing
- Admin must assign a route to the category first
7) RaceMaps User Guide (Key Conditions)
RaceMaps has three roles (Viewer / Racer / Admin). You can log in on one device at a time—logging in on a new device will log out the previous one.
Viewer
- View slots: Free 5 racers per event; buy +10 or +50. You can select up to limit = free + purchased.
- Slot counting: the system tracks the maximum used for that event; reducing your selection later may not restore the slots already used.
- Selection & Follow: your selected list is stored per event on this device; you can follow 1 racer, and the followed racer does not consume a slot.
- Ads: viewers can optionally remove ads.
Racer
- Visibility on the map: must be approved by Admin in that event/category before appearing to viewers.
- Pre-approval conditions: Admin may require location sharing enabled and/or a recent last known location before approval.
- Location updates: update interval is set by Admin (default 10 seconds). GPS/background permission is required.
- Device switch: one device at a time; new login logs out the previous device.
- Profile: upload a photo from gallery; large images are compressed before upload; a temporary cache may be used.
Admin
- Racer slots: free 15 racers per event; beyond that uses purchased slots from the shared pool. If insufficient, approvals will fail.
- Slot packs: 30 / 50 / 100 / 300 / 500 / 800
- Slot counting: 1 racer counts per event even if they join multiple categories; if purchased slots are not enough, Admin cannot approve more.
- Unapprove: allowed within 15 minutes after approval; if the over-free count drops, purchased slots are returned.
- Event settings: set location update interval; category duration up to 5 hours (adjustable in 5-minute steps).
- Device switch: one device at a time; new login logs out the previous device.
8) Image gallery (loaded)
Screenshots shown are only part of the application
