Cómo usar los ID de mapa

Los ID de mapa son identificadores que creas en Google Cloud Console; los asocias a un estilo y, luego, los agregas al código de tu app para aplicarlo a tu mapa.

Una vez creados, los ID de mapa se asocian con un proyecto y también se restringen a una sola plataforma (Android, iOS o JavaScript) o a la API de Maps Static.

Para crear o administrar cualquier ID de mapa en Cloud Console, debes tener la función de IAM de propietario o editor del proyecto.

Cómo crear un ID de mapa

Un ID de mapa es un identificador único que representa una sola instancia de un mapa de Google. Puedes crear los ID de mapa y actualizar los estilos asociados con estos en cualquier momento en Cloud Console.

Para crear un ID de mapa, sigue estos pasos:

  1. En Cloud Console, ve a la página Administración de mapas (Map Management).
  2. Haz clic en Crear ID de mapa nuevo (Create New Map ID) para mostrar el formulario Crea un ID de mapa nuevo.
    Pantalla para crear ID de mapa nuevo

    En el formulario, haz lo siguiente:

    • Especifica un nombre de mapa.
    • Especifica un tipo de mapa o una plataforma.
    • Para los mapas de JavaScript, elige el tipo de mapa de trama o vectorial.
    • Ingresa una descripción del mapa.
    • Haz clic en Siguiente para mostrar el nuevo ID de mapa.

Cómo asociar un ID de mapa a un estilo de mapa

En estas instrucciones, se da por hecho que tu proyecto tiene al menos un estilo de mapa existente.

  1. En Cloud Console, ve a la página Administración de mapas (Map Management).
  2. En esta página, selecciona un ID de mapa existente en la columna Nombre del mapa.
  3. En la parte inferior de este formulario, elige un estilo de mapa del menú desplegable Estilos de mapa asociados con este ID de mapa (Map styles associated with this Map ID).
  4. Selecciona Guardar (Save).
    Captura de pantalla que muestra la página de detalles de un solo ID de mapa, incluido el campo desplegable que permite a los usuarios asociar un estilo de mapa con este ID.

Cómo agregar un ID de mapa a tu app

Puedes agregar tu ID de mapa a través de un elemento <fragment> en el archivo de diseño de la actividad mediante la clase MapView o de manera programática con la clase GoogleMapOptions.

Por ejemplo, supongamos que creaste un ID de mapa que se almacena como un valor de string llamado map_id en res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">YOUR_MAP_ID</string>
</resources>

Para los mapas agregados a través de un elemento <fragment> en el archivo de diseño de la actividad, todos los fragmentos del mapa que deberían tener el estilo personalizado deben especificar el ID del mapa en el atributo map:mapId:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

También puedes usar el atributo map:mapId de la clase MapView para especificar un ID de mapa:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

Para especificar un ID de mapa de manera programática, pásalo a una instancia de MapFragment utilizando la clase GoogleMapOptions:

Java

  MapFragment mapFragment = MapFragment.newInstance(
      new GoogleMapOptions()
          .mapId(getResources().getString(R.string.map_id)));

Kotlin

  val mapFragment = MapFragment.newInstance(
      GoogleMapOptions()
          .mapId(resources.getString(R.string.map_id))
  )

En Android Studio, compila y ejecuta tu app como lo harías normalmente. Los estilos personalizados, tal como se configuraron en el primer paso, se aplicarán a todos los mapas con un ID.