Output includes:

ID - The location identifier (use this in journey search)
Name - Official name of the location
Type - STOP_AREA (station), ADDRESS, or POI (point of interest)
Area - Region/municipality
Coordinates - Latitude, longitude

When to increase limit:

First result doesn't match user's intent
User's query is ambiguous (e.g., "station", "centrum")
Need to show user multiple options to choose from

2. Journey Search

Plan a journey between two locations using their IDs.

./journey.sh <from-id> <from-type> <to-id> <to-type> [datetime] [mode]

Argument	Description
`from-id`	Origin location ID (from search) or coordinates (`lat#lon`)
`from-type`	`STOP_AREA`, `ADDRESS`, `POI`, or `LOCATION` (for coordinates)
`to-id`	Destination location ID or coordinates
`to-type`	Type of destination
`datetime`	Optional: `"18:30"`, `"tomorrow 09:00"`, `"2026-01-15 09:00"`
`mode`	Optional: `"depart"` (default) or `"arrive"`

Important: The Journey API only accepts STOP_AREA and LOCATION types. For ADDRESS or POI results, use the coordinates as lat#lon with type LOCATION.

Understanding User Time Intent

Before searching, understand what the user wants:

Intent Types

User Says	Intent	How to Query
"now", "next bus", "how do I get to"	Travel Now	No datetime parameter
"in 30 minutes", "in 1 hour", "after lunch"	Depart Later	Calculate time, use `depart` mode
"around 15:00", "sometime afternoon"	Around Time	Query with offset (see below)
"arrive by 18:00", "need to be there at 9"	Arrive By	Use `arrive` mode
"tomorrow morning", "on Friday at 10"	Future Time	Use specific datetime

Handling "Around Time" Queries

When user wants options "around" a time, query 15-30 minutes earlier to show options before and after:

# User: "I want to travel around 15:00"
# Query at 14:30 to get options spanning 14:30-16:00+
./journey.sh ... "14:30" depart

Relative Time Calculations

Convert relative times to absolute:

User Says	Current: 14:00	Query Time
"in 30m"	→	"14:30"
"in 1h"	→	"15:00"
"in 2 hours"	→	"16:00"

LLM Response Formatting

When presenting journey results to users, use these emojis and formatting guidelines.

Emoji Reference

Emoji	Use For
🚂	Train (Pågatåg, Öresundståg)
🚌	Bus
🚇	Metro (Copenhagen)
🚋	Tram
⛴️	Ferry
🚶	Walking segment
⏱️	Time/duration
🕐	Departure time
🏁	Arrival time
📍	Stop/station
🏠	Origin (home/start)
🎯	Destination
⚠️	Delay or disruption
✅	On time
🔄	Transfer/change
🛤️	Platform/track

Response Structure

Always include these key elements from the tool output:

When to leave - The actual time user needs to start (including walking)
Walking segments - Distance and time for any walking
Transport departure - When the bus/train actually leaves
Arrival time - When user reaches destination
Any delays - Show deviation from schedule

Example Response Format

For a simple direct journey:

🏠 **Leave home at 09:00**

🚶 Walk 450m to Möllevångstorget (5 min)

📍 **Möllevångstorget** → 🎯 **Malmö C**
🚌 Bus 5 departs 09:07 from Möllevångstorget
🏁 Arrives 09:18 at Malmö C

⏱️ Total: 18 min

For a journey with transfer:

🏠 **Leave at 08:45**

🚶 Walk 300m to Västra Hamnen (4 min)

📍 **Västra Hamnen** → 🔄 **Malmö C** → 🎯 **Lund C**

**Leg 1:**
🚌 Bus 2 departs 08:51 [🛤️ Läge A]
🏁 Arrives Malmö C 09:05

🔄 Transfer at Malmö C (6 min)

**Leg 2:**
🚂 Pågatåg departs 09:11 [🛤️ Spår 4]
🏁 Arrives Lund C 09:23

⏱️ Total: 38 min | 🔄 1 change

With delays:

🕐 **Depart 14:30** from Triangeln

