Iniciar o aplicativo Mapas do Windows

Saiba como iniciar o app Mapas do Windows a partir de seu app. Este tópico descreve os esquemas de URI (Uniform Resource Identifier) bingmaps:, ms-drive-to:, ms-walk-to: e ms-settings:. Use esses esquemas de URI para iniciar o aplicativo Mapas do Windows para mapas, direções e resultados da busca específicos ou para baixar mapas offline do Mapas do Windows do aplicativo Configurações.

Dica Para saber mais sobre como iniciar o aplicativo Mapas do Windows no seu aplicativo, baixe o exemplo de mapa da Plataforma Universal do Windows (UWP) do repositório de exemplos universais do Windows no GitHub.

Introdução aos URIs

Os esquemas de URI permitem que você abra aplicativos clicando em hiperlinks (ou programaticamente, no seu aplicativo). Assim como você pode iniciar um novo email usando mailto: ou abrir um navegador da Web usando http:, você pode abrir o aplicativo de mapas do Windows usando bingmaps:, ms-drive-to: e ms-walk-to:.

• O URI bingmaps: fornece mapas para localizações, resultados da busca, trajetos e tráfego.
• O URI ms-drive-to: fornece trajetos de automóvel curva a curva começando na sua localização atual.
• O URI ms-walk-to: fornece trajeto a pé curva a curva começando na sua localização atual.

Por exemplo, o URI a seguir abre o aplicativo Mapas do Windows e exibe um mapa centralizado sobre a cidade de Nova York.

<bingmaps:?cp=40.726966~-74.006076>

Veja uma descrição do esquema de URI:

bingmaps:?query

Neste esquema de URI, query é uma série de pares nome/valor de parâmetro:

¶m1=value1¶m2=value2 …

Para obter uma lista completa dos parâmetros disponíveis, consulte a referência de parâmetros bingmaps:, ms-drive-to: e ms-walk-to:. Também existem exemplos mais adiante neste tópico.

Iniciar um URI no seu aplicativo

Para iniciar o aplicativo Mapas do Windows no seu aplicativo, chame o método LaunchUriAsync com um URI bingmaps:, ms-drive-to: ou ms-walk-to:. O exemplo a seguir inicia o mesmo URI do exemplo anterior. Para obter mais informações sobre como iniciar aplicativos em URIs, consulte Iniciar o app padrão para um URI.

// Center on New York City
var uriNewYork = new Uri(@"bingmaps:?cp=40.726966~-74.006076");

// Launch the Windows Maps app
var launcherOptions = new Windows.System.LauncherOptions();
launcherOptions.TargetApplicationPackageFamilyName = "Microsoft.WindowsMaps_8wekyb3d8bbwe";
var success = await Windows.System.Launcher.LaunchUriAsync(uriNewYork, launcherOptions);

Neste exemplo, a classe LauncherOptions é usada para ajudar a garantir que o aplicativo Mapas do Windows seja iniciado.

Exibir localizações conhecidas

Há muitas opções para controlar qual parte do mapa será mostrada. Você pode usar o parâmetro cp (ponto central) com os parâmetros rad (raio) ou lvl (nível de zoom) para mostrar uma localização e escolher a distância para aplicar mais zoom a ele. Ao usar o parâmetro cp, você também pode especificar um hdg (título) e um pit (rotação sobre o eixo x) para controlar a direção a ser olhada. Outro método é usar o parâmetro bb (caixa delimitadora) para fornecer as coordenadas máximas sul, leste, norte e oeste da área que você deseja mostrar.

Para controlar o tipo de exibição, use os parâmetros sty (estilo) e ss (Streetside). O parâmetro sty permite alternar entre as vistas de estrada e aérea. O parâmetro ss coloca o mapa em uma exibição Streetside. Para obter mais informações sobre esses e outros parâmetros, consulte a referência de parâmetro bingmaps:.

Exibir os resultados da pesquisa

Ao pesquisar lugares usando o parâmetro q, recomendamos tornar os termos o mais específicos possível e usar os parâmetros cp, bb ou where para especificar uma localização de pesquisa. Se você não especificar uma localização de pesquisa e a localização atual do usuário não estiver disponível, a pesquisa talvez não retorne resultados significativos. Os resultados da busca são exibidos na visualização de mapa mais apropriada. Para obter mais informações sobre esses e outros parâmetros, consulte a referência de parâmetro bingmaps:.

