Visão geral de mapas e localMaps and location overview

Esta seção explica como é possível exibir mapas, usar serviços de mapa, encontrar o local e configurar uma cerca geográfica no aplicativo.This section explains how you can display maps, use map services, find the location, and set up a geofence in your app. Esta seção também mostra como iniciar o aplicativo Mapas do Windows em um mapa, rota ou conjunto de trajetos passo a passo específico.This section also shows you how to launch the Windows Maps app to a specific map, route, or a set of turn-by-turn directions.

MapControl e os serviços de mapa exigem uma chave de autenticação de mapas chamada MapServiceToken.MapControl and map services requite a maps authentication key called a MapServiceToken. Para saber mais sobre como obter e definir uma chave de autenticação de mapas, consulte Solicitar uma chave de autenticação de mapas.For more info about getting and setting a maps authentication key, see Request a maps authentication key.

Dica

 Para saber mais sobre como usar mapas e local no aplicativo, baixe as seguintes amostras do repositório Windows-universal-samples no GitHub: To learn more about using maps and location in your app, download the following samples from the Windows-universal-samples repo on GitHub:

 

Exibir mapasDisplay maps

Exiba mapas com modos de exibição 2D, 3D ou Streetside no seu aplicativo usando APIs do namespace Windows.UI.Xaml.Controls.Maps.Display maps with 2D, 3D, or Streetside views in your app by using APIs from the Windows.UI.Xaml.Controls.Maps namespace. Você pode marcar POIs (pontos de interesse) no mapa usando pinos, imagens, formas ou elementos de interface do usuário XAML.You can mark points of interest (POI) on the map by using pushpins, images, shapes, or XAML UI elements. Também é possível sobrepor imagens lado a lado ou substituir completamente as imagens do mapa.You can also overlay tiled images or replace the map images altogether.

TópicoTopic DescriçãoDescription
Solicitar uma chave de autenticação de mapasRequest a maps authentication key O aplicativo precisa ser autenticado para que possa usar o MapControl e os serviços de mapa no namespace Windows.Services.Maps.Your app must be authenticated before it can use the MapControl and map services in the Windows.Services.Maps namespace. Para autenticar o aplicativo, você precisa especificar uma chave de autenticação de mapas.To authenticate your app, you must specify a maps authentication key. Este artigo descreve como solicitar uma chave de autenticação de mapas na Central de desenvolvedores do Bing Mapas e adicioná-la ao aplicativo.This article describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.
Exibir mapas com modos de exibição 2D, 3D e StreetsideDisplay maps with 2D, 3D, and Streetside views Exiba mapas personalizáveis no seu aplicativo usando a classe MapControl.Display customizable maps in your app by using the MapControl class. Este tópico também apresenta modos de exibição 3D e Streetside.This topic also introduces aerial 3D and Streetside views.
Exibir POIs (pontos de interesse) em um mapaDisplay points of interest (POI) on a map Adicione POIs (pontos de interesse) a um mapa usando pinos, imagens, formas e elementos de interface do usuário XAML.Add points of interest (POI) to a map by using pushpins, images, shapes, and XAML UI elements.
Sobrepor imagens lado a lado em um mapaOverlay tiled images on a map Sobreponha imagens em blocos de terceiros ou personalizados em um mapa usando fontes de blocos.Overlay third-party or custom tiled images on a map by using tile sources. Use fontes de blocos para sobrepor informações especializadas, como dados de previsão do tempo, dados de população ou dados sísmicos; ou use fontes de blocos para substituir por completo o mapa padrão.Use tile sources to overlay specialized information such as weather data, population data, or seismic data; or use tile sources to replace the default map entirely.

Serviços de mapa de acessoAccess map services

Adicione rotas, trajetos e funcionalidades de geocódigo ao aplicativo usando APIs do namespace Windows.Services.Maps.Add routes, directions, and geocoding capabilities to your app by using APIs from the Windows.Services.Maps namespace.

