Solicitar uma chave de autenticação de mapasRequest a maps authentication key

Aviso

Os serviços de mapas online podem não estar disponíveis em versões mais antigas do Windows 10.Online maps services may not be available on older versions of Windows 10. Nas versões a seguir, MapControl pode deixar de exibir mapas e APIs no namespace Windows. Services. Maps pode não retornar resultados:On the following versions, MapControl may no longer display maps and APIs in the Windows.Services.Maps namespace may not return results:

  • Windows 10, versão 1607 e versões anteriores: os serviços de mapa ficarão indisponíveis em todo o mundo, a partir de outubro de 2020Windows 10, version 1607 and earlier versions: map services will be unavailable worldwide starting in October 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 ChinaWindows 10, version 1703 and earlier versions: map services are unavailable on some devices sold in China

Seu aplicativo universal do Windows deve ser autenticado antes de poder usar os serviços MapControl e MAP no namespace Windows. Services. Maps .Your Universal Windows 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 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.This topic describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.

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:Tip To learn more about using maps in your app, download the following sample from the Windows-universal-samples repo on GitHub:

Obter uma chaveGet a key

Crie e gerencie chaves de autenticação de mapa para aplicativos Universal do Windows usando a Central de Desenvolvimento do Bing Mapas.Create and manage map authentication keys for your Universal Windows apps using the Bing Maps Developer Center.

Para criar uma nova chaveTo create a new key

  1. No navegador, navegue até o centro de desenvolvedores do Bing Maps ( https://www.bingmapsportal.com ).In your browser, navigate to the Bing Maps Developer Center (https://www.bingmapsportal.com).

  2. Caso você precise fazer logon, insira a conta da Microsoft e clique em Entrar.If you are asked to sign in, enter your Microsoft account and click Sign in.

  3. Escolha a conta para associar à sua conta do Bing Mapas.Choose the account to associate with your Bing Maps account. Caso queira usar a conta da Microsoft, clique em Sim.If you want to use your Microsoft account, click Yes. Do contrário, clique em Sign in with another account.Otherwise, click Sign in with another account.

  4. Caso você ainda não tenha uma conta do Bing Maps, crie uma nova conta do Bing Maps.If you don't already have a Bing Maps account, create a new Bing Maps account. Insira Nome da Conta, Nome de Contato, Nome da Empresa, Endereço de Email e Telefone.Enter the Account Name, Contact Name, Company Name, Email Address, and Phone Number. Depois de aceitar os termos de uso, clique em Criar.After accepting the terms of use, click Create.

  5. No menu Minha conta, clique em Minhas Chaves.Under the My account menu, click My Keys.

  6. Se você tiver criado uma chave anteriormente, clique no link para criar uma nova chave.If you have previously created a key, click on the link to create a new key. Caso contrário, vá para o formulário Criar Chave.Otherwise proceed to the Create Key form.

  7. Preencha o formulário Criar Chave e clique em Criar.Complete the Create Key form and then click Create.

    • Nome do aplicativo: o nome do aplicativo.Application name: The name of your application.
    • URL do aplicativo (opcional): a URL do aplicativo.Application URL (optional): The URL of your application.
    • Tipo de chave: selecione Básico ou Empresa.Key type: Select Basic or Enterprise.
    • Tipo de aplicativo: Selecione o aplicativo do Windows para uso em seu aplicativo universal do Windows.Application type: Select Windows Application for use in your Universal Windows app.

    Este é um exemplo da aparência do formulário.This is an example of what the form looks like.

    exemplo do formulário Criar Chave.

  8. Depois de você clicar em Criar, a nova chave aparece abaixo do formulário Criar Chave.After you click Create, the new key appears below the Create Key form. Copie-a para um local seguro ou adicione-a imediatamente ao aplicativo, conforme descrito na próxima etapa.Copy it to a safe place or immediately add it to your app, as described in the next step.

Adicionar a chave ao aplicativoAdd the key to your app

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.The map authentication key is required to use the MapControl and map services (Windows.Services.Maps) in your Universal Windows app. Adicione-o ao controle de mapa e mapeie objetos de serviço, conforme aplicável.Add it to the map control and map service objects, as applicable.

Para adicionar a chave a um controle de mapaTo add the key to a map control

Para autenticar o MapControl, defina a propriedade MapServiceToken como o valor da chave de autenticação.To authenticate the MapControl, set the MapServiceToken property to the authentication key value. Você pode definir essa propriedade no código ou na marcação XAML, dependendo das suas preferências.You can set this property in code or in XAML markup, depending on your preferences. Para obter mais informações sobre o uso de MapControl, consulte Exibir mapas com modos de exibição 2D, 3D e Streetside.For more info about using the MapControl, see Display maps with 2D, 3D, and Streetside views.

  • Este exemplo define MapServiceToken como o valor da chave de autenticação no código.This example sets the MapServiceToken to the value of the authentication key in code.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
    
  • Este exemplo define MapServiceToken como o valor da chave de autenticação na marcação XAML.This example sets the MapServiceToken to the value of the authentication key in XAML markup.

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

Para adicionar a chave a serviços de mapaTo add the key to map services

Para usar serviços no namespace Windows.Services.Maps, defina a propriedade ServiceToken como o valor da chave de autenticação.To use services in the Windows.Services.Maps namespace, set the ServiceToken property to the authentication key value. 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.For more info about using map services, see Display routes and directions and Perform geocoding and reverse geocoding.

  • Este exemplo define ServiceToken como o valor da chave de autenticação no código.This example sets the ServiceToken to the value of the authentication key in code.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";