Veri kümesini harita ve stil veri kümesine ekleme

Platform seçin: Android iOS JavaScript

Bu sayfada, bir haritaya veri kümesi ekleme ve stil uygulama işlemleri gösterilmektedir.

Ön koşullar

Devam etmeden önce bir harita kimliğiniz, harita stiliniz ve veri kümesi kimliğiniz olmalıdır.

• Harita kimliği ve harita stili oluşturma

• Veri kümesi oluşturup yükleme

  Not: Uygulamanızı başlatmak için veri kümenizin kimliğine ihtiyacınız vardır.

Veri kümesi kimliğini harita stiliyle ilişkilendirme

Bir veri kümesinin özelliklerine stil uygulamak için haritanın veri kümesi özellik katmanına bir stil işlevi uygularsınız. Veri kümesi özellik katmanı, bir veri kümesini harita stiliyle ilişkilendirdiğinizde oluşturulur.

Veri kümenizi harita stiliyle ilişkilendirmek için:

1. Google Cloud Console'da Veri Kümeleri sayfasına gidin.
2. Veri kümesinin adını tıklayın. Veri kümesi ayrıntıları sayfası görünür.
3. Önizleme sekmesini tıklayın.
4. İlişkili harita stilleri bölümünde Harita stili ekle'yi tıklayın.
   
5. İlişkilendirilecek harita stillerinin onay kutularını ve ardından KAYDET'i tıklayın.

Dikkat: Bir haritada birden fazla veri kümesinin oluşturulması, veri kümelerinin boyutuna ve sayısına bağlı olarak performansı etkileyebilir.

Veri kümesine stil uygulama

Bir veri kümesine stil uygulamak için:

1. FeatureLayer.StyleFactory arayüzünü uygulayan bir stil fabrikası işlevi oluşturun. Bu işlev, bir veri kümesinin stil mantığını tanımlar.

2. Stil fabrikası işlevini veri kümesindeki her bir özelliğe uygulamak için FeatureLayer.setFeatureStyle() işlevini çağırın.

Stil fabrikası işlevi oluşturma

Stil fabrikası işlevi, işlevi özellik katmanında ayarladığınız sırada veri kümesi katmanındaki her özelliğe uygulanır. Bu işlev, poligonun stilini nasıl alacağını belirten bir FeatureStyle nesnesi döndürmelidir.

Stil fabrikası null döndürürse söz konusu özellik oluşturulmaz. Daha fazla bilgi için Bir katmandan stili kaldırma başlıklı makaleyi inceleyin.

Not: Bir özellik katmanı için stil fabrikası işlevini günceller veya değiştirirseniz özellik katmanındaki işlevi sıfırlamak için FeatureLayer.setFeatureStyle() işlevini tekrar çağırmanız gerekir.

Android için Haritalar SDK'sı, stil fabrikası işlevine bir Feature örneği iletir. Feature örneği, özelliğin meta verilerini temsil eder ve stil fabrikası işlevindeki meta verilere erişmenizi sağlar.

Not: Bir veri kümesi örneği aslında Feature alt sınıfı olan DatasetFeature türündedir.

Stil fabrikası işlevi uygulandığında her zaman tutarlı sonuçlar döndürmelidir. Örneğin, bir dizi özelliği rastgele renklendirmek istiyorsanız rastgelelik özelliği, özellik stili işlevinde yer almamalıdır. Aksi takdirde istenmeyen sonuçlar ortaya çıkar.

Bu işlev, bir katmandaki her özellik üzerinde çalıştığından optimizasyon önemlidir. Oluşturma sürelerini etkilememek için bir özellik katmanı artık kullanılmadığında FeatureLayer.setFeatureStyle(null) işlevini çağırın.

Veri kümesinin kimliğini almak için FeatureLayer.getDatasetId() işlevini de çağırabilirsiniz.

Fırça, dolgu ve nokta yarıçapını ayarlama

Stil fabrikası işlevinde bir özelliğe stil uygularken şunları ayarlayabilirsiniz:

• Color sınıfı tarafından tanımlanan kenarlık fırça rengi ve şeffaflığı. Varsayılan değer şeffaftır (Color.TRANSPARENT).

• Kenarlığın ekran piksel cinsinden çizgi genişliği. Varsayılan değer 2'dir.

• Color sınıfı tarafından tanımlanan dolgu rengi ve opaklığı. Varsayılan değer şeffaftır (Color.TRANSPARENT).

• Bir nokta özelliğinin 0 ile 128 piksel arasında olan nokta yarıçapı.

Basit stil kuralları kullanın

Özelliklere stil uygulamanın en basit yolu, özellikten bağımsız olarak her zaman aynı FeatureStyle nesnesini oluşturan bir FeatureLayer.StyleFactory tanımlamaktır. Özellik stili seçeneklerini doğrudan bir veri kümesi özellik katmanına uygulayın veya FeatureStyleFunction ile birlikte kullanın.

Beyan stili kurallarını kullanma

Stil kurallarını bir özellik özelliğine göre açık bir şekilde ayarlayabilir ve veri kümenizin tamamına uygulayabilirsiniz. Örneğin, bir özellik alt kümesinin görünmez kalmasını istiyorsanız özellik stili işlevinizden null döndürebilirsiniz.

Örneğin, bir özellik için veri kümesi özelliklerinin listesini döndürmek üzere DatasetFeature.getDatasetAttributes() yöntemini kullanın.Map<String,String> Ardından, özelliğin stilini özelliklerine göre özelleştirebilirsiniz.

Bu örnekte, stili kontrol etmek için bir veri kümesinin her özelliğinin "highlightColor" özelliğinin değeri belirlenir:

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

Veri kümesi özellik katmanına stil uygulama

Bu örnekte, stil fabrikası işlevi veri kümesi özellik katmanındaki bir poligona uygulanmaktadır. Stil fabrikası işlevi, poligona özel bir dolgu ve çizgi stili uygular:

1. Henüz yapmadıysanız yeni bir harita kimliği ve harita stili oluşturmak için Başlayın bölümündeki adımları uygulayın. Veri Kümeleri özellik katmanını etkinleştirdiğinizden emin olun.

2. Harita başlatılırken Veri Kümeleri özellik katmanına referans alın.

   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. Stil fabrikası işlevi oluşturun ve bunu Veri Kümeleri özellik katmanına uygulayın.

   Aşağıdaki örnekte, veri kümesindeki tüm özelliklere aynı dolgu ve kontur uygulanmaktadır.

   Not: Bu örnekte, stil fabrikası işlevine iletilen özelliğin DatasetFeature türüne ait olup olmadığı kontrol edilir. Ancak stil fabrikası işlevi, veri kümesindeki tüm özelliklere aynı stili uyguladığından DatasetFeature nesnesini kullanmaz. DatasetFeature nesnesinin içeriğine göre koşullu olarak stil uygulayan örnekler için Stil verileri özelliği örnekleri başlıklı makaleyi inceleyin.

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

Katmandan stili kaldırma

Bir katmandan stili kaldırmak için FeatureLayer.setFeatureStyle(null) işlevini çağırın.

Örneğin, bir özellik alt kümesinin görünmez kalmasını istiyorsanız null öğesini stil fabrikanızdan da iade edebilirsiniz.