Как создать фоновую картограмму

Фоновая картограмма – это разновидность тематической карты, на которой административные районы закрашиваются или заштриховываются в зависимости от значения параметра. С помощью функции фабрики стилей можно настроить стиль карты в соответствии с набором данных, в котором каждый административный район связан с определенным диапазоном числовых значений. В примере ниже показана фоновая картограмма для штатов США.

В этом примере данные состоят из идентификатора места штата. Функция фабрики стилей окрашивает каждый штат в зависимости от хешированного значения идентификатора места для этого штата.

1. Если вы этого ещё не сделали, создайте новый идентификатор карты и стиль карты, следуя инструкциям в статье Начало работы. Обязательно включите слой объектов Административный район уровня 1.

2. Получите ссылку на слой объектов административного района уровня 1 после инициализации карты. В США ему соответствуют штаты.

   Java

   private FeatureLayer areaLevel1Layer;
   
   @Override
   public void onMapReady(GoogleMap map) {
     areaLevel1Layer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.ADMINISTRATIVE_AREA_LEVEL_1)
       .build());
   
     // Apply style factory function to ADMINISTRATIVE_AREA_LEVEL_1 layer.
     styleAreaLevel1Layer();
   }

   Kotlin

   private var areaLevel1Layer: FeatureLayer? = null
   
   override fun onMapReady(googleMap: GoogleMap) {
     // Get the ADMINISTRATIVE_AREA_LEVEL_1 feature layer.
     areaLevel1Layer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder()
       .featureType(FeatureType.ADMINISTRATIVE_AREA_LEVEL_1)
       .build())
   
     // Apply style factory function to ADMINISTRATIVE_AREA_LEVEL_1 layer.
     styleAreaLevel1Layer()
   }

3. Создайте функцию фабрики стилей и примените ее к слою объектов "Административный район уровня 1". В следующем примере функция применяется к многоугольнику, представляющему каждый штат США.

   Java

   private void styleAreaLevel1Layer() {
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
       if (feature instanceof PlaceFeature) {
         PlaceFeature placeFeature = (PlaceFeature) feature;
   
         // Return a hueColor in the range [-299,299]. If the value is
         // negative, add 300 to make the value positive.
         int hueColor = placeFeature.getPlaceId().hashCode() % 300;
         if (hueColor < 0) {
           hueColor += 300;
         }
   
         return new FeatureStyle.Builder()
           // Set the fill color for the state based on the hashed hue color.
           .fillColor(Color.HSVToColor(150, new float[] {hueColor, 1, 1}))
           .build();
       }
       return null;
     };
   
     // Apply the style factory function to the feature layer.
     areaLevel1Layer.setFeatureStyle(styleFactory);
   }

   Kotlin

   private fun styleAreaLevel1Layer() {
     val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
         if (feature is PlaceFeature) {
             val placeFeature: PlaceFeature = feature as PlaceFeature
   
             // Return a hueColor in the range [-299,299]. If the value is
             // negative, add 300 to make the value positive.
             var hueColor: Int = placeFeature.getPlaceId().hashCode() % 300
             if (hueColor < 0) {
                 hueColor += 300
             }
             return@StyleFactory FeatureStyle.Builder()
             // Set the fill color for the state based on the hashed hue color.
               .fillColor(Color.HSVToColor(150, floatArrayOf(hueColor.toFloat(), 1f, 1f)))
               .build()
         }
         return@StyleFactory null
     }
   
     // Apply the style factory function to the feature layer.
     areaLevel1Layer?.setFeatureStyle(styleFactory)
   }