Exibir vários pontos

Use o parâmetro collection para mostrar um conjunto personalizado de pontos no mapa. Se houver mais de um ponto, será exibida uma lista de pontos. Pode haver até 25 pontos em uma coleção, listados na ordem fornecida. A coleção tem precedência sobre as solicitações de pesquisa e trajetos. Para obter mais informações sobre esse e outros parâmetros, consulte a referência de parâmetro bingmaps:.

Exibir trajetos e tráfego

Você pode exibir trajetos entre dois pontos usando o parâmetro rtp. Esses pontos podem ser endereços ou coordenadas de latitude e longitude. Use o parâmetro trfc para mostrar informações de tráfego. Para especificar o tipo de trajeto dirigir, caminhar ou transporte público, use o parâmetro mode . Se mode não for especificado, os trajetos serão fornecidos usando o modo de transporte preferencial do usuário. Para obter mais informações sobre esses e outros parâmetros, consulte a referência de parâmetro bingmaps:.

Exibir trajetos curva a curva

Os esquemas de URI ms-drive-to: e ms-walk-to: permitem que você inicie diretamente em uma exibição curva a curva de um percurso.. Esses esquemas de URI só podem fornecer trajetos que começam na localização atual do usuário. Se você precisar fornecer trajetos entre pontos que não incluem a localização atual do usuário, use o esquema de URI bingmaps:, conforme descrito na seção anterior. Para obter mais informações sobre esses esquemas de URI, consulte as referências de parâmetro ms-drive-to: e ms-walk-to:.

Importante Quando os esquemas de URI ms-drive-to: ou ms-walk-to: são iniciados, o aplicativo Mapas verificará se o dispositivo já teve uma correção de localização de GPS. Caso positivo, o aplicativo Mapas seguirá para trajetos curva a curva. Caso contrário, o aplicativo exibirá a visão geral do percurso, conforme descrito em Exibir trajetos e tráfego.

Baixar mapas offline

O esquema de URI ms-settings: permite que você inicie diretamente em uma página específica no aplicativo Configurações. Embora o esquema de URI ms-settings: não seja iniciado no aplicativo Mapas, ele permite que você inicie diretamente na página Mapas Offline no aplicativo Configurações e exibe uma caixa de diálogo de confirmação para baixar os mapas offline usados pelo aplicativo Mapas. O esquema de URI aceita um ponto especificado por uma latitude e uma longitude e determina automaticamente se há mapas offline disponíveis para uma região que contém este ponto. Se a latitude e a longitude estiverem dentro de várias regiões de download, a caixa de diálogo de confirmação permitirá que o usuário escolha qual dessas regiões será baixada. Se os mapas offline não estiverem disponíveis para uma região que contém esse ponto, a página Mapas offline no aplicativo Configurações será exibida com uma caixa de diálogo de erro.

Referência de parâmetro bingmaps:

A sintaxe de cada parâmetro nesta tabela é mostrada usando a ABNF (forma de Backus-Naur aumentada).

Referência de parâmetro ms-drive-to:

O URI para iniciar uma solicitação de trajetos de automóvel curva a curva não precisa ser codificado e tem o formato a seguir.

Nota Você não especifica o ponto de partida neste esquema de URI. O ponto de partida é sempre presumido como sendo a localização atual. Caso precise especificar um ponto de partida diferente da localização atual, consulte Exibir trajetos e tráfego.

Referência de parâmetro ms-walk-to:

O URI para iniciar uma solicitação de trajetos a pé curva a curva não precisa ser codificado e tem o formato a seguir.

Nota Você não especifica o ponto de partida neste esquema de URI. O ponto de partida é sempre presumido como sendo a localização atual. Caso precise especificar um ponto de partida diferente da localização atual, consulte Exibir trajetos e tráfego.  

Referência de parâmetro ms-settings:

A sintaxe para parâmetros específicos do aplicativo de mapas para o esquema de URI ms-settings: é definida a seguir. maps-downloadmaps é especificado com o URI ms-settings: na forma de ms-settings:maps-downloadmaps? para indicar a página de configurações de mapas offline.