Aller au contenu principal

API d’intégration de Guru Maps

Guru Maps prend en charge les schémas d’URL guru:// et geo:// pour communiquer avec d’autres applications. Celles-ci peuvent importer des fichiers, effectuer des recherches, démarrer la navigation, contrôler l’enregistrement d’une trace et enregistrer la position actuelle.

Ouvrir Guru Maps​

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

Paramètres :

  • back_url – URL ouverte lorsque l’utilisateur appuie sur Échap.

Exemples :

  1. guru: – ouvre Guru Maps sans interrompre l’action en cours.
  2. guru:?back_url=https://gurumaps.app – ouvre Guru Maps, puis https://gurumaps.app lorsque l’utilisateur appuie sur Échap.

Importer un fichier​

API : guru://open?url=<url du fichier>

Paramètres :

  • url – URL du fichier à importer.

Guru Maps télécharge le fichier depuis l’URL indiquée et tente de l’importer. Formats pris en charge : GPX, KML, KMZ, WPT, PLT, TCX, MS, GeoJSON, MapCSS, SQLITEDB et MBTILES.

Exemples :

  1. guru://open?url=https://gurumaps.app/example/feature_collection.geojson – importe un fichier GeoJSON.
  2. guru://open?url=https://ms.gurumaps.app/ms/google/Google_Satellite_RU_HD.ms – importe une source de carte satellite.

Recherche​

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

Paramètres :

  • q – requête de recherche.
  • coord – coordonnées du point autour duquel effectuer la recherche, au format lat,lon. Sans ce paramètre, la recherche commence à la position actuelle de la carte.
  • back_url – URL ouverte lorsque l’utilisateur appuie sur Échap.

Exemples :

  1. guru://search?q=Wybrzeże%20Kościuszkowskie%2020%20Warszawa&coord=52.2297,21.0122 – recherche « Wybrzeże Kościuszkowskie 20 Warszawa » et centre la carte sur les coordonnées indiquées.
  2. guru://search?q=Agrykola%201%20Warszawa – recherche « Agrykola 1 Warszawa » à partir de la position actuelle de la carte.

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>]

Paramètres :

  • finish – coordonnées de la destination de l’itinéraire.
  • via – coordonnées d’une étape ; ce paramètre peut être répété.
  • start – coordonnées du point de départ. Sans ce paramètre, la position actuelle est utilisée.
  • mode – mode de déplacement : auto, bicycle, pedestrian, motor_scooter, motorcycle, truck ou straight. La valeur par défaut est auto.
  • start_navigation – avec true, la navigation démarre dès que l’itinéraire est calculé. Avec false ou sans ce paramètre, l’aperçu s’ouvre pour permettre de modifier l’itinéraire.
  • back_url – URL ouverte lorsque l’utilisateur appuie sur Échap.

Exemples :

  1. Itinéraire depuis la position actuelle vers un point : guru://nav?finish=52.2297,21.0122
  2. Itinéraire entre deux points donnés : guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222
  3. Itinéraire avec une étape : guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172
  4. Itinéraire avec deux étapes : guru://nav?start=52.2297,21.0122&via=52.2347,21.0172&via=52.2765,21.234&finish=52.2397,21.0222
  5. Itinéraire à vélo : guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle
  6. Calculer l’itinéraire et démarrer immédiatement la navigation : guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle&start_navigation=true
  7. Calculer l’itinéraire et revenir à une URL avec Échap : guru://nav?finish=52.2297,21.0122&back_url=https://gurumaps.app
  8. Démarrer la navigation et revenir à une URL avec Échap : guru://nav?finish=52.2297,21.0122&start_navigation=true&back_url=https://gurumaps.app

Démarrer, arrêter ou basculer l’enregistrement d’une trace​

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

Paramètres :

  • action – action appliquée à l’enregistrement : start, stop ou toggle.

Exemples :

  1. guru://recordTrack?action=start – démarre l’enregistrement d’une trace dans Guru Maps.
  2. guru://recordTrack?action=stop – arrête l’enregistrement en cours.
  3. guru://recordTrack?action=toggle – bascule l’état : arrête l’enregistrement en cours ou en démarre un nouveau.
remarque

Si l’action est absente ou incorrecte, l’API utilise toggle. guru://recordTrack se comporte donc comme guru://recordTrack?action=toggle.

Créer un favori​

API : guru://saveMarker[?name=<nom du favori>][&coord=lat,lon]

Après sa création, Guru Maps ouvre les détails du favori.

Paramètres :

  • name – nom du favori ; il est généré automatiquement si ce paramètre est absent.
  • coord – coordonnées du favori ; la position actuelle est utilisée si ce paramètre est absent.

Exemples :

  1. Favori à la position actuelle : guru://saveMarker
  2. Favori nommé à la position actuelle : guru://saveMarker?name=MyMarker
  3. Favori à un emplacement donné : guru://saveMarker?coord=52.2297,21.0122
  4. Favori nommé à un emplacement donné : guru://saveMarker?name=MyMarker&coord=52.2297,21.0122

Afficher sur la carte un lieu défini par ses coordonnées​

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

Paramètres :

  • place – coordonnées du lieu à afficher.
  • zoom – niveau de zoom facultatif. Sans ce paramètre, le niveau actuel est conservé.
  • back_url – URL facultative ouverte lorsque l’utilisateur appuie sur Échap.

Exemples :

  1. guru://show?place=52.2297,21.0122 – ouvre Guru Maps et affiche le point.
  2. guru://show?place=52.2297,21.0122,17 – affiche le point avec un niveau de zoom de 17.
  3. guru://show?place=52.2297,21.0122&back_url=https://gurumaps.app – affiche le point et ouvre https://gurumaps.app lorsque l’utilisateur appuie sur Échap.
remarque

Guru Maps prend également en charge le schéma geo:, par exemple geo:52.2297,21.0122. Celui-ci ne connaît toutefois pas le paramètre back_url. Utilisez le schéma guru:// si vous en avez besoin.