A turf is the area assigned to a canvasser. Draw a turf around a neighborhood on a Mapbox map, or import the GeoJSON and KML boundary files you already have through Beacon's REST API. Every contact inside the boundary goes on the walk list (the addresses to visit) of each canvasser assigned to it. Each turf shows the share of its contacts reached, updated when the territory is refreshed.
Capabilities
Beacon gives you a Mapbox map where you click to draw boundaries. You can also import the boundaries you already keep through the REST API, and Beacon warns you about overlaps while you draw.
DRAW
Click points on a Mapbox map to draw a turf, then name it, save it, and assign it. The voters or contacts inside the shape go on the walk list of each canvasser assigned to it.
IMPORT
If you already have boundary files from a redistricting tool, the Secretary of State, or your nonprofit's mapping (GIS) team, Beacon's REST API can import them, and each boundary in the file (a GeoJSON feature or a KML placemark) becomes one territory, named from the file. The API uses the login of a manager or admin on your team.
ASSIGN
Turf cutting means dividing a large area into smaller turfs. While you draw or edit a turf, Beacon lists any other territories it overlaps by name. Overlaps are allowed, so the warning helps you avoid sending two canvassers to the same door. Then assign one or more canvassers to each turf.
Coverage
Each turf shows its contact count and the share of its contacts reached, updated when the territory is refreshed, and the selected turf's contact pins are colored by status. Field directors can see which turfs need more visits and redraw or reassign them as needed.
How a turf gets built
The steps are the same whether you are drawing one precinct or a whole district.
/01
Draw a boundary on the map, or import a GeoJSON or KML file through the REST API. While you draw and when you save, Beacon checks for overlaps and lists any overlapping turfs by name.
/02
Check the canvassers for the turf in its edit panel. Contacts inside the boundary are included by their mapped address, so no one has to look them up.
/03
Refresh a turf to update its coverage percentage, and its contact pins show each contact's status, so gaps are easy to see. If your target list changes, you can redraw a turf, and its walk lists update to match.
/04
Export contacts as CSV with each contact's status and precinct, and door results by campaign, to review the program afterward.
FAQ
Q / 01
Yes, through Beacon's REST API, which uses the login of a manager or admin on your team. Send a GeoJSON or KML file, and each boundary in it (a GeoJSON feature or a KML placemark) becomes one territory. You can also draw directly on the Mapbox map.
Q / 02
When you draw or edit a turf, Beacon checks it against your organization's other territories and lists the overlapping turfs by name. Overlaps are allowed, so the warning helps you avoid sending two canvassers to the same door.
Q / 03
Yes. In the turf's edit panel you can drag its points into a new shape, change its name or color, and change which canvassers are assigned to it. Canvassers get the new walk list the next time they download it.
Q / 04
Beacon places each contact on the map from its address. A contact whose mapped address falls inside a turf's boundary is on that turf, so no one has to assign contacts by hand.
Start drawing
Open an account, draw a territory, and import your contact list.