🚂 Öresundståg 1042 → København H
⚠️ +8 min delay (expected 14:38 instead of 14:30)
🏁 Arrives ~15:25 (normally 15:17)

Walking Segment Details

CRITICAL: Always show walking details from the tool output:

Distance in meters (from line.distance)
Include walking in the "leave time" calculation
Show walking at start AND end of journey

Example tool output:

→ WALK 450m from Kalendegatan to Möllevångstorget

Format as:

🚶 Walk 450m to Möllevångstorget (~5 min)

Walk time estimate: ~100m per minute (normal walking speed)

Presenting Multiple Options

When showing journey options, make timing crystal clear:

I found 3 options for you:

**Option 1 - Leave now (09:00)** ✅ Recommended
🚶 5 min walk → 🚌 Bus 5 at 09:07 → arrives 09:25
⏱️ Total: 25 min

**Option 2 - Leave in 15m (09:15)**
🚶 5 min walk → 🚌 Bus 5 at 09:22 → arrives 09:40
⏱️ Total: 25 min

**Option 3 - Leave in 30m (09:30)**
🚶 5 min walk → 🚂 Train at 09:37 → arrives 09:48
⏱️ Total: 18 min | Faster but later departure

Time Offset Notation

Use clear notation for departure times:

Notation	Meaning
"now"	Immediately
"in 15m"	15 minutes from now
"in 1h"	1 hour from now
"at 14:30"	Specific time

LLM Workflow: How to Plan a Trip

Follow this workflow when a user asks for a trip:

Step 1: Understand Time Intent

Parse what the user wants:

"How do I get to..." → Travel now
"I need to be there at 18:00" → Arrive mode
"Sometime around 3pm" → Query 14:30, show range
"In about an hour" → Calculate from current time

Step 2: Search for Both Locations

Search for origin and destination separately:

./search-location.sh "Malmö C"
./search-location.sh "Emporia"

Step 3: Validate Search Results

Check each result carefully:

Exact or close match? - If the name matches what the user asked for, proceed.
Multiple results returned? - The script shows up to 10 matches. If the first result isn't clearly correct, ask the user to confirm.
Name significantly different? - If user asked for "the mall near Hyllie" and result shows "Emporia", confirm with user: "I found Emporia shopping center near Hyllie. Is this correct?"
No results found? - Try alternative strategies (see below).

Step 4: Handle Ambiguous or Failed Searches

When results don't match or are ambiguous, ask clarifying questions:

I searched for "centrum" and found multiple locations:
1. Malmö Centrum (bus stop)
2. Lund Centrum (bus stop)
3. Helsingborg Centrum (bus stop)

Which one did you mean?

When no results are found, try these strategies:

Try with city name for addresses:

# If "Storgatan 10" fails, try:
./search-location.sh "Storgatan 10, Malmö"

Try official station names:

# If "Malmö station" fails, try:
./search-location.sh "Malmö C"

Try landmark name only (without city):

# If "Emporia, Malmö" fails, try:
./search-location.sh "Emporia"

Use coordinates as last resort:
- If you know the approximate location, use lat#lon format directly
- Ask user: "I couldn't find that location. Can you provide the address or coordinates?"

Step 5: Convert Types for Journey API

The Journey API only accepts:

STOP_AREA - Bus/train stations (use ID directly)
LOCATION - GPS coordinates as lat#lon

If search returns ADDRESS or POI:

Use the coordinates from search result
Format as lat#lon with type LOCATION

Example:

# Search returns: ID: 123, Type: ADDRESS, Coordinates: 55.605, 13.003
# Use in journey as:
./journey.sh "55.605#13.003" LOCATION 9021012080000000 STOP_AREA

Step 6: Execute Journey Search

Once you have confirmed IDs/coordinates for both locations:

./journey.sh <from-id> <from-type> <to-id> <to-type> [datetime] [mode]

Step 7: Format Response with Emojis

Use the emoji guide above to present results clearly. Always use actual numbers from the tool output - never speculate or estimate.

Query Formatting Rules

