|
Beta version
This tool is stable, nevertheless it may still evolve and you may lose your data. Backup regularly if you use it! |
Trip Planner Gadget
[edit]The Trip Planner is a client-side (JavaScript) tool that allows you to drag-and-drop Wikivoyage listings into a custom itinerary, view them on a map, and calculate routes. Custom items can be created (with optional coordinates and wikidata reference), and custom notes can be added to all items.
If you don't want to use the tool, please disable it in your preferences.
Core Features
[edit]- Drag & Drop: Drag (probably) any listing from a Wikivoyage article directly into the Trip Planner widget.
- Listings already in your trip are marked with a green checkmark (✅) on the article page.
- In mobile interface, drag and drop is largely unused. Currently the interface is mostly meant to be used in "read-only mode" or for filling the backlogs.
- Organization:
- Backlog: A holding area for points of interest you haven't assigned to a day yet.
- Days: Assign items to specific days. Drag items to reorder them (the map numbers update automatically).
- Move Button: Quickly move all items from one day to another, or merge them into a different trip.
- Storage:
- Logged-in users: Data is saved to your account preferences and syncs across devices.
- Anonymous users: Data is saved to your browser's local storage.
- Data merges automatically when you log in.
Map Interaction
[edit]- Click Map to toggle the overlay.
- Markers are numbered based on their visit order in the list (e.g., "1", "2"). Backlog items are marked "B".
- Highlighting: Clicking a marker or route line dims other days and auto-scrolls the list to the relevant day.
- Images: Clicking a marker loads the Wikidata image for that location.
Routing & Optimization
[edit]To enable routing features, you must provide a OpenRouteService API Key in the Settings menu (Gear icon). You can grab one for free (at this time) on the OpenRouteService page.
- Calculate Route: Draws travel paths on the map and inserts time/distance stats (e.g., "⬇️ 2.5 km / 15 min ⬇️") between items in the list.
- Optimize Day: Reorders a day's items to find the shortest path to visit them all. The first item is kept fixed as the starting point.
Import / Export
[edit]The tool supports several formats via the Save... button:
- GPX: For importing into GPS devices or apps like OsmAnd.
- GeoJSON: Includes the route geometry (lines) for use in mapping software.
- WikiText: Generates ` ` templates for pasting back into an article.
- JSON (Backup): Full data export. Use "All Data" to back up multiple trips.
JSON files can be imported as well.