Pular para o conteúdo principal

API de integração com o Guru Maps

O Guru Maps aceita os esquemas guru:// e geo: para integração com outros aplicativos. Eles podem iniciar importações, pesquisas, navegação e gravações de trajetos, além de salvar a localização atual.

Abrir o Guru Maps​

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

Parâmetros:

  • back_url — se estiver definido, o aplicativo abrirá essa URL quando o usuário pressionar Escape.

Exemplos:

  1. guru: — abre o Guru Maps sem interromper a ação em andamento.
  2. guru:?back_url=https://gurumaps.app — abre o Guru Maps e, ao pressionar Escape, abre https://gurumaps.app.

Importar um arquivo​

API: guru://open?url=<url do arquivo>

Parâmetros:

  • url — endereço do arquivo que será importado.

O Guru Maps baixa o arquivo da URL e tenta importá-lo. Formatos compatíveis: GPX, KML, KMZ, WPT, PLT, TCX, MS, GeoJSON, MapCSS, SQLITEDB e MBTILES.

Exemplos:

  1. guru://open?url=https://gurumaps.app/example/feature_collection.geojson — importa um arquivo GeoJSON.
  2. guru://open?url=https://ms.gurumaps.app/ms/google/Google_Satellite_RU_HD.ms — importa uma fonte de mapa de satélite.

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

Parâmetros:

  • q — texto da pesquisa;
  • coord — coordenadas do ponto ao redor do qual a pesquisa será feita, no formato lat,lon. Se não forem informadas, será usada a posição atual do mapa;
  • back_url — se estiver definido, o aplicativo abrirá essa URL quando o usuário pressionar Escape.

Exemplos:

  1. guru://search?q=Wybrzeże%20Kościuszkowskie%2020%20Warszawa&coord=52.2297,21.0122 — pesquisa o endereço com o mapa centralizado nas coordenadas informadas.
  2. guru://search?q=Agrykola%201%20Warszawa — pesquisa o endereço a partir da posição atual do 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 do destino;
  • via — coordenadas de um ponto intermediário; pode ser usado várias vezes;
  • start — coordenadas do ponto de partida; se não forem informadas, será usada a localização atual;
  • mode — meio de transporte: auto, bicycle, pedestrian, motor_scooter, motorcycle, truck ou straight. O padrão é auto;
  • start_navigation — com true, a navegação começa assim que o itinerário é calculado. Sem o parâmetro ou com false, aparece a tela de prévia e edição;
  • back_url — se estiver definido, o aplicativo abrirá essa URL quando o usuário pressionar Escape.

Exemplos:

  1. Criar um itinerário da posição atual até um ponto: guru://nav?finish=52.2297,21.0122
  2. Criar um itinerário entre dois pontos: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222
  3. Adicionar um ponto intermediário: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172
  4. Adicionar dois pontos intermediários: guru://nav?start=52.2297,21.0122&via=52.2347,21.0172&via=52.2765,21.234&finish=52.2397,21.0222
  5. Criar um itinerário de bicicleta: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle
  6. Criar o itinerário e iniciar a navegação: guru://nav?start=52.2297,21.0122&finish=52.2397,21.0222&via=52.2347,21.0172&mode=bicycle&start_navigation=true
  7. Voltar a uma URL ao pressionar Escape: guru://nav?finish=52.2297,21.0122&back_url=https://gurumaps.app
  8. Iniciar a navegação e voltar a uma URL ao pressionar Escape: guru://nav?finish=52.2297,21.0122&start_navigation=true&back_url=https://gurumaps.app

Iniciar, parar ou alternar a gravação​

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

Parâmetros:

  • action — define a ação: start, stop ou toggle.

Exemplos:

  1. guru://recordTrack?action=start — inicia a gravação no Guru Maps.
  2. guru://recordTrack?action=stop — encerra a gravação em andamento.
  3. guru://recordTrack?action=toggle — para a gravação atual ou inicia uma nova.
observação

Se a ação for inválida ou não for informada, a API usará toggle. Portanto, guru://recordTrack funciona como guru://recordTrack?action=toggle.

Criar um marcador​

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

Depois de criar o marcador, o Guru Maps abre a tela de detalhes.

Parâmetros:

  • name — nome do marcador; se não for informado, será preenchido automaticamente;
  • coord — coordenadas do marcador; se não forem informadas, será usada a localização atual.

Exemplos:

  1. Criar um marcador na localização atual: guru://saveMarker
  2. Criar um marcador com nome na localização atual: guru://saveMarker?name=MyMarker
  3. Criar um marcador em uma posição: guru://saveMarker?coord=52.2297,21.0122
  4. Criar um marcador com nome em uma posição: guru://saveMarker?name=MyMarker&coord=52.2297,21.0122

Mostrar no mapa um lugar definido por coordenadas​

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

Parâmetros:

  • place — coordenadas do lugar que será mostrado;
  • zoom — opcional; escala usada para mostrar o ponto. Se não for informado, será usado o zoom atual;
  • back_url — opcional; se estiver definido, o aplicativo abrirá essa URL quando o usuário pressionar Escape.

Exemplos:

  1. guru://show?place=52.2297,21.0122 — abre o Guru Maps no ponto informado.
  2. guru://show?place=52.2297,21.0122,17 — mostra o ponto no nível de zoom 17.
  3. guru://show?place=52.2297,21.0122&back_url=https://gurumaps.app — mostra o ponto e abre a URL ao pressionar Escape.
observação

O Guru Maps também aceita o esquema geo:. Use, por exemplo, geo:52.2297,21.0122 para mostrar um lugar no mapa. Esse esquema não oferece o parâmetro back_url; para isso, use guru://.