# RCWeb GPS

**RCWeb GPS** lets everyone in the same virtual room share their live GPS location on a shared Google map. It is designed for phones, so the map takes most of the screen and the controls stay tucked away in a small menu.

![icon](pwa-512x512.png "GPS App Icon")

## Screenshot
![screenshot](screenshot-narrow.png "GPS App")

## What You Can Do

- See everyone in the room on one map.
- Share your own location after giving the browser permission.
- Identify people by their saved RCWeb name.
- Recenter the map on yourself or fit the map to everyone.
- Share the app with others using a QR code.
- Inspect raw GPS details such as latitude, longitude, accuracy, altitude, speed, heading, and timestamps.

## Getting Started

Open `/gps/` on your phone. When the browser asks for location permission, allow it if you want to appear on the shared map.

The app uses your saved `rcwebName` as your label. If you have not set a name before, the app creates a simple default name. You can change it from the menu at any time.

Everyone must be in the same RCWeb room to see each other. The easiest way to invite someone is to open the menu and choose **Share RCWeb GPS app**. Scan the QR code or send the displayed link.

## Menu Options

- **Show my location**: Centers and zooms the map to your latest GPS fix.
- **Show all users locations**: Fits the map so every person with a current GPS fix is visible.
- **Raw GPS data**: Shows detailed location data for everyone currently known in the room.
- **Change name**: Updates the name shown above your pin and saves it as `rcwebName`.
- **Share RCWeb GPS app**: Opens a QR code and room link for inviting others.
- **Start GPS sharing / Stop GPS sharing**: Toggles whether your phone is actively sharing its location.

## How Location Sharing Works

When GPS sharing is active, your browser watches your location and sends updates to the other GPS app users in the same room. Your pin updates as your phone reports new positions.

When you stop GPS sharing, the app stops watching your location and tells the room to remove your pin. You can start sharing again from the same menu option.

When a new person joins the room, existing users send their latest known state so the newcomer can quickly see the current map.

## Privacy Notes

GPS data is shared with other browsers in the same RCWeb room. The RCWeb server relays messages between browsers, but the app does not store a location history or write locations to a database.

Anyone with the same room link can join that room, so only share the QR code or room URL with people you want to see the map.

Closing the tab or stopping GPS sharing removes your active sharing from the room. Other users may briefly see your last known position until their app receives the stop, leave, or refresh update.

## Troubleshooting

- If you do not appear on the map, check that the browser has location permission for the site.
- If your position is inaccurate, wait a few moments or move somewhere with better GPS reception.
- If you accidentally denied permission, use your browser or operating system settings to allow location access, then choose **Start GPS sharing** again.
- If you cannot see someone else, confirm both phones are using the same room code in the URL.