Comenzar

Selecciona la plataforma: Android iOS JavaScript

Sigue estos pasos para configurar el diseño basado en datos para los límites.

Habilita el nuevo procesador de mapas

A partir de la versión 18.0.0 del SDK de Maps para Android, hay disponible un procesador de mapas actualizado. Este procesador aporta muchas mejoras al SDK de Maps para Android, incluida la compatibilidad con el diseño de mapas basado en Cloud.

Cuando se lanzó la versión 18.2.0 del SDK de Maps para Android, Google cambió la opción predeterminada del procesador heredado al procesador de mapas actualizado. Debido a este cambio, el procesador de mapas actualizado ahora se usa de forma predeterminada en tu app cuando creas una app nueva o recreas una existente.

Precaución: Si deseas usar el diseño basado en datos aplicable a los límites de tu app, esta debe compilarse con el procesador de mapas actualizado. Si quieres agregar un diseño basado en datos aplicable a los límites de una app existente, asegúrate de volver a compilarla para que use el procesador de mapas actualizado. Para obtener más información, consulta Nuevo procesador de mapas.

Crea un ID de mapa

Para crear un ID de mapa nuevo, sigue los pasos que se indican en Cómo crear un ID de mapa. Asegúrate de configurar el tipo de mapa como Android.

Crea un nuevo diseño de mapa

Para crear un nuevo diseño de mapa, sigue las instrucciones que se indican en Cómo administrar diseños de mapa y asocia el diseño con el ID de mapa que acabas de crear.

Selecciona las capas de componentes en tu nuevo diseño de mapa

En la Consola de APIs de Google, puedes seleccionar las capas de componentes que deseas mostrar para tu nuevo diseño de mapa. La capa de componentes determina qué tipos de límites aparecerán en el mapa (por ejemplo, localidades, estados, etcétera).

Importante: Para obtener un rendimiento óptimo, selecciona solo las capas que necesites.

1. En la Consola de API de Google, ve a la página Diseños de mapa.
2. Si se te solicita, selecciona un proyecto.
3. Selecciona un diseño de mapa.
4. Haz clic en el menú desplegable Capas de componentes para agregar o quitar capas.
5. Haz clic en Guardar para guardar los cambios y que estén disponibles en tus mapas.

Actualiza el código de inicialización del mapa

Para realizar este paso, necesitas el ID de mapa que acabas de crear. Puedes encontrarlo en la página Administración de mapas.

Para agregar el ID de mapa a tu código de inicialización, consulta Cómo agregar el ID de mapa a tu app.

Cómo obtener acceso a una capa de componentes de un mapa

Usa un objeto FeatureLayer para representar cada capa de componentes de un mapa, como la capa de código postal o localidad. Para obtener acceso a un objeto de la capa de componentes, llama a GoogleMap.getFeatureLayer() cuando se inicialice el mapa:

Java

private FeatureLayer postalCodeLayer;

@Override
public void onMapReady(GoogleMap map) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build());
  ...
}

Kotlin

private var postalCodeLayer: FeatureLayer? = null

override fun onMapReady(googleMap: GoogleMap) {
  // Get the POSTAL_CODE feature layer.
  postalCodeLayer = googleMap.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.POSTAL_CODE)
    .build())
  ...
}

Pasa un objeto FeatureLayerOptions a getFeatureLayer() para especificar el tipo de capa de componentes. En este ejemplo, quieres acceder a la capa POSTAL_CODE. Crea un objeto FeatureLayer diferente para cada capa a la que quieras aplicarle diseño.

Una vez que tengas el objeto FeatureLayer, podrás aplicar diseño a los polígonos de límite de ese componente.

Nota: Si no existe un FeatureLayer del tipo especificado para el mapa o si no se habilitó el diseño basado en datos para los límites porque no especificaste el ID del mapa, esta llamada se muestra, pero registra un error. Usa el método FeatureLayer.isAvailable() para determinar si un FeatureLayer está disponible.

Verifica las capabilities del mapa (obligatorio)

El diseño basado en datos aplicable a límites requiere un ID de mapa. Si no pasas un ID de mapa o pasas uno no válido, no se podrá cargar el diseño basado en datos para los límites. Como paso para solucionar problemas, puedes usar MapCapabilities para verificar si se admite el diseño basado en datos aplicable a límites.

Precaución: Es posible que algunos dispositivos no sean compatibles con el procesador de mapas nuevo y, por lo tanto, no puedan mostrar el diseño basado en datos aplicable a límites. Debes usar MapCapabilities para verificar la compatibilidad en el entorno de ejecución. Si el diseño basado en datos aplicable a límites no es compatible, define una opción de resguardo. Para conocer los requisitos del dispositivo para el nuevo procesador de mapas, consulta Dispositivos compatibles.

Kotlin

val capabilities: MapCapabilities = googleMap.getMapCapabilities()
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable())

Java

MapCapabilities capabilities = googleMap.getMapCapabilities();
System.out.println("Data-driven Styling is available: " + capabilities.isDataDrivenStylingAvailable());