Saltar al contenido principal

API de integración con Guru Maps

Guru Maps admite los esquemas guru:// y geo:// para integrarse con otras aplicaciones. Permiten iniciar importaciones, búsquedas y navegación, controlar la grabación de pistas y guardar la ubicación actual.

Abrir Guru Maps​

API: guru:[?back_url=<url>]

Parámetros:

  • back_url: si se especifica y el usuario pulsa Escape, la aplicación abre la URL de retorno indicada.

Ejemplos:

  1. guru: — abre Guru Maps sin interrumpir la acción actual.
  2. guru:?back_url=https://gurumaps.app — abre Guru Maps y, al pulsar Escape, abre https://gurumaps.app.

Importar un archivo​

API: guru://open?url=<url del archivo>

Parámetros:

  • url: enlace al archivo que se va a importar.

Guru Maps descarga el archivo e intenta importarlo. Formatos compatibles: GPX, KML, KMZ, WPT, PLT, TCX, MS, GeoJSON, MapCSS, SQLITEDB y MBTILES.

Ejemplos:

  1. guru://open?url=https://gurumaps.app/example/feature_collection.geojson — importa un archivo GeoJSON desde el enlace.
  2. guru://open?url=https://ms.gurumaps.app/ms/google/Google_Satellite_RU_HD.ms — importa una fuente de mapa por satélite.

Búsqueda​

API: guru://search?q=<consulta>[&coord=lat,lon][&back_url=<url>][&back_url=<url>]

Parámetros:

  • q: texto de la búsqueda;
  • coord: coordenadas lat,lon del punto alrededor del cual se buscará. Si se omite, se utiliza la posición actual del mapa;
  • back_url: si se especifica y el usuario pulsa Escape, se abre la URL indicada.

Ejemplos:

  1. guru://search?q=Wybrzeże%20Kościuszkowskie%2020%20Warszawa&coord=52.2297,21.0122 — busca «Wybrzeże Kościuszkowskie 20 Warszawa» con el mapa centrado en las coordenadas indicadas.
  2. guru://search?q=Agrykola%201%20Warszawa — busca «Agrykola 1 Warszawa» desde la posición actual del mapa.

API: guru://nav?finish=lat,lon[&via=lat,lon][&start=lat,lon][&mode=<auto, bicycle, pedestrian, motor_scooter, motorcycle, truck, straight>][&start_navigation=<true,false>][&back_url=<url>]

Parámetros:

  • finish: coordenadas del destino;
  • via: coordenadas de un punto intermedio. Se puede repetir para añadir varios;
  • start: coordenadas del punto de partida. Si se omite, se utiliza la ubicación actual;
  • mode: medio de transporte (auto, bicycle, pedestrian, motor_scooter, motorcycle, truck o straight). El valor predeterminado es auto;
  • start_navigation: con true, inicia la navegación en cuanto se calcula el itinerario. Si falta o vale false, muestra la vista previa y edición;
  • back_url: si se especifica y el usuario pulsa Escape, se abre la URL indicada.

Ejemplos:

  1. Crear un itinerario desde la ubicación actual: guru://nav?finish=52.2297,21.0122
  2. Crear un itinerario entre dos puntos: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222
  3. Añadir un punto intermedio: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172
  4. Añadir dos puntos intermedios: guru://nav?start=52.2297,21.0122&via=52.2347,21.0172&via=52.2765,21.234&finish=52.2397,21.0222
  5. Crear un itinerario en bicicleta: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle
  6. Crear el itinerario e iniciar la navegación: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle&start_navigation=true
  7. Volver a una URL al pulsar Escape: guru://nav?finish=52.2297,21.0122&back_url=https://gurumaps.app
  8. Iniciar la navegación y volver a una URL al pulsar Escape: guru://nav?finish=52.2297,21.0122&start_navigation=true&back_url=https://gurumaps.app

Iniciar, detener o alternar la grabación de una pista​

API: guru://recordTrack?action=<start,stop,toggle>

Parámetros:

  • action: acción para la grabación; puede ser start, stop o toggle.

Ejemplos:

  1. guru://recordTrack?action=start — inicia la grabación de una pista GPS.
  2. guru://recordTrack?action=stop — detiene la grabación en curso.
  3. guru://recordTrack?action=toggle — cambia el estado: detiene la grabación activa o inicia una nueva.
nota

Si falta action o su valor no es válido, la API utiliza toggle. Por tanto, guru://recordTrack se comporta igual que guru://recordTrack?action=toggle.

Crear un marcador​

API: guru://saveMarker[?name=<nombre del marcador>][&coord=lat,lon]

Después de crear el marcador, Guru Maps abre su pantalla de detalles.

Parámetros:

  • name: nombre del marcador. Si se omite, se completa automáticamente;
  • coord: coordenadas del marcador. Si se omite, se utiliza la ubicación actual.

Ejemplos:

  1. Crear un marcador en la ubicación actual: guru://saveMarker
  2. Crear un marcador con un nombre: guru://saveMarker?name=MyMarker
  3. Crear un marcador en unas coordenadas: guru://saveMarker?coord=52.2297,21.0122
  4. Crear un marcador con nombre y coordenadas: guru://saveMarker?name=MyMarker&coord=52.2297,21.0122

Mostrar un lugar mediante sus coordenadas​

API: guru://show?place=lat,lon[,zoom][&back_url=<url>]

Parámetros:

  • place: coordenadas del lugar que se mostrará;
  • zoom: opcional; nivel de zoom. Si se omite, se conserva la escala actual;
  • back_url: opcional; URL que se abre al pulsar Escape.

Ejemplos:

  1. guru://show?place=52.2297,21.0122 — abre Guru Maps y muestra el punto indicado.
  2. guru://show?place=52.2297,21.0122,17 — muestra el punto con un nivel de zoom de 17.
  3. guru://show?place=52.2297,21.0122&back_url=https://gurumaps.app — muestra el punto y abre https://gurumaps.app al pulsar Escape.
nota

Guru Maps también admite el esquema geo:. Por ejemplo, geo:52.2297,21.0122 muestra una ubicación concreta en el mapa. Sin embargo, geo: no admite back_url; para esa función debes utilizar guru://.