Primeros pasos

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: Para usar diseños basados en datos para los límites en tu app, esta debe crearse con el procesador de mapas actualizado. Si quieres agregar un diseño basado en datos para los límites a una app existente, asegúrate de recrearla de forma 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 aparecen 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

Usas un objeto FeatureLayer para representar cada capa de componentes de un mapa, como una capa de componentes de código postal o de localidad. Para obtener acceso a un objeto de 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 esa 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 hay un FeatureLayer 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 nuevo procesador de mapas y, por lo tanto, no puedan mostrar el diseño basado en datos para los límites. Debes usar MapCapabilities para verificar la compatibilidad en el entorno de ejecución. Si el diseño basado en datos para límites no es compatible, define una opción alternativa. 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());