Cómo agregar un conjunto de datos a un conjunto de datos de mapa y diseño

Selecciona la plataforma: Android iOS JavaScript

En esta página, se muestra cómo agregar un conjunto de datos a un mapa y aplicar diseños.

Requisitos previos

Antes de continuar, debes tener un ID de mapa, un diseño de mapa y un ID de conjunto de datos.

• Cómo crear un ID de mapa y un diseño de mapa

• Cómo crear y subir un conjunto de datos

  Nota: Necesitas el ID de tu conjunto de datos para inicializar la app.

Asocia un ID de conjunto de datos a un diseño de mapa

Para aplicar diseño a los componentes de un conjunto de datos, debes aplicar una función de diseño a la capa de componentes del conjunto de datos de un mapa. La capa de componentes del conjunto de datos se crea cuando asocias un conjunto de datos a un diseño de mapa.

Experimental: Esta función solo se puede configurar para los diseños de mapa claros. Cuando vinculas un diseño de mapa claro que tiene habilitada esta función a un ID de mapa, las capas habilitadas también están disponibles para el diseño de mapa oscuro.

Para asociar tu conjunto de datos al diseño de mapa, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Conjuntos de datos.
2. Haz clic en el nombre del conjunto de datos. Se abrirá la página Detalles del conjunto de datos.
3. Haz clic en la pestaña Vista previa.
4. En la sección Diseños de mapa asociados, haz clic en AGREGAR DISEÑO DE MAPA.
   
5. Haz clic en las casillas de verificación correspondientes a los diseños de mapa que deseas asociar y, luego, en GUARDAR.

Advertencia: Renderizar varios conjuntos de datos en un mapa puede afectar el rendimiento según el tamaño y la cantidad de los conjuntos de datos.

Aplica estilos al conjunto de datos

Para aplicar estilos a un conjunto de datos, sigue estos pasos:

1. Crea una función de fábrica de diseño que implemente la interfaz FeatureLayer.StyleFactory. Esta función define la lógica de diseño de un conjunto de datos.

2. Llama a FeatureLayer.setFeatureStyle() para aplicar la función de fábrica de diseño a cada componente del conjunto de datos.

Crea una función de fábrica de diseño

La función de fábrica de diseño se aplica a cada componente de la capa del conjunto de datos en el momento en que estableces la función en la capa de componentes. Esta función debe devolver un objeto FeatureStyle que especifique cómo aplicar diseño al polígono.

Si la fábrica de diseño devuelve null, no se renderiza el elemento determinado. Para obtener más información, consulta Cómo quitar el diseño de una capa.

Nota: Si actualizas o modificas la función de fábrica de diseño para una capa de componentes, debes volver a llamar a FeatureLayer.setFeatureStyle() para restablecer la función en la capa de componentes.

El SDK de Maps para Android pasa una instancia de Feature a la función de fábrica de diseño. La instancia Feature representa los metadatos del elemento, lo que te permite acceder a ellos en la función de fábrica de diseño.

Nota: En el caso de un conjunto de datos, la instancia es, en realidad, del tipo DatasetFeature, que es una clase secundaria de Feature.

La función de fábrica de diseño siempre debe mostrar resultados coherentes cuando se aplica. Por ejemplo, si deseas colorear de forma aleatoria un conjunto de componentes, la aleatoriedad no debe ocurrir en la función de diseño de los componentes, ya que esto generaría resultados no deseados.

Dado que esta función se ejecuta en todos los componentes de una capa, la optimización es importante. Para evitar que se vean afectados los tiempos de renderización, llama a FeatureLayer.setFeatureStyle(null) cuando una capa de componentes ya no esté en uso.

También puedes llamar a FeatureLayer.getDatasetId() para obtener el ID del conjunto de datos.

Establece el trazo, el relleno y el radio de los puntos

Cuando aplicas diseño a un elemento en la función de fábrica de diseño, puedes establecer lo siguiente:

• Color y opacidad del trazo del borde, según lo define la clase Color. El valor predeterminado es transparente (Color.TRANSPARENT).

• Ancho del trazo del borde en píxeles de la pantalla. El valor predeterminado es 2.

• Color de relleno y opacidad, según lo define la clase Color El valor predeterminado es transparente (Color.TRANSPARENT).

• Radio del punto de un elemento de punto entre 0 y 128 píxeles.

Utiliza reglas de diseño simples

La manera más simple de aplicar diseño a los componentes es definir un FeatureLayer.StyleFactory que siempre cree un objeto FeatureStyle idéntico, independientemente del componente. Aplica opciones de diseño de componente directamente a una capa de componentes del conjunto de datos, o utilízalas en conjunto con FeatureStyleFunction.

Utiliza reglas de diseño declarativas

