LOGIN TO YOUR ACCOUNT

Getting Started

The map shows every site and machine in the dataset. Use the toolbar at the top to switch layers, build routes, filter, and manage data. Markers cluster automatically when zoomed out — click a cluster to zoom in.

Map Layers

Switch between two layers from the Data Source menu:

• Site Layer (default) — one diamond marker per site. blue = CoinOp, pink = KoalaKrane. Mixed-ownership clusters appear half blue / half pink.
• Machine Layer — one square marker per machine, color-coded by category: Smart, Tap & Play, None.

Toolbar Buttons

• Site / Machine Layer — toggle which layer is active.
• Site Directions — click site markers to build a multi-stop route. The fastest visit order is calculated automatically. Use the Start/End dropdowns to pin endpoints.
• Build Route (dropdown) — two ways to build a route at once:
  • Route Site File — upload a CSV runsheet to build a route from listed sites.
  • Route Filtered Sites — route every site currently visible under the active filters.
• Excluded Sites — view, restore, or clear sites/machines you've removed from routing and filters.
• Data Source — switch datasets or load custom site data from a CSV.
• Service Tags — manage tags and their default service times. Tags can be applied to machines and used as filters in the Machine Layer.
• More (dropdown) — less-frequent actions:
  • Fetch API Data — reload all sites and machines from the server, replacing the cached copy.
  • User Guide — reopen this guide.
  • Logout — sign out and clear cached data.

Viewing Site Information

Click any diamond site marker on the map to open the Site Information panel.

• Shows the site name, address, and tags (state, type, group, area, route).
• Lists every machine at the site with its model, category, and serial number.
• Add Site to Directions — adds (or removes) the site from the active route.
• Exclude Site — removes the site from filters, routing, and the map until you restore it.
• Click any machine row in the list to open that machine's details.
• Close the panel with the × in the top corner, or by clicking elsewhere on the map.

Viewing Machine Information

Open the Machine Details panel by clicking a square machine marker (Machine Layer) or a machine row inside a Site Information panel.

• Shows model, category, serial number, on-site status, and any assigned service tags as removable chips.
• Add Machine to Directions — adds or removes the machine from the active route.
• Exclude Machine — hides this single machine from filters and routing.
• Add Tag — opens a picker listing every service tag not yet attached. Click a tag to assign it.
• Click the × on a tag chip to remove that tag from the machine.
• The site name at the top of the panel is clickable and jumps back to the parent Site Information panel.

Search — Step by Step

The Search box (top right) accepts site names, addresses, or machine serial numbers — partial matches work, and it's case-insensitive.

• Type at least one character — the Search Results panel opens automatically on the left.
• Each result row shows the site name, full address, and small badges for state, machine count, and site type.
• If your query matched a serial number, that machine row appears under the site with the matching digits in bold.
• Each result has two action buttons: Add Site to Directions (or Add Machine, in Machine Layer) and Exclude.
• Click anywhere on a result row to fly the map to that location — the marker pulses red so you can spot it.
• Use the Clear button next to the search box to reset the input and close the results panel.

Filters — Step by Step

Two filter panels sit on the right side of the map.

• Site Filter — groups for State, Owner, Category, Model, Onsite (On Site / Off Site), Site Route, and Site Type.
• Attributes Filter — auto-built from the attributes found on machines (flags, statuses, custom fields).
• Click a group header to expand it, then tick boxes to apply filters — results update immediately.
• Within a group, multiple selections combine as OR (e.g. State = NSW or VIC).
• Across groups, selections combine as AND (e.g. State = NSW and Owner = CoinOp).
• An active filter shows a blue count badge on the group header and on the panel title.
• Clear Filters (red button between Search and Site Filter) wipes every site, attribute, and service-tag filter at once.

Building a Route from the Map

• Click a site (or machine) marker → press Add to Directions in the info panel.
• Repeat for every stop you want to include. The Fastest Route panel opens once you have two or more stops.
• The visit order is optimized automatically. Use the Start at and End at dropdowns at the top of the panel to pin the first or last stop.
• Remove a stop with the × next to it in the route list. The route recalculates instantly.
• Click any leg in the route panel to expand turn-by-turn driving directions for that segment.
• Export saves the optimized route as a CSV (one row per machine, including site ID, address, model, serial, service tags, service time, and coordinates).
• Exclude removes every stop currently in the route from future filtering and routing.
• Clear All empties the route without excluding anything.

Building a Route from a CSV Runsheet

Click Route Site File in the toolbar and select a CSV.

• Required columns: Site Name and Address (aliases like name, site_name, location are also accepted).
• Matching tries site ID first, then exact / fuzzy site name, then serial number, then address, then the first column as a fallback.
• After upload, a summary appears showing how many rows matched and how many didn't.
• Unmatched rows are listed in a collapsible Not Found section so you can review them.
• Matched sites are appended to the active route and the optimized order is calculated automatically.

Routing All Filtered Sites

• Apply filters first to narrow the map to the sites you care about.
• Click Route Filtered Sites in the toolbar.
• If no filters are active, you'll be asked to confirm before adding every site on the map.
• Already-added stops are skipped automatically. Two or more stops are required to draw a route.
• In Machine Layer the same button reads Route Filtered Machines and works identically on machines.

Service Tags — Create, Attach, Remove

Open the Service Tags menu from the toolbar.

• Create a tag — click + Add, enter a name and a default service time (minutes), then click the green checkmark to save.
• Attach to one machine — open the Machine Details panel → click Add Tag → pick a tag from the list.
• Bulk attach — in the Service Tags menu, click Apply next to a tag. It assigns the tag to every machine currently visible under the active filters (after a confirmation prompt).
• Remove from a machine — open the Machine Details panel and click the × on a tag chip.
• Filter by tag — click the small filter icon on a tag in the menu to limit the map to machines that carry it.
• Edit — click the pencil icon on a tag to change its name or default service time.
• Delete — click the trash icon. You'll see how many machines currently use the tag before you confirm.

Excluded Sites & Machines

Excluding hides items from filters, routing, and the map. Use it for closed sites or machines you don't want in your runsheet.

• To exclude — open a Site or Machine info panel and click Exclude Site / Exclude Machine. You can also exclude every stop in a route at once with the Exclude button on the Fastest Route panel.
• To review — click Excluded Sites in the toolbar. The dialog shows separate counts for sites and machines and a search box.
• To restore one item — click the × next to it in the dialog. It returns to the map immediately.
• To restore everything — click Clear in the dialog header.
• The toolbar button shows a red badge with the current excluded count.

Custom Site Data

Load your own CSV of sites alongside or instead of the server data.

• Open the Data Source menu → Insert Custom Data. The label changes to Append after the first upload.
• The CSV uses the same column rules as a runsheet (Site Name + Address required).
• The first upload replaces the server data; subsequent uploads append and deduplicate.
• View Custom Data opens a dialog showing matched rows, plus any rows skipped because they couldn't be geocoded.
• Clear Custom Data reverts the map back to the server dataset.

Marker Cues

• Teal/amber — currently part of the active route.
• Pulsing red — the focused marker (from search or panel).
• The Legend at the bottom of the map updates automatically with the active layer.

Map Type

The hamburger button (top left) switches the base map between Light, Satellite, Terrain, and other tile sources.

Keyboard Shortcuts (Tour)

• → or Enter — next step
• ← — previous step
• Esc — exit the tour