Dataset zu einem Karten- und Stil-Dataset hinzufügen

Plattform auswählen: Android iOS JavaScript

Auf dieser Seite wird beschrieben, 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 Datasets, um Ihre App zu initialisieren.

Dataset-ID mit Kartenstil verknüpfen

Um die Elemente eines Datasets zu gestalten, wenden Sie eine Stilfunktion auf die Elementebene des Datasets einer Karte an. Der Dataset-Feature-Layer wird erstellt, wenn Sie ein Dataset mit einem Kartenstil verknüpfen.

Experimentell :Diese Funktion kann nur für helle Kartenstile festgelegt werden. Wenn Sie einen hellen Kartenstil, für den diese Funktion aktiviert ist, mit einer Karten-ID verknüpfen, sind die aktivierten Ebenen auch für den dunklen Kartenstil verfügbar.

So verknüpfen Sie Ihr Dataset mit dem 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

So wenden Sie Stile auf ein Dataset an:

1. Erstellen Sie eine Stil-Factory-Funktion, die die Schnittstelle FeatureLayer.StyleFactory implementiert. Mit dieser Funktion wird die Logik für die Gestaltung eines Datasets definiert.

2. Rufen Sie FeatureLayer.setFeatureStyle() auf, um die Stil-Factory-Funktion auf jedes Element im Dataset anzuwenden.

Stil-Factory-Funktion erstellen

Die Stil-Factory-Funktion wird auf jedes Element auf der Dataset-Ebene angewendet, wenn Sie die Funktion auf der Elementebene festlegen. Diese Funktion muss ein FeatureStyle-Objekt zurückgeben, das angibt, wie das Polygon gestaltet werden soll.

Wenn die Stil-Factory null zurückgibt, wird das angegebene Feature nicht gerendert. Weitere Informationen finden Sie unter Formatierung aus einer Ebene entfernen.

Hinweis :Wenn Sie die Style-Factory-Funktion für eine Feature-Ebene aktualisieren oder ändern, müssen Sie FeatureLayer.setFeatureStyle() noch einmal aufrufen, um die Funktion für die Feature-Ebene zurückzusetzen.

Das Maps SDK for Android übergibt eine Feature-Instanz an die Stil-Factory-Funktion. Die Feature-Instanz stellt die Metadaten des Features dar und ermöglicht Ihnen den Zugriff auf die Metadaten in der Stilfactory-Funktion.

Hinweis :Für ein Dataset ist die Instanz tatsächlich vom Typ DatasetFeature, einer untergeordneten Klasse von Feature.

Die Stil-Factory-Funktion sollte immer konsistente Ergebnisse zurückgeben, wenn sie angewendet wird. Wenn Sie z. B. eine Reihe von Elementen nach dem Zufallsprinzip einfärben wollen, sollte die zufällige Farbauswahl nicht in der Stilfunktion für Elemente erfolgen, da dies zu unbeabsichtigten Ergebnissen führen würde.

Da diese Funktion für jedes Element in einer Ebene ausgeführt wird, ist die Optimierung wichtig. Um unnötig lange Renderingzeiten zu vermeiden, rufen Sie FeatureLayer.setFeatureStyle(null) auf, wenn eine Feature-Ebene nicht mehr verwendet wird.

Sie können auch FeatureLayer.getDatasetId() aufrufen, um die ID des Datasets abzurufen.

Strich, Füllung und Punktradius festlegen

Wenn Sie ein Element in der Stil-Factory-Funktion gestalten, können Sie Folgendes festlegen:

• Strichfarbe und ‑deckkraft des Rahmens, wie durch die Klasse Color definiert. Der Standardwert ist transparent (Color.TRANSPARENT).

• Strichstärke des Rahmens in Bildschirmpixeln. Der Standardwert liegt bei 2.

• Füllfarbe und Deckkraft, wie durch die Klasse Color definiert. Der Standardwert ist transparent (Color.TRANSPARENT).

• Punktradius eines Punkt-Features zwischen 0 und 128 Pixeln.

Einfache Stilregeln verwenden

Die einfachste Möglichkeit, Stile für Elemente festzulegen, ist die Definition eines FeatureLayer.StyleFactory, das unabhängig vom Element immer ein identisches FeatureStyle-Objekt erstellt. Sie können Stiloptionen für Elemente direkt auf eine Elementebene des Datasets anwenden oder sie in Verbindung mit einer FeatureStyleFunction verwenden.

Deklarative Stilregeln verwenden

Sie können Stilregeln deklarativ auf Grundlage eines Attributs festlegen und auf das gesamte Dataset anwenden. Über die Stilfunktion für Elemente können Sie auch null zurückgeben, z. B. wenn ein Teil der Elemente unsichtbar bleiben soll.

Verwenden Sie beispielsweise die Methode DatasetFeature.getDatasetAttributes(), um ein Map<String,String> mit Dataset-Attributen für ein Feature zurückzugeben. Anschließend können Sie den Stil des Elements anhand seiner Attribute anpassen.

In diesem Beispiel wird der Wert des Attributs „highlightColor“ für jedes Merkmal eines Datasets bestimmt, um das Styling zu steuern:

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

Stil auf die Dataset-Featureebene anwenden

In diesem Beispiel wird eine Stil-Factory-Funktion auf ein Polygon in der Elementebene des Datasets angewendet. Die Stil-Factory-Funktion wendet einen benutzerdefinierten Füll- und Strichstil auf das Polygon an:

1. Falls noch nicht geschehen, erstellen Sie eine neue Karten-ID und einen neuen Kartenstil. Folgen Sie dazu der Anleitung unter Erste Schritte. Aktivieren Sie auf jeden Fall die Element-Ebene Datasets.

2. Rufen Sie einen Verweis auf die Elementebene „Datasets“ ab, wenn die Karte initialisiert wird.

   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. Erstellen Sie eine Stil-Factory-Funktion und wenden Sie sie auf die Dataset-Ebene an.

   Im folgenden Beispiel werden alle Elemente im Dataset mit derselben Füllung und Kontur versehen.

   Hinweis: In diesem Beispiel wird geprüft, ob das an die Funktion der Stilfactory übergebene Feature vom Typ DatasetFeature ist. Da die Stilfactory-Funktion jedoch denselben Stil auf alle Elemente im Datensatz anwendet, wird das DatasetFeature-Objekt nicht verwendet. Beispiele, in denen Stile basierend auf dem Inhalt des DatasetFeature-Objekts bedingt angewendet werden, finden Sie unter Beispiele für das Gestalten von Datenelementen.

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

Stile von einer Ebene entfernen

Wenn Sie Stile von einer Ebene entfernen möchten, rufen Sie FeatureLayer.setFeatureStyle(null) auf.

Über die Stilfactory können Sie auch null zurückgeben, z. B. wenn ein Teil der Elemente unsichtbar bleiben soll.