Definisci un poligono di confine

Seleziona la piattaforma: Android iOS JavaScript

Per applicare stili per tratto e riempimento ai poligoni di confine in un livello di funzionalità:

  1. Crea una funzione di fabbrica di stili che implementi l'interfaccia FeatureLayer.StyleFactory. Questa funzione definisce la logica di stile per un livello di elementi.

  2. Chiama FeatureLayer.setFeatureStyle() per applicare la funzione della factory di stili al livello di funzionalità.

La mappa di esempio seguente mostra l'evidenziazione del poligono di confine di una singola regione in un livello di funzionalità Località.

Uno screenshot che mostra il poligono di Hana, Hawaii.

Creare una funzione di fabbrica di stili

La funzione di fabbrica di stili viene applicata a ogni poligono nel livello di elementi interessato al momento dell'impostazione della funzione sul livello di elementi. Questa funzione deve restituire un oggetto FeatureStyle che specifica lo stile del poligono.

Maps SDK for Android passa un'istanza di Feature alla funzione di fabbrica dello stile. L'istanza Feature rappresenta i metadati della funzionalità, che ti consente di accedere ai metadati nella funzione della factory di stili.

La funzione di fabbrica dello stile deve sempre restituire risultati coerenti quando viene applicata. Ad esempio, se vuoi colorare in modo casuale un insieme di elementi, la parte aleatoria non deve essere presente nella funzione di stile degli elementi, in quanto causerebbe risultati indesiderati.

Poiché questa funzione viene eseguita su ogni elemento di un livello, l'ottimizzazione è importante. Per evitare di influire sui tempi di rendering:

  • Attiva solo i livelli di funzionalità necessari.

  • Chiama FeatureLayer.setFeatureStyle(null) quando un livello di funzionalità non è più in uso.

Impostare il tratto e il riempimento del poligono

Quando stili un poligono di confine nella funzione di fabbrica di stili, puoi impostare:

  • Colore e opacità del tratto del bordo del poligono nel formato di colore ARGB, come definito dalla classe Color. Il valore predefinito è trasparente (0x00000000).

  • Spessore del tratto del bordo del poligono in pixel dello schermo. Il valore predefinito è 2.

  • Colore e opacità di riempimento del poligono nel formato di colore ARGB, come definito dalla classe Color. Il valore predefinito è trasparente (0x00000000).

Cerca gli ID luogo per scegliere le funzionalità target

Molte applicazioni applicano stili a un elemento in base alla sua posizione. Ad esempio, potresti voler applicare uno stile a paesi, territori o regioni diversi. La posizione della funzionalità è rappresentata da un ID luogo.

Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. Per ottenere un ID luogo:

La copertura varia in base alla regione. Per maggiori dettagli, consulta la sezione Copertura dei confini di Google.

I nomi geografici sono disponibili in molte fonti, come la commissione USGS Board on Geographic Names e i file del dizionario geografico degli Stati Uniti.

Utilizzare PlaceFeature per ottenere un ID luogo

La classe PlaceFeature è una sottoclasse della classe Feature. Rappresenta un'elemento posizione (un elemento con un ID posizione) che include elementi di tipo ADMINISTRATIVE_AREA_LEVEL_1, ADMINISTRATIVE_AREA_LEVEL_2, COUNTRY, LOCALITY, POSTAL_CODE e SCHOOL_DISTRICT.

Quando l'ID luogo è disponibile, l'SDK Maps per Android passa un'istanza di PlaceFeature alla funzione della fabbrica di stili in modo da poter determinare la posizione della funzionalità.

Esempio di fabbrica di stili

Questo esempio applica una funzione di fabbrica di stili a un poligono nel livello di funzionalità Località. La funzione di fabbrica dello stile determina l'ID posizione della funzionalità utilizzando l'istanza PlaceFeature. Se l'ID luogo corrisponde a Hana, nelle Hawaii, la funzione applica uno stile di riempimento e tratto personalizzato al poligono:

  1. Se non l'hai ancora fatto, segui i passaggi descritti in Inizia per creare un nuovo ID mappa e uno stile mappa. Assicurati di attivare il livello entità Località.

  2. Ottieni un riferimento al livello di funzionalità Località all'inizializzazione della mappa.

    Java

    private FeatureLayer localityLayer;
    
@Override
public void onMapReady(GoogleMap map) {
  // Get the LOCALITY feature layer.
  localityLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
    .featureType(FeatureType.LOCALITY)
    .build());
    
  // Apply style factory function to LOCALITY layer.
  styleLocalityLayer();
}

    Kotlin

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

  3. Crea una funzione di fabbrica di stili e applicala al livello di funzionalità Località.

    L'esempio seguente applica la funzione solo se l'ID luogo della funzionalità è per Hana, Hawaii ("ChIJ0zQtYiWsVHkRk8lRoB1RNPo"). Se l'ID luogo specificato non si riferisce a Hana, nelle Hawaii, lo stile non viene applicato.

    Java

    private void styleLocalityLayer() {
    
  // Create the style factory function.
  FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
    
    // Check if the feature is an instance of PlaceFeature,
    // which contains a place ID.
    if (feature instanceof PlaceFeature) {
      PlaceFeature placeFeature = (PlaceFeature) feature;
    
      // Determine if the place ID is for Hana, HI.
      if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
    
        // Use FeatureStyle.Builder to configure the FeatureStyle object
        // returned by the style factory function.
        return new FeatureStyle.Builder()
          // Define a style with purple fill at 50% opacity and solid purple border.
          .fillColor(0x80810FCB)
          .strokeColor(0xFF810FCB)
          .build();
      }
    }
    return null;
  };
    
  // Apply the style factory function to the feature layer.
  localityLayer.setFeatureStyle(styleFactory);
}

    Kotlin

    private fun styleLocalityLayer() {
    
  // Create the style factory function.
  val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
    
      // Check if the feature is an instance of PlaceFeature,
      // which contains a place ID.
      if (feature is PlaceFeature) {
          val placeFeature: PlaceFeature = feature as PlaceFeature
    
          // Determine if the place ID is for Hana, HI.
          if (placeFeature.getPlaceId().equals("ChIJ0zQtYiWsVHkRk8lRoB1RNPo")) {
    
              // Use FeatureStyle.Builder to configure the FeatureStyle object
              // returned by the style factory function.
              return@StyleFactory FeatureStyle.Builder()
                  // Define a style with purple fill at 50% opacity and
                  // solid purple border.
                  .fillColor(0x80810FCB.toInt())
                  .strokeColor(0xFF810FCB.toInt())
                  .build()
          }
      }
      return@StyleFactory null
  }
    
  // Apply the style factory function to the feature layer.
  localityLayer?.setFeatureStyle(styleFactory)
}

Rimuovere lo stile da un livello

Per rimuovere lo stile da un livello, chiama FeatureLayer.setFeatureStyle(null).