Map view and drawing
Browse destinations on a clustered map, and select whole areas of them by drawing.
A list is the wrong shape for a question like "which of these are in the same industrial estate". Two map surfaces answer that instead: the map view on the destinations page, for looking; and the drawing tools inside the trip builder and the delivery-pool board, for selecting.
Who can do this
- Role
- Administrators
- Permission
destinations:read
Both surfaces read the same destinations you can already see in the list. The map itself is drawn by the configured map provider; without one, the page tells you so and the list view still works.
The map view
The list and map icons at the top right of the destinations page switch between the two. The choice is written into the address bar, so a map you have panned and filtered is a link you can send someone.
Filters are shared, not duplicated. Whatever you have set — status, type, staleness, assigned drivers, custom-field conditions — narrows the map exactly as it narrows the list, so the two views can never quietly disagree about how many destinations exist.
What the map does when you click things.
- 1
Click a cluster to zoom into it
Circles carrying a count are groups aggregated on the server, not individual records. Clicking one zooms to its extent and lets it break apart.
- 2
At maximum zoom, a cluster lists its members instead
Destinations sitting on identical coordinates — a tower block, a market, a bad import — cannot be zoomed apart, so past a point the cluster opens a list of what is inside it rather than zooming further.
- 3
Click a pin for a quick look
A single pin opens an info card. Clicking the same pin again dismisses it, as does clicking the map background or pressing Escape.
- 4
Use the side panel as the list of what is in view
Destinations → Map view → results panelThe panel resolves the destinations inside the current viewport and stays in step as you pan. Selecting a row pans the map to it and opens its card. The panel collapses if you want the full width for the map; the count then moves to a chip in the corner.
Drawing to select in bulk
Drawing is a selection tool, so it lives where a selection is wanted rather than on the browsing map. You will find it in two places: the destination picker in the trip builder, where a drawn area becomes stops on a trip, and the resolve map on the delivery-pool board, where a lasso picks the pins you are assigning.
| Mode | How you use it | Best for |
|---|---|---|
| Select | Drag to pan, click pins to pick them | A handful of known stops |
| Draw | Click each corner, close the shape | A precise boundary you can retrace |
| Freehand | Hold the button and lasso a loop | A rough neighbourhood, fast |
Both drawing modes feed the same selection, and the two sources add together — a drawn area plus a few individually clicked pins is one selection, not two. A few behaviours are worth knowing before you start:
- A shape needs at least three points. In Draw mode, clicking the first vertex again closes it, and a preview line follows the cursor so you can see the edge before committing to it.
- Escape discards the shape in progress. Undo removes the last point. Clear removes every committed area and starts over.
- You can draw up to 20 areas in one selection. Past that the tool refuses politely and tells you to import what you have first.
- The count is computed on the server against the same filters as the list, so it is the real number rather than what happens to be rendered.
- You can prune individual destinations out of a drawn selection before importing it, which is usually faster than redrawing a shape to exclude one address.
When the map does not behave
The map area is blank and says it is unavailable
The map provider could not be loaded — usually an unconfigured or rejected map key rather than anything about your data.
The list view is unaffected, so carry on there and ask an administrator to check the map provider configuration.
A destination I can see in the list never appears on the map
It has no coordinates. The map, area selection and arrival detection all work from latitude and longitude, and a record can be saved without them.
Open the destination and pin it — by searching the address, clicking the map, or typing coordinates. For a whole imported batch, see Geocoding and autofill.
The map cannot pan and drawing does nothing
Freehand mode is still active. It disables dragging deliberately, and on touch input it cannot capture a stroke either.
Switch back to Select. Panning is restored as soon as you leave the mode.
My lasso selected nothing
A stroke that simplifies down to fewer than three points is discarded — a stray click or a tiny wiggle is not a shape.
Draw a larger loop. If a deliberate, large loop still selects nothing, check whether a filter is excluding everything inside it: the drawn area and the toolbar filters are combined, not alternatives.