Compartilhar via

Solicitar uma chave de autenticação de mapas

  • Artigo

Importante

Desativação do serviço Bing Maps para empresas

O UWP MapControl e os serviços de mapa do namespace Windows.Services.Maps dependem do Bing Maps. O Bing Maps for Enterprise foi preterido e será desativado, momento em que o MapControl e os serviços não receberão mais dados.

Para obter mais informações, consulte a documentação da Central de Desenvolvedores do Bing Maps e do Bing Maps.

Aviso

Os serviços de mapas online podem não estar disponíveis em versões mais antigas do Windows 10. Nas versões a seguir, o MapControl não pode mais exibir mapas e as APIs no namespace Windows.Services.Maps podem não retornar resultados:

  • Windows 10, versão 1607 e versões anteriores: os serviços de mapa não estarão disponíveis em todo o mundo a partir de outubro de 2020
  • Windows 10, versão 1703 e versões anteriores: os serviços de mapa não estão disponíveis em alguns dispositivos vendidos na China

O aplicativo precisa ser autenticado para que possa usar o MapControl e os serviços de mapa 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 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 Mapas.

Para criar uma nova chave

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

  2. Se você for solicitado a entrar, insira sua conta da Microsoft e clique em Entrar.

  3. Escolha a conta a ser associada à sua conta do Bing Maps. Se você quiser usar sua conta da Microsoft, clique em Sim. Caso contrário, clique em Fazer login com outra conta.

  4. Se você ainda não tiver uma conta do Bing Mapas, crie uma nova conta do Bing Mapas. 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 uso, clique em Criar.

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

  6. Se você já criou uma chave, 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 seu aplicativo.
    • URL do aplicativo (opcional): a URL do seu aplicativo.
    • Tipo de chave: selecione Básico ou Enterprise.
    • Tipo de aplicativo: selecione Aplicativo do Windows para uso em seu aplicativo Universal do Windows.

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

    Um exemplo do formulário Criar chave.

  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 ao seu aplicativo

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 no código ou na marcação XAML, dependendo de suas preferências. Para obter mais informações sobre como usar o MapControl, consulte Exibir mapas com modos de exibição 2D, 3D e Streetside.

  • 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 mais informações sobre como utilizar serviços de mapa, consulte 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";