Solicitar una clave de autenticación de mapasRequest a maps authentication key

Advertencia

Los servicios de mapas en línea pueden no estar disponibles en versiones anteriores de Windows 10.Online maps services may not be available on older versions of Windows 10. En las siguientes versiones, MapControl ya no puede mostrar que las asignaciones y las API del espacio de nombres Windows. Services. Maps no devuelvan 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, versión 1607 y versiones anteriores: los servicios de mapa no estarán disponibles en todo el mundo a partir del 2020 de octubreWindows 10, version 1607 and earlier versions: map services will be unavailable worldwide starting in October 2020
  • Windows 10, versión 1703 y versiones anteriores: los servicios de mapa no están disponibles en algunos dispositivos vendidos en ChinaWindows 10, version 1703 and earlier versions: map services are unavailable on some devices sold in China

La aplicación universal de Windows debe autenticarse para poder usar MapControl y los servicios de mapa en el espacio de nombres 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 la aplicación, debes especificar una clave de autenticación de mapas.To authenticate your app, you must specify a maps authentication key. En este tema se describe cómo solicitar una clave de autenticación de mapas desde el Centro para desarrolladores de Mapas de Bing y agregarla a la aplicación.This topic describes how to request a maps authentication key from the Bing Maps Developer Center and add it to your app.

Sugerencia Para obtener más información sobre el uso de mapas en la aplicación, descarga el ejemplo siguiente del repositorio de ejemplos de la plataforma universal de Windows que encontrarás en GitHub:Tip To learn more about using maps in your app, download the following sample from the Windows-universal-samples repo on GitHub:

Obtener una claveGet a key

Usa el Centro para desarrolladores de Mapas de Bing para crear y administrar claves de autenticación de mapas para tus aplicaciones universales de Windows.Create and manage map authentication keys for your Universal Windows apps using the Bing Maps Developer Center.

Para crear una nueva claveTo create a new key

  1. En el explorador, vaya al centro para desarrolladores de mapas de Bing ( https://www.bingmapsportal.com ).In your browser, navigate to the Bing Maps Developer Center (https://www.bingmapsportal.com).

  2. Si se te pide que inicies sesión, escribe tu cuenta de Microsoft y haz clic en Iniciar sesión.If you are asked to sign in, enter your Microsoft account and click Sign in.

  3. Elige la cuenta para asociarla con tu cuenta de Mapas de Bing.Choose the account to associate with your Bing Maps account. Si quieres usar tu cuenta de Microsoft, haz clic en .If you want to use your Microsoft account, click Yes. De lo contrario, haz clic en Iniciar sesión con otra cuenta.Otherwise, click Sign in with another account.

  4. Si no tienes una cuenta de Mapas de Bing, crea una nueva.If you don't already have a Bing Maps account, create a new Bing Maps account. Rellena los campos Nombre de cuenta, Nombre del contacto, Nombre de la compañía, Dirección de correo electrónico y Número de teléfono.Enter the Account Name, Contact Name, Company Name, Email Address, and Phone Number. Después de aceptar los términos de uso, haz clic en Crear.After accepting the terms of use, click Create.

  5. En el menú mi cuenta , haga clic en mis claves.Under the My account menu, click My Keys.

  6. Si ya ha creado una clave, haga clic en el vínculo para crear una nueva clave.If you have previously created a key, click on the link to create a new key. De lo contrario, continúe con el formulario crear clave.Otherwise proceed to the Create Key form.

  7. Rellena el formulario Crear clave y, después, haz clic en Crear.Complete the Create Key form and then click Create.

    • Nombre de la aplicación: el nombre de tu aplicación.Application name: The name of your application.
    • Dirección URL de la aplicación (opcional): dirección URL de tu aplicación.Application URL (optional): The URL of your application.
    • Tipo de clave: selecciona Básica o Empresa.Key type: Select Basic or Enterprise.
    • Tipo de aplicación: Seleccione aplicación Windows para su uso en la aplicación universal de Windows.Application type: Select Windows Application for use in your Universal Windows app.

    A continuación se muestra un ejemplo del aspecto del formulario.This is an example of what the form looks like.

    ejemplo del formulario crear clave.

  8. Después de hacer clic en Crear, la nueva clave aparece debajo del formulario Crear clave.After you click Create, the new key appears below the Create Key form. Cópiala en un lugar seguro o agrégala inmediatamente a la aplicación, como se describe en el siguiente paso.Copy it to a safe place or immediately add it to your app, as described in the next step.

Agregar la clave a la aplicaciónAdd the key to your app

La clave de autenticación de mapa es necesaria para usar MapControl y los servicios de mapa (Windows.Services.Maps) en la aplicación universal de Windows.The map authentication key is required to use the MapControl and map services (Windows.Services.Maps) in your Universal Windows app. Agrégala al control de mapa y asigna los objetos de servicio, según corresponda.Add it to the map control and map service objects, as applicable.

Agregar la clave a un control de mapaTo add the key to a map control

Para autenticar servicios en el espacio de nombres MapControl, establece la propiedad MapServiceToken en el valor de la clave de autenticación.To authenticate the MapControl, set the MapServiceToken property to the authentication key value. Puedes establecer esta propiedad en el código o en el marcado XAML, según tus preferencias.You can set this property in code or in XAML markup, depending on your preferences. Para obtener más información sobre el uso de MapControl, consulta Mostrar mapas con vistas 2D, 3D y Streetside.For more info about using the MapControl, see Display maps with 2D, 3D, and Streetside views.

  • Este ejemplo establece MapServiceToken en el valor de la clave de autenticación del código.This example sets the MapServiceToken to the value of the authentication key in code.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";
    
  • Este ejemplo establece MapServiceToken en el valor de la clave de autenticación del marcado XAML.This example sets the MapServiceToken to the value of the authentication key in XAML markup.

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

Agregar la clave a servicios de mapaTo add the key to map services

Para usar servicios en el espacio de nombres Windows.Services.Maps, establece la propiedad ServiceToken en el valor de clave de autenticación.To use services in the Windows.Services.Maps namespace, set the ServiceToken property to the authentication key value. Para obtener más información sobre el uso de los servicios de mapa, consulta Mostrar rutas e indicaciones y Realizar geocodificación y geocodificación inversa.For more info about using map services, see Display routes and directions and Perform geocoding and reverse geocoding.

  • Este ejemplo establece ServiceToken en el valor de la clave de autenticación del código.This example sets the ServiceToken to the value of the authentication key in code.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";