The search API is sensitive to formatting. Follow these rules:

Landmarks and POIs: Name Only

Use the landmark name WITHOUT city name.

# CORRECT
./search-location.sh "Emporia"
./search-location.sh "Triangeln"
./search-location.sh "Turning Torso"

# WRONG - city name breaks POI search
./search-location.sh "Emporia, Malmö"        # May return wrong location!
./search-location.sh "Triangeln, Malmö"      # Unnecessary, may fail

Street Addresses: Include City

Include city name for better accuracy.

# CORRECT
./search-location.sh "Kalendegatan 12, Malmö"
./search-location.sh "Storgatan 25, Lund"
./search-location.sh "Drottninggatan 5, Helsingborg"

# RISKY - may be ambiguous
./search-location.sh "Kalendegatan 12"       # Works if unambiguous

Train Stations: Use Official Names

Use "C" suffix for central stations.

# CORRECT
./search-location.sh "Malmö C"
./search-location.sh "Lund C"
./search-location.sh "Helsingborg C"
./search-location.sh "Malmö Hyllie"
./search-location.sh "Malmö Triangeln"

# WRONG
./search-location.sh "Malmö"                 # Ambiguous!
./search-location.sh "Malmö Central"         # Not official name
./search-location.sh "Lund station"          # Not official name

Copenhagen (Cross-border)

Use Danish names or common alternatives.

# All work
./search-location.sh "København H"
./search-location.sh "Nørreport"
./search-location.sh "Copenhagen Airport"
./search-location.sh "Köpenhamn"

Examples

Example 1: Travel Now

User: "How do I get from Malmö C to Lund C?"

./search-location.sh "Malmö C"
./search-location.sh "Lund C"
./journey.sh 9021012080000000 STOP_AREA 9021012080040000 STOP_AREA

Response:

🏠 **Leave now** from Malmö C

📍 **Malmö C** → 🎯 **Lund C**
🚂 Öresundståg 1324 departs 09:04 [🛤️ Spår 2b]
🏁 Arrives 09:16 at Lund C [🛤️ Spår 1]

⏱️ Total: 12 min | ✅ Direct, no changes

Example 2: Address with Walking

User: "I need to go from Kalendegatan 12 in Malmö to Emporia"

./search-location.sh "Kalendegatan 12, Malmö"
./search-location.sh "Emporia"
./journey.sh "55.595#13.001" LOCATION "55.563#12.973" LOCATION

Response:

🏠 **Leave at 10:05**

🚶 Walk 320m to Möllevångstorget (~3 min)

📍 **Möllevångstorget** → 🎯 **Emporia**
🚌 Bus 32 departs 10:10
🏁 Arrives 10:28 at Emporia

🚶 Walk 150m to destination (~2 min)

⏱️ Total: 25 min

Example 3: Arrive By Time

User: "I need to be at Copenhagen central by 18:00 tomorrow"

./search-location.sh "Malmö C"
./search-location.sh "København H"
./journey.sh 9021012080000000 STOP_AREA 9921000008600626 STOP_AREA "tomorrow 18:00" arrive

Response:

🎯 **Arrive by 18:00** at København H

📍 **Malmö C** → 🎯 **København H**
🚂 Öresundståg departs **17:21** [🛤️ Spår 1]
🏁 Arrives **17:56** ✅ 4 min buffer

⏱️ Journey: 35 min

💡 Leave Malmö C by 17:21 to arrive on time!

Example 4: Around Time Query

User: "I want to travel to Lund around 15:00"

# Query 30 min earlier to show options around 15:00
./journey.sh 9021012080000000 STOP_AREA 9021012080040000 STOP_AREA "14:30"

Response:

Options around 15:00 for Malmö C → Lund C:

**Option 1 - Depart 14:34** (in 25m)
🚂 Pågatåg → arrives 14:52
⏱️ 18 min

**Option 2 - Depart 14:49** (in 40m)
🚂 Öresundståg → arrives 15:01
⏱️ 12 min

