Einer Karte ein Dataset hinzufügen

Plattform auswählen: Android iOS JavaScript

Auf dieser Seite erfahren Sie, wie Sie einer Karte ein Dataset hinzufügen und Stile anwenden.

Vorbereitung

Bevor Sie fortfahren, sollten Sie eine Karten-ID, einen Kartenstil und eine Dataset-ID haben.

• Karten-ID und Kartenstil erstellen

• Dataset erstellen und hochladen

  Hinweis: Sie benötigen die ID Ihres Datensatzes, um Ihre App zu initialisieren.

Dataset-ID mit Kartenstil verknüpfen

Wenn Sie die Elemente eines Datensatzes gestalten möchten, wenden Sie eine Stilfunktion auf die Elementebene des Datensatzes einer Karte an. Die Dataset-Featureebene wird erstellt, wenn Sie ein Dataset mit einem Kartenstil verknüpfen.

So verknüpfen Sie Ihr Dataset mit dem verwendeten Kartenstil:

1. Rufen Sie in der Google Cloud Console die Seite Datasets auf.
2. Klicken Sie auf den Namen des Datasets. Daraufhin wird die Seite Dataset-Details angezeigt.
3. Klicken Sie auf den Tab Vorschau.
4. Klicken Sie im Bereich Verknüpfte Kartenstile auf KARTENSTIL HINZUFÜGEN.
   
5. Kreuzen Sie die Kästchen für die zu verknüpfenden Kartenstile an und klicken Sie dann auf SPEICHERN.

Achtung: Wenn auf einer Karte mehrere Datasets gerendert werden, kann sich das je nach Größe und Anzahl der Datasets auf die Leistung auswirken.

.

Stile auf das Dataset anwenden

Wenn Sie ein Element der Datensatzebene gestalten möchten, verwenden Sie einen Stil-Closure, der eine GMSDatasetFeature akzeptiert und eine GMSFeatureStyle zurückgibt, um Stilattribute zu definieren. Legen Sie dann für die Stileigenschaft einen Stilabschluss fest, der die Stillogik enthält.

Der Stilabschluss muss deterministisch sein und bei der Anwendung einheitliche Ergebnisse liefern. Wenn Stilspezifikationen für ein Element geändert werden, muss der Stil noch einmal angewendet werden.

Strich, Füllung und Punktradius festlegen

Wenn Sie einem Element in der Style-Funktion einen Stil zuweisen, können Sie Folgendes festlegen:

• Strichfarbe und Deckkraft des Rahmens, wie von der Klasse UIColor definiert. Der Standardwert ist „transparent“ (UIColor.clearColor).

• Die Strichbreite des Rahmens in Bildschirmpixeln. Der Standardwert liegt bei 2.

• Füllfarbe und Deckkraft, wie von der Klasse UIColor definiert. Der Standardwert ist „transparent“ (UIColor.clearColor).

• Punktradius einer Punktansicht zwischen 0 und 128 Pixeln.

Hinweis: Wenn ein Element unsichtbar sein soll, geben Sie für die Stilfunktion dieses Elements nil zurück.

Einfache Stilregeln verwenden

Die einfachste Möglichkeit, Stile für Elemente festzulegen, ist die Definition konstanter Stilattribute wie Farbe, Deckkraft und Linienbreite. Sie können Stiloptionen für Elemente direkt auf eine Dataset-Ebene anwenden oder sie in Kombination mit benutzerdefinierten Stilen verwenden.

SwiftObjective-C

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
}

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;
};

Deklarative Stilregeln verwenden

Sie können Stilregeln deklarativ basierend auf einem Attribut des Elements festlegen und auf den gesamten Datensatz anwenden. Über die Stilfunktion für Elemente können Sie auch nil zurückgeben, z. B. wenn ein Teil der Elemente unsichtbar bleiben soll.

Verwenden Sie beispielsweise GMSDatasetFeature.datasetAttributes, um den Wert eines Datensatzattributs für ein Element zurückzugeben. Anschließend können Sie das Design der Funktion anhand ihrer Attribute anpassen.

In diesem Beispiel wird der Wert des Attributs „highlightColor“ jedes Elements eines Datensatzes bestimmt, um das Styling zu steuern:

SwiftObjective-C

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

// 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.
    ...
};

Stile von einer Ebene entfernen

Wenn Sie Stile von einer Ebene entfernen möchten, legen Sie style auf null fest:

SwiftObjective-C

layer.style = nil

layer.style = nil;

Über die Stilfunktion für Elemente können Sie auch nil zurückgeben, z. B. wenn ein Teil der Elemente unsichtbar bleiben soll.