Locations & Wayfinding

Neverline supports structured location data and arrival guidance to help customers find their way to service points.

Service Locations

Each organization can have multiple service locations representing physical venues. Locations store:

Field	Description
Name	Location display name (e.g. "City Hall, Office 3B")
Address	Street address for map links
Floor	Floor number or label
Room	Room number or name
Building	Building name
Map URL	Link to Google Maps or similar
Navigation Notes	Free-text arrival instructions
Entrance Address	Specific entrance to use
Entrance Notes	Instructions for the entrance
Landmarks	Ordered list of navigation landmarks

Managing Locations (Dashboard)

Navigate to Locations in the admin sidebar. From here you can:

1. Browse all locations for your organization
2. Select a location to view and edit its details
3. Edit navigation fields (name, address, instructions, map URL, floor, notes)
4. Save changes — only whitelisted fields are accepted by the API

Wayfinding Overrides

Locations support temporary wayfinding overrides — alerts that modify arrival instructions for a period of time. Common use cases:

• Construction blocking the usual entrance
• Temporary room or floor changes
• Special event routing
• Elevator maintenance

Creating an Override

From the location detail page in the dashboard:

1. Click Add Override in the Active Overrides section
2. Fill in:
   • Type — override category (e.g. construction, relocation, closure)
   • Title — short alert title (e.g. "Main entrance closed")
   • Description — optional details
   • Effective From — when the override starts
   • Effective Until — when it ends (leave blank for indefinite)
3. Click Create Override

Active overrides are automatically shown to customers on the wayfinding screen.

Customer View

When a queue is linked to a service location, customers see a "How to Arrive" button on their waiting screen. Tapping it opens a structured arrival guide showing:

1. Destination card — building name, floor, room, and address with a map link
2. Active overrides — any current alerts (highlighted in warning color)
3. Arrival steps — numbered instructions from entrance to destination
4. Open in Maps — button to launch the map URL in the customer's map app

API Endpoints

Method	Path	Auth	Description
GET	/v1/locations	JWT	List all locations for the organization
GET	/v1/locations/:id	Public	Get location details + active overrides
PATCH	/v1/locations/:id	JWT	Update location navigation fields
POST	/v1/locations/:id/overrides	JWT	Create a wayfinding override

The PATCH endpoint only accepts whitelisted fields (name, address, instructions, map_url, floor, navigation_notes) to prevent arbitrary data writes.