**Option 3 - Depart 15:04** (in 55m) ✅ Closest to 15:00
🚂 Pågatåg → arrives 15:22
⏱️ 18 min

Which works best for you?

Example 5: Relative Time

User: "I want to leave in about an hour"

# Current time: 13:00, so query for 14:00
./journey.sh ... "14:00"

Response:

Options departing around 14:00 (in ~1h):

**Leave at 13:55** (in 55m)
🚶 5 min walk → 🚌 Bus 5 at 14:02 → arrives 14:25

**Leave at 14:10** (in 1h 10m)
🚶 5 min walk → 🚂 Train at 14:17 → arrives 14:35

Let me know which one works!

Example 6: Journey with Delays

When tool output shows delays:

From: 14:30 Malmö C [+8 min late]

Response:

📍 **Malmö C** → 🎯 **Lund C**
🚂 Öresundståg 1042
⚠️ **Running 8 min late**
🕐 Scheduled: 14:30 → Expected: ~14:38
🏁 Arrives ~14:50 (normally 14:42)

When to Ask Clarifying Questions

Always ask when:

Search returns no results:
- "I couldn't find [location]. Could you provide more details like the full address or nearby landmarks?"
Multiple plausible matches:
- "I found several locations matching '[query]': [list]. Which one did you mean?"
Result name very different from query:
- "You asked for '[user query]' but the closest match I found is '[result name]'. Is this correct?"
User request is vague:
- "From Malmö" - "Which location in Malmö? The central station (Malmö C), or a specific address?"
Cross-border ambiguity:
- "Copenhagen" could mean different stations - confirm if they want København H (central), Airport, or another station.
Time is unclear:
- "When do you want to travel? Now, or at a specific time?"

DateTime Formats

All times are Swedish local time (CET/CEST).

Format	Example	Meaning
(empty)		Travel now
`HH:MM`	`"18:30"`	Today at 18:30
`tomorrow HH:MM`	`"tomorrow 09:00"`	Tomorrow at 09:00
`YYYY-MM-DD HH:MM`	`"2026-01-15 09:00"`	Specific date

Output Format

Journey Option (Raw Tool Output)

══════════════════════════════════════════════════════════════
OPTION 1: Malmö C → Lund C
══════════════════════════════════════════════════════════════
Date:    2026-01-14
Depart:  09:04
Arrive:  09:16
Changes: 0

LEGS:
  → ORESUND Öresundståg 1324
    From: 09:04 Malmö C [Spår 2b]
    To:   09:16 Lund C [Spår 1]
    Direction: mot Helsingborg C

Transport Types

Type	Emoji	Description
`TRAIN`	🚂	Pågatåg (regional train)
`ORESUND`	🚂	Öresundståg (cross-border train)
`BUS`	🚌	City or regional bus
`WALK`	🚶	Walking segment
`TRAM`	🚋	Tram/light rail
`METRO`	🚇	Copenhagen Metro
`FERRY`	⛴️	Ferry

Status Indicators

Indicator	Emoji	Meaning
(none)	✅	On time
`[+X min late]`	⚠️	Delayed
`[-X min early]`	ℹ️	Running early
`[PASSED]`	❌	Already departed
`AVVIKELSE`	🚨	Service disruption

Error Handling

"No locations found"

The search returned no results.

Strategies:

Check spelling (Swedish: å, ä, ö)
Try official station names with "C" for central
For landmarks, remove city suffix
For addresses, add city name
Ask user for clarification

"No journeys found"

No routes available.

Strategies:

Check if service operates at that hour (late night/early morning limited)
Try different departure time
Suggest alternative nearby stops

Quick Reference

Location Type	Search Format	Journey Type
Train station	`"Malmö C"`	STOP_AREA
Bus stop	`"Möllevångstorget"`	STOP_AREA
Address	`"Street 12, City"`	Use coords → LOCATION
Landmark/POI	`"Emporia"` (no city!)	Use coords → LOCATION
Coordinates	`55.605#13.003`	LOCATION

skanetrafiken

Skånetrafiken Trip Planner

Commands

1. Search Location