Estilizar um polígono de limites

Selecione a plataforma: Android iOS JavaScript

Para aplicar estilos de traço e preenchimento a polígonos de limites em uma camada de elementos:

  1. Crie uma função de fábrica de estilo que implemente a interface FeatureLayer.StyleFactory. Essa função define a lógica de estilo de uma camada de elementos.

  2. Chame FeatureLayer.setFeatureStyle() para aplicar a função de fábrica de estilo à camada de elementos.

O mapa de exemplo a seguir demonstra o destaque do polígono de limites de um região única em uma camada de elementos de localidade.

Captura de tela mostrando o polígono de Hana, Havaí.

Criar uma função de fábrica de estilo

A função de fábrica de estilo é aplicada a todos os polígonos no elemento afetado camada no momento em que define a função na camada de elementos. Essa função precisa retornar um objeto FeatureStyle que especifique como estilizar o polígono.

O SDK do Maps para Android transmite um Feature para a função de fábrica de estilo. A instância Feature representa os metadados do elemento, dando acesso aos metadados na função da fábrica de estilos.

A função de fábrica de estilo deve sempre retornar resultados consistentes quando é aplicada. Por exemplo, se você quisesse colorir aleatoriamente um conjunto de elementos, a parte aleatória não deve ocorrer na função de estilo do elemento, pois isso pode causar resultados não intencionais.

Como essa função é executada em todos os elementos de uma camada, a otimização é importante. Para não afetar os tempos de renderização:

  • Ative somente as camadas de elementos necessárias.

  • Chamar FeatureLayer.setFeatureStyle(null) quando uma camada de elementos não estiver mais em uso.

Definir traço e preenchimento do polígono

Ao estilizar um polígono de limite na função de fábrica de estilo, é possível definir:

  • Cor e opacidade do traço da borda do polígono no formato de cor ARGB, conforme definido pela classe Color. O valor padrão é transparente (0x00000000).

  • Largura do traço da borda do polígono em pixels da tela. O valor padrão é 2.

  • Cor e opacidade de preenchimento do polígono no formato de cor ARGB, conforme definido pela classe Color. O valor padrão é transparente (0x00000000).

Pesquisar IDs de lugares para segmentar elementos

Muitos aplicativos aplicam estilos a um elemento com base na localização dele. Para exemplo, convém aplicar o estilo a diferentes países, territórios ou ou várias regiões. O local do elemento é representado ID de lugar.

IDs de lugares identificam um local de forma exclusiva no banco de dados do Google Places e no Google Google Maps. Para conseguir um ID de lugar:

A cobertura varia de acordo com a região. Consulte Cobertura dos limites do Google para mais detalhes.

Os nomes geográficos estão disponíveis em muitas fontes, como o USGS Board on Geographic Names e o U.S. Gazetteer Files (links em inglês).

Usar o PlaceFeature para conseguir um ID de lugar

O PlaceFeature é uma subclasse da classe Feature. Ela representa um elemento de lugar (um elemento com um ID de lugar) que inclui atributos do tipo ADMINISTRATIVE_AREA_LEVEL_1, ADMINISTRATIVE_AREA_LEVEL_2, COUNTRY, LOCALITY, POSTAL_CODE e SCHOOL_DISTRICT.

Quando o ID do lugar está disponível, o SDK do Maps para Android transmite uma instância de PlaceFeature para a função da fábrica de estilos para que você possa determinar o local do recurso.

Exemplo de fábrica de estilo

Este exemplo aplica uma função de fábrica de estilo a um polígono na região administrativa camada de elementos. A função de fábrica de estilo determina o ID do lugar do elemento usando a instância PlaceFeature. Se o ID de lugar for de Hana, Havaí, a função aplica um preenchimento personalizado e estilo de traço ao polígono:

  1. Caso ainda não tenha feito isso, siga as etapas em Vamos começar para criar um novo ID e estilo de mapa. Ative a camada de elemento Região administrativa.

  2. Receba uma referência para a camada de elemento de localidade quando o mapa for inicializado.

    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. Criar uma função de fábrica de estilo e aplicá-la à região administrativa. camada de elementos.

    O exemplo a seguir só aplica a função se o ID do lugar do elemento for Hana, Havaí ("ChIJ0zQtYiWsVHkRk8lRoB1RNPo"). Se o ID de lugar especificado não for de Hana, no Havaí, o estilo não será aplicado.

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

Remover o estilo de uma camada

Para remover o estilo de uma camada, chame FeatureLayer.setFeatureStyle(null).