BVG Route Planner Skill

Purpose

• Provide concise, actionable public-transport directions in Berlin using the v6.bvg.transport.rest API.

When to use

• User asks for directions between two places in Berlin (addresses, stop names, or coordinates).
• User asks for next departures from a stop/station.
• User requests to arrive by a specific time (arrive-by) or depart at a specific time.

Core behavior

1. Resolve from and to into either stop IDs (preferred) or address/POI objects using GET /locations or /locations/nearby.
2. Call GET /journeys with arrival or departure parameter as requested, request results=3 and stopovers=true to construct step-by-step legs.
3. Format 2–3 options: show total travel time, number of transfers, walking time, and estimated departure/arrival times.
4. Provide step-by-step instructions for the selected journey: walk to stop A (distance/time), take line X toward Y, get off at stop B (platform if available), final walk to destination.
5. When appropriate, include the journey refreshToken and a GET /journeys/:ref refresh step to update realtime delays.
6. For simple next-departure queries, use GET /stops/:id/departures with duration=20 (or configurable) and return the nearest 3 departures.