Solicitar uma chave de autenticação de mapas

Seu aplicativo Universal do Windows deve ser autenticado antes de poder usar os serviços MapControl e map no namespace Windows.Services.Maps . Para autenticar o aplicativo, você precisa especificar uma chave de autenticação de mapas. Este tópico descreve como solicitar uma chave de autenticação de mapas a partir da Central de Desenvolvimento do Bing Mapas e adicioná-la ao aplicativo.

Dica Para saber mais sobre o uso de mapas em seu aplicativo, baixe a amostra a seguir do repositório Windows-universal-samples no GitHub:

• Amostra de mapa da UWP (Plataforma Universal do Windows)

Obter uma chave

Crie e gerencie chaves de autenticação de mapa para aplicativos Universal do Windows usando a Central de Desenvolvimento do Bing Mapas.

Para criar uma nova chave

1. No navegador, navegue até o Centro de Desenvolvedores do Bing Mapas (https://www.bingmapsportal.com).

2. Caso você precise fazer logon, insira a conta da Microsoft e clique em Entrar.

3. Escolha a conta para associar à sua conta do Bing Mapas. Caso queira usar a conta da Microsoft, clique em Sim. Do contrário, clique em Sign in with another account.

4. Caso você ainda não tenha uma conta do Bing Maps, crie uma nova conta do Bing Maps. Insira Nome da Conta, Nome de Contato, Nome da Empresa, Endereço de Email e Telefone. Depois de aceitar os termos de uso, clique em Criar.

5. No menu Minha conta, clique em Minhas Chaves.

6. Se você tiver criado uma chave anteriormente, clique no link para criar uma nova chave. Caso contrário, vá para o formulário Criar Chave.

7. Preencha o formulário Criar Chave e clique em Criar.

   • Nome do aplicativo: o nome do aplicativo.
   • URL do aplicativo (opcional): a URL do aplicativo.
   • Tipo de chave: selecione Básico ou Empresa.
   • Tipo de aplicativo: Selecione Aplicativo do Windows para uso em seu aplicativo Universal do Windows.

   Este é um exemplo da aparência do formulário.

   

8. Depois de você clicar em Criar, a nova chave aparece abaixo do formulário Criar Chave. Copie-a para um local seguro ou adicione-a imediatamente ao aplicativo, conforme descrito na próxima etapa.

Adicionar a chave ao aplicativo

A chave de autenticação de mapa é obrigada a usar o MapControl e os serviços de mapa (Windows.Services.Maps) no aplicativo Universal do Windows. Adicione-o ao controle de mapa e mapeie objetos de serviço, conforme aplicável.

Para adicionar a chave a um controle de mapa

Para autenticar o MapControl, defina a propriedade MapServiceToken como o valor da chave de autenticação. Você pode definir essa propriedade no código ou na marcação XAML, dependendo das suas preferências. Para obter mais informações sobre o uso de MapControl, consulte Exibir mapas com modos de exibição 2D, 3D e Streetside.

• Este exemplo define MapServiceToken como o valor da chave de autenticação no código.

  MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
  

• Este exemplo define MapServiceToken como o valor da chave de autenticação na marcação XAML.

  <Maps:MapControl x:Name="MapControl1" MapServiceToken="abcdef-abcdefghijklmno"/>
  

Para adicionar a chave a serviços de mapa

Para usar serviços no namespace Windows.Services.Maps, defina a propriedade ServiceToken como o valor da chave de autenticação. Para obter mais informações sobre como usar serviços de mapa, consulte Exibir rotas e trajetos e Executar geocodificação e geocodificação reversa.

• Este exemplo define ServiceToken como o valor da chave de autenticação no código.

  MapService.ServiceToken = "abcdef-abcdefghijklmno";
  

Tópicos relacionados

• Central de Desenvolvedores do Bing Mapas
• Amostra de mapa UWP
• Diretrizes de design para mapas
• Vídeo do build 2015: Aproveitando mapas e localização em telefones, tablets e computadores em seus aplicativos do Windows
• Exemplo de aplicativo de tráfego UWP