Vorhandene Daten importieren

Wir importieren deine Daten kostenlos

Du hast Karten und Bahnen in einem anderen System und keine Zeit für ein Skript? Wir helfen dir kostenlos, sie nach Checkpoint zu holen — schreib uns einfach eine E-Mail an support@checkpointrun.com oder eine Nachricht im Bereich Import.

Diese Seite handelt von Daten, die es anderswo schon gibt: Karten, die Ihr Verein über die Jahre georeferenziert hat, Bahnen aus anderer Software, ein ganzes Archiv auf einem RouteGadget-Server. Statt alles von Hand neu anzulegen, können Sie es per Skript über die API nach Checkpoint übertragen.

Fragen zum Import?

Fragen, Vorschläge und Erfahrungen gehören in den Bereich Import des Feedback-Boards – er öffnet sich mit dem Thema Import bereits ausgewählt.

Was die API bietet

Alles, was die App kann, kann auch ein Skript – mit demselben Konto und denselben Rechten. Für einen Import sind das die wichtigen Teile:

• Vereine – POST /api/clubs legt den Verein an, zu dem die importierten Karten und Bahnen gehören.
• Karten – POST /api/maps lädt ein Kartenbild zusammen mit Breite und Länge seiner vier Ecken hoch; mehr braucht Checkpoint nicht, um es aufs Gelände zu legen. Eine Karte kann auch ohne Bild beginnen und später mit PUT /api/maps/{id}/georeference georeferenziert werden.
• Bahnen – POST /api/courses legt eine Bahn auf einer Karte aus den Koordinaten ihrer Posten an. Liegen Ihre Bahnen schon als IOF XML (v2 oder v3) oder MapRun KML vor, liest POST /api/courses/import die Datei und liefert die Posten speicherfertig zurück.

Alle Parameter finden Sie im OpenAPI-Browser. Beachten Sie das Limit von 100 Anfragen pro Minute: Takten Sie einen großen Import, statt nach einem 429 erneut zu versuchen.

Beispiele

Funktionierende Beispiele liegen in Checkpoint-io/Checkpoint-Samples auf GitHub. Sie stehen unter CC0 – kopieren und anpassen ist ausdrücklich erlaubt.

RouteGadget: alle georeferenzierten Karten mit ihren Bahnen

Import/RouteGadget/import-routegadget.mjs übernimmt alle georeferenzierten Karten eines RouteGadget-Servers mit den Bahnen aller dort gelaufenen Wettkämpfe und legt sie in einem neuen Verein auf Checkpoint an:

1. Es liest die Liste der Karten und Wettkämpfe des Servers.
2. Es rechnet die Georeferenzierung jeder Karte in die reale Lage der vier Bildecken um und die Posten jeder Bahn von Positionen auf dem Bild in Breite und Länge.
3. Es legt den Verein an, lädt jede Karte hoch und erstellt ihre Bahnen.

Nicht georeferenzierte Karten werden übersprungen: Ohne reale Koordinaten gibt es nichts, was sich aufs Gelände legen ließe.

Setzen Sie zum Ausführen die Konstanten am Anfang der Datei – E-Mail und Passwort Ihres Checkpoint-Kontos, einen Namen für den neuen Verein und die Adressen Ihres RouteGadget-Servers (das Beispiel zeigt auf einen von British Orienteering) – und starten Sie es dann mit Node.js 20 oder neuer:

node import-routegadget.mjs

Es taktet seine Anfragen selbst, um unter dem Limit zu bleiben; ein großes Archiv dauert also eine Weile.

Importieren Sie nur Karten und Bahnen, die Sie veröffentlichen dürfen. Eine Karte gehört dem Verein oder Kartografen, der sie erstellt hat – ob sie auf einem öffentlichen Server liegt oder nicht.

Mitmachen

Sie haben einen Import für ein anderes Werkzeug geschrieben – OCAD, Purple Pen, Condes, Livelox, das Archiv Ihres Vereins? Beiträge zum Beispiel-Repository sind willkommen: Öffnen Sie einen Pull Request, er hilft dem nächsten Verein beim selben Umzug.

Braucht ein Import etwas, das die API noch nicht kann, oder möchten Sie Hilfe bei einer Migration, schreiben Sie es uns im Bereich Import des Feedback-Boards.