Add plan_tour() for creating planned tours

[sebastianzabel]

Summary

• Adds plan_tour() method to KomootConnector that creates planned tours (not recorded tours)
• Uses Komoot's internal routing API (same as the web-based route planner) to route between waypoints
• Two-step process: route via /api/routing/tour, then save via /api/v007/tours/ as tour_planned

Motivation

Currently upload_tour() can only create recorded tours from GPX/FIT files. There is no way to programmatically create a planned tour — the kind you'd create in Komoot's web route planner. This is useful for automated route planning, batch tour creation, and integration with external tools.

Usage

from kompy import KomootConnector

k = KomootConnector("email", "password")
result = k.plan_tour(
    waypoints=[
        {"lat": 53.14, "lng": 8.21},
        {"lat": 53.08, "lng": 8.31},
        {"lat": 53.14, "lng": 8.21},
    ],
    tour_name="Weekend Loop",
    sport="racebike",
)
print(result["url"])  # https://www.komoot.com/tour/123456

Parameters

Parameter	Type	Default	Description
waypoints	List[Dict]	required	List of {"lat": float, "lng": float} dicts (min. 2)
tour_name	str	required	Name of the planned tour
sport	str	"racebike"	Sport type (any SupportedActivities value)
constitution	int	3	Fitness level 1-5
date	str	now	ISO date string for the planned tour
status	str	"friends"	Privacy status

Returns

{
    "tour_id": 123456,
    "url": "https://www.komoot.com/tour/123456",
    "distance": 29.6,   # km
    "duration": 77,      # minutes
    "type": "tour_planned",
    "name": "Weekend Loop",
}

Test plan

• Tested with real Komoot account — tours appear as planned tours in the app
• Verified routing works for racebike, multiple waypoints, round trips
• Unit tests (not yet added)

🤖 Generated with Claude Code

[sebastianzabel]

@Tsadoq would be nice if you can approve my pr :-)

[Tsadoq]

@Tsadoq would be nice if you can approve my pr :-)

Sorry for delay, approved