> ## Documentation Index
> Fetch the complete documentation index at: https://help.propops.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Coverage Map

> Interactive contractor coverage map powered by Mapbox — visualise travel-time radii, search by postcode, and overlay nearby points of interest.

The contractor coverage map gives you a full-screen, interactive view of where your contractors operate. Use it to find the right contractor for a job based on location, trade, and travel time.

***

## Map features

<CardGroup cols={2}>
  <Card title="Local & nationwide" icon="map-pin">
    Switch between **local** contractors (within a defined radius) and **nationwide** contractors using the tab bar above the map.
  </Card>

  <Card title="Travel-time radius" icon="clock">
    Each contractor's coverage area is shown as an **isochrone** — a shaded region representing how far they can travel within their configured time limit.
  </Card>

  <Card title="Point-of-interest overlays" icon="hospital">
    Toggle overlays for hospitals, parking, and other nearby landmarks pulled from OpenStreetMap via the Overpass API.
  </Card>

  <Card title="Postcode search" icon="magnifying-glass">
    Search by postcode or address with autocomplete to centre the map on a specific location and see which contractors cover it.
  </Card>
</CardGroup>

***

## Filters

Use the filter panel to narrow down contractors displayed on the map:

| Filter              | Description                                                 |
| ------------------- | ----------------------------------------------------------- |
| **Contractor name** | Search by name to locate a specific contractor              |
| **Trade**           | Filter by trade (e.g. plumber, electrician, locksmith)      |
| **Coverage radius** | Only show contractors whose radius covers the selected area |
| **Travel time**     | Filter by maximum travel time to the job location           |

***

## Isochrone visualisation

Each contractor has a configurable travel-time radius stored in their profile. The map renders this as an **isochrone polygon** — an area on the map showing everywhere the contractor can reach within that time.

* Isochrones are calculated using road-network data, not straight-line distance
* Overlapping isochrones make it easy to see areas with multiple contractor coverage
* Click a contractor's isochrone to view their profile and contact details

<Info>
  Isochrone data is powered by Mapbox and updates when a contractor's coverage settings change.
</Info>

***

## Using the map for job assignment

When creating or reassigning a job, use the coverage map to:

1. **Search** the job's postcode to centre the map
2. **Identify** contractors whose isochrone covers the location
3. **Filter** by the required trade
4. **Select** the best match based on availability and proximity

This ensures jobs are assigned to contractors who can realistically reach the site within the expected timeframe.