Agrega un conjunto de datos a un mapa

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 del conjunto de datos para inicializar la app.

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

Para definir el diseño de los componentes de un conjunto de datos, aplica 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.

Para asociar tu conjunto de datos al diseño de mapa que utilizas, 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 diseños al conjunto de datos

Para definir el diseño de un componente de la capa de conjunto de datos, usa un cierre de diseño que acepte una GMSDatasetFeature y muestre una GMSFeatureStyle para definir atributos de diseño. Luego, establece la propiedad de diseño con un cierre de diseño que contenga la lógica de diseño.

Se requiere que el cierre de diseño sea determinista y que muestre resultados coherentes cuando se aplique. Si se modifica alguna de las especificaciones de diseño de algún componente, se debe volver a aplicar el diseño.

Cómo configurar el radio de trazo, relleno y punto

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

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

• Es el ancho de 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 UIColor El valor predeterminado es transparente (UIColor.clearColor).

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

Nota: Si deseas que un componente sea invisible, muestra nil desde la función de diseño de ese componente.

Utiliza reglas de diseño simples

La manera más simple de aplicar diseño a los componentes es definir atributos de diseño constantes, como el color, la opacidad y el ancho de línea. Aplica opciones de diseño de componente directamente a una capa de componentes de un conjunto de datos o úsalas junto con un diseño personalizado.

Swift

let mapView = GMSMapView(frame: .zero, mapID: GMSMapID(identifier: "YOUR_MAP_ID"), camera: GMSCameraPosition(latitude: 40.7, longitude: -74.0, zoom: 12))

let layer = mapView.datasetFeatureLayer(of: "YOUR_DATASET_ID")

// Define a style with green fill and stroke.
// Apply the style to all features in the dataset.
layer.style = { feature in
    let style = MutableFeatureStyle()
    style.fillColor = .green.withAlphaComponent(0.1)
    style.strokeColor = .green
    style.strokeWidth = 2.0
    return style
}

Objective‑C

GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:[GMSMapID mapIDWithIdentifier:@"MAP_ID"] camera:[GMSCameraPosition cameraWithLatitude: 40.7 longitude: -74.0 zoom:12]];

GMSDatasetFeatureLayer *layer = [mapView datasetFeatureLayerOfDatasetID:@"YOUR_DATASET_ID"];

// Define a style with green fill and stroke.
// Apply the style to all features in the dataset.
layer.style = ^(GMSDatasetFeature *feature) {
    GMSMutableFeatureStyle *style = [GMSMutableFeatureStyle style];
    style.fillColor = [[UIColor greenColor] colorWithAlphaComponent:0.1];
    style.strokeColor = [UIColor greenColor];
    style.strokeWidth = 2.0;
    return style;
};

Utiliza reglas de diseño declarativas

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

Por ejemplo, usa GMSDatasetFeature.datasetAttributes para mostrar el valor de un atributo de conjunto de datos para un componente. Luego, puedes personalizar el diseño del componente según sus atributos.

En este ejemplo, se determina el valor del atributo "highlightColor" de cada componente de un conjunto de datos para controlar el estilo:

Swift

layer.style = { feature in
    var attributeColor: String = feature.datasetAttributes["highlightColor"]
    // Conditionalize styling based on the value of the "highlightColor" attribute.
    ...
}

Objective‑C

// Apply the style to a single dataset feature.
layer.style = ^(GMSDatasetFeature *feature) {
    NSString *attributeColor = feature.datasetAttributes[@"highlightColor"];
    // Conditionalize styling based on the value of the "highlightColor" attribute.
    ...
};

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

Para quitar el diseño aplicado a una capa, establece style en null:

Swift

layer.style = nil

Objective‑C

layer.style = nil;

También puedes mostrar nil desde tu función de diseño de componentes, por ejemplo, si quieres que un subconjunto de componentes permanezca invisible.