TópicoTopic DescriçãoDescription
Solicitar uma chave de autenticação de mapasRequest a maps authentication key O aplicativo precisa ser autenticado para que possa usar o MapControl e os serviços de mapa no namespace Windows.Services.Maps.Your app must be authenticated before it can use the MapControl and map services in the Windows.Services.Maps namespace. Para autenticar o aplicativo, você precisa especificar uma chave de autenticação de mapas.To authenticate your app, you must specify a maps authentication key. Este artigo descreve como solicitar uma chave de autenticação de mapas na Central de desenvolvedores do Bing Mapas e adicioná-la ao aplicativo.This article describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.
Exibir POIs (pontos de interesse) em um mapaDisplay points of interest (POI) on a map Adicione POIs (pontos de interesse) a um mapa usando pinos, imagens, formas e elementos de interface do usuário XAML.Add points of interest (POI) to a map by using pushpins, images, shapes, and XAML UI elements.
Exibir rotas e trajetoDisplay routes and directions Solicite rotas e trajetos e exiba-os no aplicativo.Request routes and directions, and display them in your app.
Executar geocodificação e geocodificação reversaPerform geocoding and reverse geocoding Converta endereços em localizações geográficas (geocódigo) e converta localizações geográficas em endereços (geocódigo reverso) chamando os métodos da classe MapLocationFinder no namespace Windows.Services.Maps.Convert addresses to geographic locations (geocoding) and convert geographic locations to addresses (reverse geocoding) by calling the methods of the MapLocationFinder class in the Windows.Services.Maps namespace.
Localize e baixe pacotes de mapas para uso offlineFind and download map packages for offline use No passado, o aplicativo precisava direcionar os usuários para o aplicativo de configurações para baixar Mapas offline.In the past, your app had to direct users to the Settings app to download offline Maps. Agora, você pode usar classes no namespace Windows.Services.Maps.OfflineMaps para localizar os pacotes baixados em uma determinada área (com base em Geopoint, GeoboundingBox etc.).Now, you can use classes in the Windows.Services.Maps.OfflineMaps namespace to find downloaded packages in a given area (based on a Geopoint, GeoboundingBox, etc.).
Você pode também verificar e escutar o status de download de pacotes de mapa, bem como iniciar um download sem exigir que o usuário saia do aplicativo.You can also check and listen for the downloaded status of map packages as well as start a download without requiring the user to leave your app.
Você encontrará exemplos de como fazer isso no conteúdo de referência e a amostra de mapa da UWP (Plataforma Universal do Windows).You'll find examples of how to do this in both the reference content and the Universal Windows Platform (UWP) map sample.

Obter a localização do usuárioGet the user's location

Obtenha o local atual do usuário e seja notificado quando o local mudar no aplicativo usando APIs do namespace Windows.Devices.Geolocation.Get the user's current location and be notified when the location changes in your app by using APIs from the Windows.Devices.Geolocation namespace. Esses membros da API também são usados com frequência em parâmetros das APIs de mapas.These API members are also frequently used in parameters of the maps APIs. As APIs do namespace Windows.Devices.Geolocation.Geofencing notificam o aplicativo quando o usuário insere ou sai de uma cerca geográfica (uma área geográfica predefinida).APIs from the Windows.Devices.Geolocation.Geofencing namespace notify your app when the user enters or exits a geofence (a predefined geographical area).

TópicoTopic DescriçãoDescription
Solicitar uma chave de autenticação de mapasRequest a maps authentication key O aplicativo precisa ser autenticado para que possa usar o MapControl e os serviços de mapa no namespace Windows.Services.Maps.Your app must be authenticated before it can use the MapControl and map services in the Windows.Services.Maps namespace. Para autenticar o aplicativo, você precisa especificar uma chave de autenticação de mapas.To authenticate your app, you must specify a maps authentication key. Este artigo descreve como solicitar uma chave de autenticação de mapas na Central de desenvolvedores do Bing Mapas e adicioná-la ao aplicativo.This article describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.
Diretrizes de design para aplicativos com detecção de localizaçãoDesign guidelines for location-aware apps Diretrizes de desempenho para aplicativos que exigirem acesso à localização de um usuário.Performance guidelines for apps that require access to a user's location.
Obter a localização do usuárioGet the user's location Obtenha acesso à localização do usuário e recupere-o.Get access to the user's location, then retreive it.
Diretrizes para usar o acompanhamento de visitasGuidelines for using Visits tracking Saiba como usar o recurso de acompanhamento de visitas potente para acompanhamento de localização mais prático.Learn how to use the powerful Visits Tracking feature for more practical location tracking.
Diretrizes de design para cerca geográficaDesign guidance for geofencing Diretrizes de desempenho para aplicativos que utilizam o recurso cerca geográfica.Performance guidelines for apps that utilize the geofencing feature.
Configurar uma cerca geográficaSet up a geofence Configure uma cerca geográfica no aplicativo e saiba como manipular notificações em primeiro e segundo planos.Set up a geofence in your app, and learn how to handle notifications in the foreground and background.

Iniciar o aplicativo Mapas do WindowsLaunch the Windows Maps app

O aplicativo pode iniciar o aplicativo Mapas do Windows conforme mostrado aqui para exibir mapas específicos e trajetos curva a curva.Your app can launch the Windows Maps app as shown here to display specific maps and turn-by-turn directions. Em vez de oferecer funcionalidade de mapa diretamente no próprio aplicativo, leve em consideração usar o aplicativo Mapas do Windows para fornecer essa funcionalidade.Rather than provide map functionality directly in your own app, consider using the Windows Maps app to provide that functionality. Para saber mais, consulte Iniciar o aplicativo Mapas do Windows.For more info, see Launch the Windows Maps app.

um exemplo do aplicativo Mapas do Windows.