Puedes establecer reglas de diseño de forma declarativa según un atributo de un componente y aplicarlas a todo el conjunto de datos. Puedes mostrar null desde la función de diseño del componente, por ejemplo, si deseas que un subconjunto de componentes permanezca invisible.

Por ejemplo, usa el método DatasetFeature.getDatasetAttributes() para devolver un Map<String,String> de atributos del conjunto de datos para un componente. Luego, puedes personalizar el diseño del elemento según sus atributos.

En este ejemplo, se determina el valor del atributo "highlightColor" de cada elemento de un conjunto de datos para controlar el diseño:

Kotlin

// Get the dataset feature, so we can work with all of its attributes.
val datasetFeature: DatasetFeature = feature as DatasetFeature

// Create a switch statement based on the value of the
// "highlightColor" attribute of the dataset.
val attributeColor: MutableMap<String, String> = datasetFeature.getDatasetAttributes()
when (attributeColor["highlightColor"]) {
  "Black" -> {
    ...
  }
  "Red" -> {
    ...
  }
  else -> {
    ...
  }
}

Java

// Get the dataset feature, so we can work with all of its attributes.
DatasetFeature datasetFeature = (DatasetFeature) feature;

// Create a switch statement based on the value of the
// "highlightColor" attribute of the dataset.
Map<String, String> attributeColor = datasetFeature.getDatasetAttributes();
switch(attributeColor.get("highlightColor"))
{
  case "Black":
    ...
    break;
  case "Red":
    ...
    break;
  default: // Color not defined.
    ...
    break;
}

Aplica diseño a la capa de componentes del conjunto de datos

En este ejemplo, se aplica una función de fábrica de diseño a un polígono en la capa de componentes del conjunto de datos. La función de fábrica de diseño aplica un estilo de relleno y trazo personalizado al polígono:

1. Si aún no lo hiciste, sigue los pasos que se indican en Cómo comenzar para crear un ID y un diseño de mapa nuevos. Asegúrate de habilitar la capa de componentes Conjuntos de datos.

2. Obtén una referencia a la capa de componentes de conjuntos de datos cuando se inicialice el mapa.

   Kotlin

   private var datasetLayer: FeatureLayer? = null
   
   override fun onMapReady(googleMap: GoogleMap) {
     // Get the DATASET feature layer.
     datasetLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build())
   
     // Apply style factory function to DATASET layer.
     styleDatasetsLayer()
   }

   Java

   private FeatureLayer datasetLayer;
   
   @Override
   public void onMapReady(GoogleMap map) {
     // Get the DATASET feature layer.
     datasetLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build());
   
     // Apply style factory function to DATASET layer.
     styleDatasetsLayer();
   }

3. Crea una función de fábrica de diseño y aplícala a la capa de componentes de conjuntos de datos.

   En el siguiente ejemplo, se aplican el mismo relleno y trazo a todos los componentes del conjunto de datos.

   Nota: En este ejemplo, se verifica que el elemento que se pasa a la función de fábrica de diseño sea del tipo DatasetFeature. Sin embargo, debido a que la función de fábrica de diseño aplica el mismo diseño a todos los componentes del conjunto de datos, no usa el objeto DatasetFeature. Para ver ejemplos en los que se aplican estilos de forma condicional según el contenido del objeto DatasetFeature, consulta Ejemplos de diseño de componentes de datos.

   Kotlin

   private fun styleDatasetsLayer() {
   
     // Create the style factory function.
     val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
   
         // Check if the feature is an instance of DatasetFeature.
         if (feature is DatasetFeature) {
   
               return@StyleFactory FeatureStyle.Builder()
                   // Define a style with green fill at 50% opacity and
                   // solid green border.
                   .fillColor(0x8000ff00.toInt())
                   .strokeColor(0xff00ff00.toInt())
                   .strokeWidth(2F)
                   .build()
         }
         return@StyleFactory null
     }
   
     // Apply the style factory function to the feature layer.
     datasetLayer?.setFeatureStyle(styleFactory)
   }

   Java

   private void styleDatasetsLayer() {
   
     // Create the style factory function.
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
   
       // Check if the feature is an instance of DatasetFeature.
       if (feature instanceof DatasetFeature) {
   
           return new FeatureStyle.Builder()
             // Define a style with green fill at 50% opacity and solid green border.
             .fillColor(0x8000ff00)
             .strokeColor(0xff00ff00)
             .strokeWidth(2)
             .build();
         }
         return null;
       };
   
       // Apply the style factory function to the feature layer.
       datasetLayer.setFeatureStyle(styleFactory);
   }

Cómo quitar el diseño aplicado a una capa

Para quitar el diseño aplicado a una capa, llama a FeatureLayer.setFeatureStyle(null).

También puedes mostrar null desde tu fábrica de diseño, por ejemplo, si quieres que un subconjunto de componentes permanezca invisible.