Ambassy

A tool for parkrun Regional Event Ambassadors

Ambassy is designed to help parkrun Regional Event Ambassadors (REAs) to allocate events.

The tool allows you to upload comma-separated values (CSV) files containing the names of the Event Ambassadors you support and the events they support. These data are parsed in your browser and kept in local storage on your device; they are not uploaded to johnsy.com, logged by Ambassy, or stored on our servers. There is no analytics whatsoever: usage is not counted, adoption is not measured, and Ambassy is shared in goodwill, not to boost traffic or prove how many people use it. The intent is close to Datensparsamkeit (data minimisation): carry only what you need for the job. Network use is limited to OpenStreetMap map tiles and the public parkrun events catalogue. When you geocode a place, the search text you enter is sent to OpenStreetMap’s Nominatim to resolve coordinates, and that request does not include your CSV or ambassador names. Only the columns the tool uses are read from each file; any extra columns are ignored and never stored. Share and Open only move files when you deliberately exchange them; there is no central Ambassy service that stores what you are working on. You may use aliases in your CSV if you prefer; the author uses real names because it makes conflicts of interest between volunteers at different levels of the organisation easier to spot. The source code is available on GitHub for inspection (and improvements are welcome).

The tool will then display the events on a map and in a table. Each parkrun event is represented by a marker on the map. The markers are coloured according to the Event Ambassador allocated to the event. There is a Voronoi layer representing Regional Event Ambassadors. The table should be self-explanatory.

Screenshot of Ambassy

I found this useful (and a fun programming challenge) as an REA and I publish it in the hope you do too.

Upload CSV Files

Please upload your files here.

Sample CSV files are provided for you to download, inspect and populate:

Regional Event Ambassador (REA) Event Ambassador (EA) Event Name Event Director(s) Coordinates Event Series Country Actions