Importar datos existentes

Esta página trata de datos que ya existen en otro sitio: mapas que su club ha georreferenciado a lo largo de los años, recorridos trazados con otros programas, todo un archivo en un servidor RouteGadget. En lugar de volver a crearlo a mano, puede trasladarlo a Checkpoint con un script que use la API.

Qué ofrece la API

Todo lo que hace la aplicación también puede hacerlo un script, con la misma cuenta y los mismos permisos. Para una importación, lo útil es:

Clubes: POST /api/clubs crea el club al que pertenecerán los mapas y recorridos importados.
Mapas: POST /api/maps sube la imagen de un mapa junto con la latitud y la longitud de sus cuatro esquinas, que es todo lo que Checkpoint necesita para colocarlo sobre el terreno. Un mapa también puede crearse sin imagen y georreferenciarse después con PUT /api/maps/{id}/georeference.
Recorridos: POST /api/courses crea un recorrido sobre un mapa a partir de las coordenadas de sus controles. Si sus recorridos ya están en IOF XML (v2 o v3) o MapRun KML, POST /api/courses/import lee el archivo y devuelve los controles, listos para guardar.

Todos los parámetros están en el navegador OpenAPI. Tenga en cuenta el límite de 100 peticiones por minuto: dosifique una importación grande en lugar de reintentar tras un 429.

Ejemplos

Hay ejemplos que funcionan en Checkpoint-io/Checkpoint-Samples en GitHub. Se publican bajo CC0, así que puede copiarlos y adaptarlos libremente.

RouteGadget: todos los mapas georreferenciados y sus recorridos

Import/RouteGadget/import-routegadget.mjs toma todos los mapas georreferenciados de un servidor RouteGadget, con los recorridos de cada carrera celebrada en ellos, y los vuelve a crear en un club nuevo en Checkpoint:

Lee la lista de mapas y carreras del servidor.
Convierte la georreferencia de cada mapa en la posición real de las cuatro esquinas de la imagen, y los controles de cada recorrido, de posiciones en la imagen a latitud y longitud.
Crea el club, sube cada mapa y crea sus recorridos.

Los mapas sin georreferenciar se omiten: sin coordenadas reales no hay nada que colocar sobre el terreno.

Para ejecutarlo, rellene las constantes del principio del archivo —el correo y la contraseña de su cuenta de Checkpoint, un nombre para el club nuevo y las direcciones de su servidor RouteGadget (el ejemplo apunta a uno de British Orienteering)— y, con Node.js 20 o posterior:

node import-routegadget.mjs

Espacia sus propias peticiones para no superar el límite, así que un archivo grande tarda un rato.

Importe solo mapas y recorridos que tenga derecho a publicar. Un mapa pertenece al club o al cartógrafo que lo hizo, esté o no en un servidor público.

Colabore

¿Ha escrito un importador para otra herramienta: OCAD, Purple Pen, Condes, Livelox, el archivo de su club? Las contribuciones al repositorio de ejemplos son bienvenidas: abra un pull request y ayudará al próximo club que haga el mismo cambio.

Si una importación necesita algo que la API aún no hace, o quiere ayuda con una migración, cuéntenoslo en la sección Importación del tablero de sugerencias.