This is a simple route-planning tool built by Mapbox volunteers to support non-profit partners who need to coordinate volunteer drivers making deliveries or pick-ups. Anyone may use this tool as a demonstration of the Mapbox Optimization API. It can handle a maximum of 60 addresses in a single route.
For another tool that allows you to adjust the stops along a route, check out the Mapbox Route Tuner solution. For larger-scale or commercial applications, contact Mapbox Sales about our logistics tools.
In a spreadsheet editor or notepad tool, create a list of addresses. The order does not matter except the first address in the list must be the starting point (for example, the warehouse). Write each address like this: Street number Street, City, State, Zip code. For example: 1701 South Jefferson Ave, St. Louis, MO 63104
If you do not know the street address or if a particular address causes errors, try using the longitude and latitude for the location (formatted as the ‘longitude coordinate’, ‘latitude coordinate’).
If you are using a spreadsheet editor, make the list of addresses in one column of your spreadsheet with no column header. Then ‘Save As’ the file as a .csv file. If you are writing the .csv in a text editor or Notepad, put each address inside quotation marks.
You can use this sample .csv file as an example. The maximum number of addresses per .csv file is 60.
On the route planner page, upload your .csv file. Click the ‘LOAD ITINERARY CSV’ text. This will open a window for you to select your .csv file from your computer. Select the file and click ‘Open’.
The suggested route should appear as a line on the map and a list of directions on the left panel. The stops are numbered in sequential order.
(If the route does not load in a few minutes, try troubleshooting the formatting of the .csv for errors.)
Print the route directions or use the address links on a mobile phone.
If your volunteer drivers prefer a printed route sheet and map, print the map and directions using your web browser’s print dialogue (in Chrome, click “File” and then “Print”). If you notice that the route map is cut-off or too small in your print-out, try adjusting the map on the webpage by zooming in or out slightly (use your mouse scroll button or trackpad) or by moving it slightly (click and drag the map).
If your volunteer drivers prefer to use a mobile phone for turn-by-turn navigation guidance, and are using Android devices, they can click on each address in the sidebar and it will open in their navigation app of choice. To use this option, you will need to share the .csv file of addresses with the volunteer driver and have them upload the file to the tool on their mobile phone. If you are interested in building a custom navigation app, check out the Mapbox Navigation SDK for Android or iOS.
Need more help? Have suggestions to improve this Impact Tool? Ask questions on Stack Overflow or contact Mapbox Support. If you are working on a social good project, contact the Mapbox Community Team.
Want to share what you’ve built? Tweet it with #builtwithmapbox