komoot-client
Inhalt der Doku

komoot-client · Doku

Verwendung

Touren mit komoot-client laden, filtern, Koordinaten nachladen und als JSON speichern.

Auf dieser Seite

Anmelden und Touren laden

Die Anmeldung passiert automatisch bei der ersten Abfrage. Zugangsdaten gehören in Umgebungsvariablen, nicht in den Code:

import Client from '@dasred/komoot-client';

const client = new Client({
    email:    process.env.KOMOOT_EMAIL,
    password: process.env.KOMOOT_PASSWORD,
});

const tours = await client.toursMade({});
console.log(`${tours.length} Touren`);

Wichtig

toursMade() braucht immer ein Objekt, auch ein leeres. Ohne Argument bricht der Aufruf mit einem TypeError ab.

Filtern und sortieren

const tours = await client.toursMade({
    sportTypes:    'touringbicycle',
    startDate:     '2026-01-01T00:00:00.000Z',
    sortDirection: 'desc',
});
  • sportTypes ist der Sport-Schlüssel von komoot, etwa touringbicycle, mtb, racebike oder hike.
  • startDate ignoriert alle Touren vor diesem Zeitpunkt (ISO-8601).
  • sortDirection ist asc (älteste zuerst, Standard) oder desc.

Der Client lädt die Touren seitenweise zu je 50, bis komoot keine mehr liefert. Bei vielen Touren dauert das ein paar Sekunden.

Werte einer Tour

const [tour] = await client.toursMade({sortDirection: 'desc'});

console.log(tour.name);
console.log(`${tour.distance.toFixed(1)} km in ${tour.duration.inMotion.toFixed(2)} h`);
console.log(`Ø ${tour.speed.inMotion.toFixed(1)} km/h, ${tour.elevation.up} m bergauf`);

Alle Felder mit Einheiten stehen unter Optionen.

Koordinaten nachladen

Die Strecke steckt nicht in der Tourliste, sie wird je Tour eigens abgefragt. Dafür übergibst du den Client:

const coordinates = await tour.getCoordinates(client);

console.log(coordinates.length, 'Punkte');
console.log(coordinates[0].lat, coordinates[0].lng, coordinates[0].alt);

Das Ergebnis wird in der Tour zwischengespeichert. Ein zweiter Aufruf fragt komoot nicht noch einmal.

Als JSON speichern

Tour und Coordinate haben ein eigenes toJSON(). Datumswerte werden zu ISO-Strings, die Koordinaten der Strecke sind nicht enthalten:

import fs from 'node:fs';

fs.writeFileSync('tours.json', JSON.stringify(tours, null, 4));

Eigene Header

Mit headers hängst du jeder Anfrage weitere HTTP-Header an, zum Beispiel einen eigenen User-Agent:

const client = new Client({
    email:    process.env.KOMOOT_EMAIL,
    password: process.env.KOMOOT_PASSWORD,
    headers:  {'User-Agent': 'meine-app/1.0'},
});