Tool Usage Mapper

What is this?

This tool was made to display the evolution of locations on a map.

🚀 Quick start with demo data

1. Get the dependencies.

   npm install

2. Set your environment variables.

   Rename .env.development.sample to .env.development and edit the file as needed.

3. Run it!

   npm run develop

4. Look at the demo data!

   Open your browser, navigate to http://localhost:8000/. Play with the slider to see how the locations change over time.

Display your actual data:

1. Warning.

   You're responsible for the usage you make of this tool. Be very careful with the data you will be working with. Respect all the applicable laws.

2. Requirements.

   pip install pyarrow pandas
   npm i

3. Set your environment variables.

   Rename .env.development.sample to .env.development and fill the form.

4. Get the data from myturn.

   npm run get-data

5. Collect all the files into one.

   npm run merge-data

6. Download file with postcodes and coordinates.

   If you're not in the UK, you'll have to do a bit of work here: You need to get the longitude and latitude for your zip codes/ postcodes.

   If in the UK, you might want to get a different file here: https://www.getthedata.com/open-postcode-geo The default file is massive and will take forever but regional extracts are available. Modify scripts/get_uk_postcodes.sh accordingly.

   npm run get-uk-postcodes

7. Add coordinates to the collection file.

   npm run merge-data-and-coord

8. Run it!

   npm run develop

9. Look at your data!

   Open your browser, navigate to http://localhost:8000/. Play with the slider to see your locations change over time.