Solicitar uma chave de autenticação de mapas

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

Obter uma chave

Crie e gerencie chaves de autenticação de mapa para seus aplicativos universais do Windows usando a Central de Desenvolvedores do Bing Maps.

Para criar uma nova chave

1. No navegador, navegue até a Central de Desenvolvedores do Bing Maps (https://www.bingmapsportal.com).

2. Se lhe for pedido para iniciar sessão, introduza a sua conta Microsoft e clique em Iniciar sessão.

3. Escolha a conta a associar à sua conta do Bing Maps. Se pretender utilizar a sua conta Microsoft, clique em Sim. Caso contrário, clique em Entrar com outra conta.

4. Se ainda não tiver uma conta do Bing Maps, crie uma nova conta do Bing Maps. Insira o nome da conta, o nome do contato, o nome da empresa, o endereço de e-mail e o número de telefone. Depois de aceitar os termos de utilização, clique Criar.

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

6. Se você criou uma chave anteriormente, clique no link para criar uma nova chave. Caso contrário, prossiga para o formulário Criar chave.

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

   • Nome do aplicativo: O nome do seu aplicativo.
   • URL do aplicativo (opcional): O URL da sua aplicação.
   • Tipo de chave: Selecione Básico ou Empresarial.
   • Tipo de aplicação: Selecione Aplicação Windows para uso na sua aplicação Universal do Windows.

   Este é um exemplo de como é o formulário.

   

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

Adicionar a chave à sua aplicação

A chave de autenticação de mapa é necessária para usar o MapControl e os serviços de mapa (Windows.Services.Maps) em seu aplicativo Universal do Windows. Adicione-o ao controle de mapa e aos objetos de serviço de mapa, 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 em código ou em marcação XAML, dependendo de suas preferências. Para obter mais informações sobre como usar o MapControl, consulte Apresentar mapas com vistas 2D, 3D e vista de rua.

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

  MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
  

• Este exemplo define o 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 aos 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 saber mais sobre como usar serviços de mapa, veja Exibir rotas e direções e Executar geocodificação e geocodificação reversa.

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

  MapService.ServiceToken = "abcdef-abcdefghijklmno";
  

Tópicos relacionados

• Centro de Programadores do Bing Maps
• Exemplo de mapa UWP
• Diretrizes de design para mapas
• Exemplo de aplicativo de tráfego UWP