Solicitar una clave de autenticación de mapas

  • Artículo

Advertencia

Es posible que los servicios de mapas en línea no estén disponibles en versiones anteriores de Windows 10. En las siguientes versiones, Es posible que MapControl ya no muestre mapas y API en el espacio de nombres Windows.Services.Maps no devuelva resultados:

  • Windows 10, versión 1607 y versiones anteriores: los servicios de mapa no estarán disponibles en todo el mundo a partir de octubre de 2020
  • Windows 10, versión 1703 y versiones anteriores: los servicios de mapa no están disponibles en algunos dispositivos vendidos en 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. Para autenticar la aplicación, debes especificar una clave de autenticación de mapas. 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.

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:

Obtener una clave

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.

Para crear una nueva clave

  1. En el explorador, vaya al Centro para desarrolladores de mapas de Bing (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.

  3. Elige la cuenta para asociarla con tu cuenta de Mapas de Bing. Si quieres usar tu cuenta de Microsoft, haz clic en Sí. De lo contrario, haz clic en Iniciar sesión con otra cuenta.

  4. Si no tienes una cuenta de Mapas de Bing, crea una nueva. 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. Después de aceptar los términos de uso, haz clic en Crear.

  5. En el menú Mi cuenta , haga clic en Mis claves.

  6. Si ha creado previamente una clave, haga clic en el vínculo para crear una nueva clave. De lo contrario, continúe con el formulario Crear clave.

  7. Rellena el formulario Crear clave y, después, haz clic en Crear.

    • Nombre de la aplicación: el nombre de tu aplicación.
    • Dirección URL de la aplicación (opcional): dirección URL de tu aplicación.
    • Tipo de clave: selecciona Básica o Empresa.
    • Tipo de aplicación: Seleccione Aplicación de Windows para su uso en la aplicación universal de Windows.

    A continuación se muestra un ejemplo del aspecto del formulario.

    ejemplo del formulario crear clave.

  8. Después de hacer clic en Crear, la nueva clave aparece debajo del formulario Crear clave. Cópiala en un lugar seguro o agrégala inmediatamente a la aplicación, como se describe en el siguiente paso.

Agregar la clave a la aplicación

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. Agrégala al control de mapa y asigna los objetos de servicio, según corresponda.

Agregar la clave a un control de mapa

Para autenticar servicios en el espacio de nombres MapControl, establece la propiedad MapServiceToken en el valor de la clave de autenticación. Puedes establecer esta propiedad en el código o en el marcado XAML, según tus preferencias. Para obtener más información sobre el uso de MapControl, consulta Mostrar mapas con vistas 2D, 3D y Streetside.

  • Este ejemplo establece MapServiceToken en el valor de la clave de autenticación del código.

    MapControl1.MapServiceToken = "abcdef-abcdefghijklmno";

  • Este ejemplo establece MapServiceToken en el valor de la clave de autenticación del marcado XAML.

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

Agregar la clave a servicios de mapa

Para usar servicios en el espacio de nombres Windows.Services.Maps, establece la propiedad ServiceToken en el valor de clave de autenticación. 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.

  • Este ejemplo establece ServiceToken en el valor de la clave de autenticación del código.

    MapService.ServiceToken = "abcdef-abcdefghijklmno";