Dodaj zbiór danych do zbioru danych mapy i stylu

Wybierz platformę: Android iOS JavaScript

Na tej stronie dowiesz się, jak dodać zbiór danych do mapy i zastosować style.

Wymagania wstępne

Zanim przejdziesz dalej, musisz mieć identyfikator mapy, styl mapy i identyfikator zbioru danych.

• Tworzenie identyfikatora mapy i stylu mapy

• Tworzenie i przesyłanie zbioru danych

  Uwaga: aby zainicjować aplikację, musisz mieć identyfikator zbioru danych.

Powiązywanie identyfikatora zbioru danych ze stylem mapy

Aby określić styl elementów zbioru danych, zastosuj funkcję stylu do warstwy elementów zbioru danych na mapie. Warstwa funkcji zbioru danych jest tworzona, gdy powiążesz zbiór danych ze stylem mapy.

Eksperymentalna: to ustawienie można skonfigurować tylko w przypadku jasnych stylów mapy. Gdy połączysz identyfikator mapy z jasnym stylem mapy, w którym ta funkcja jest włączona, włączone warstwy będą też dostępne w przypadku ciemnego stylu mapy.

Aby powiązać zbiór danych ze stylem mapy:

1. W konsoli Google Cloud otwórz stronę Zbiory danych.
2. Kliknij nazwę zbioru danych. Pojawi się strona Szczegóły zbioru danych.
3. Kliknij kartę Podgląd.
4. W sekcji Powiązane style mapy kliknij DODAJ STYL MAPY.
   
5. Zaznacz pola wyboru stylów mapy, które chcesz powiązać, a następnie kliknij ZAPISZ.

Ostrzeżenie: renderowanie wielu zbiorów danych na mapie może wpływać na wydajność w zależności od rozmiaru i liczby zbiorów danych.

Stosowanie stylów do zbioru danych

Aby zastosować style do zbioru danych:

1. Utwórz funkcję fabryki stylów, która implementuje interfejs FeatureLayer.StyleFactory. Ta funkcja określa logikę stylu zbioru danych.

2. Wywołaj funkcję FeatureLayer.setFeatureStyle() , aby zastosować funkcję fabryki stylów do każdego elementu w zbiorze danych.

Tworzenie funkcji fabryki stylów

Funkcja fabryki stylów jest stosowana do każdego elementu w warstwie zbioru danych w momencie ustawienia funkcji w warstwie elementów. Ta funkcja musi zwracać obiekt FeatureStyle, który określa sposób stylizowania wielokąta.

Jeśli fabryka stylów zwróci null, dana funkcja nie zostanie wyrenderowana. Więcej informacji znajdziesz w artykule Usuwanie stylów z warstwy.

Notatka: Jeśli aktualizujesz lub modyfikujesz funkcję fabryki stylów dla warstwy obiektów, musisz wywołaćFeatureLayer.setFeatureStyle() ponownie, aby zresetować funkcję na warstwie obiektów.

Pakiet Maps SDK na Androida przekazuje do funkcji fabryki stylu instancję Feature. Obiekt Feature reprezentuje metadane funkcji, co umożliwia dostęp do metadanych w funkcji fabryki stylów.

Uwaga: w przypadku zbioru danych instancja jest w rzeczywistości typu DatasetFeature, który jest klasą podrzędną klasy Feature.

Funkcja fabryczna stylu powinna zawsze zwracać spójne wyniki. Jeśli na przykład chcesz losowo pokolorować zestaw obiektów, losowanie nie powinno odbywać się w funkcji stylu obiektu, ponieważ spowoduje to niepożądane wyniki.

Ponieważ ta funkcja jest uruchamiana dla każdej cechy w warstwie, optymalizacja jest ważna. Aby uniknąć wpływu na czas renderowania, wywołuj funkcję FeatureLayer.setFeatureStyle(null), gdy warstwa funkcji nie jest już używana.

Możesz też zadzwonić pod numer FeatureLayer.getDatasetId(), aby uzyskać identyfikator zbioru danych.

Ustawianie kreski, wypełnienia i promienia punktu

Podczas stylizowania elementu w funkcji fabryki stylów możesz ustawić:

• Kolor i przezroczystość konturu obramowania zdefiniowane przez klasęColor. Wartością domyślną jest przezroczystość (Color.TRANSPARENT).

• Szerokość obrysu obramowania w pikselach ekranu. Wartość domyślna wynosi 2.

• Kolor wypełnienia i przezroczystość zdefiniowane przez klasę Color. Wartością domyślną jest przezroczystość (Color.TRANSPARENT).

• Promień punktu elementu punktowego w zakresie od 0 do 128 pikseli.

Używanie prostych reguł stylu

Najprostszym sposobem stylizowania funkcji jest zdefiniowanie FeatureLayer.StyleFactory, które zawsze buduje identyczny obiekt FeatureStyle, niezależnie od funkcji. Zastosuj opcje stylu obiektów bezpośrednio do warstwy obiektów zestawu danych lub użyj ich w połączeniu z FeatureStyleFunction.

Używanie deklaratywnych reguł stylu

Reguły stylu można deklaratywnie ustawić na podstawie atrybutu obiektu i zastosować je w całym zestawie danych. Możesz zwrócić null z funkcji stylu elementu, na przykład jeśli chcesz, aby podzbiór elementów pozostał niewidoczny.

Na przykład użyj metody DatasetFeature.getDatasetAttributes(), aby zwrócić atrybuty zbioru danych Map<String,String> dla funkcji. Następnie możesz dostosować styl obiektu na podstawie jego atrybutów.

W tym przykładzie określono wartość atrybutu „highlightColor” każdej cechy zestawu danych w celu kontrolowania stylu:

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

Stosowanie stylu do warstwy cech zbioru danych

Ten przykład stosuje funkcję fabryki stylów do wielokąta w warstwie obiektów zbioru danych. Funkcja fabryki stylów stosuje do wielokąta niestandardowy styl wypełnienia i obrysu:

1. Jeśli nie masz jeszcze identyfikatora mapy i stylu mapy, wykonaj czynności opisane w sekcji Pierwsze kroki. Włącz warstwę obiektów Zbiory danych.

2. Uzyskaj odniesienie do warstwy obiektów zbiorów danych podczas inicjowania mapy.

   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. Utwórz funkcję fabryki stylów i zastosuj ją do warstwy obiektów Datasets.

   W tym przykładzie to samo wypełnienie i ten sam obrys są stosowane do wszystkich obiektów w zbiorze danych.

   Uwaga: ten przykład sprawdza, czy funkcja przekazana do funkcji fabryki stylów jest typu DatasetFeature. Funkcja fabryki stylów stosuje jednak ten sam styl do wszystkich obiektów w zbiorze danych, więc nie używa obiektu DatasetFeature. Przykłady, w których style są stosowane warunkowo na podstawie zawartości obiektu DatasetFeature, znajdziesz w sekcji Przykłady funkcji danych o stylach.

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

Usuwanie stylu z warstwy

Aby usunąć styl z warstwy, wywołaj FeatureLayer.setFeatureStyle(null).

Możesz też zwrócić null z fabryki stylów, np. jeśli chcesz, aby podzbiór funkcji pozostał niewidoczny.