Vamos começar

Selecione a plataforma: Android iOS JavaScript

Para usar o estilo baseado em dados para limites, crie um ID do mapa. Em seguida, crie um novo estilo de mapa, selecione as camadas de elementos de limite necessárias e associe o estilo ao ID do mapa.

Criar um ID do mapa

Um mapID é um identificador exclusivo que representa uma única instância de um mapa do Google. É possível criar IDs de mapa e atualizar um estilo associado a eles a qualquer momento no Console do Google Cloud.

Criar um estilo de mapa

Para criar um estilo de mapa, siga as instruções em Gerenciar estilos de mapa. Depois disso, associe o estilo ao ID do mapa recém-criado.

Selecionar camadas de elementos

No console do Google Cloud, selecione as camadas de elementos a serem mostradas. Isso determina os tipos de limite que aparecem no mapa (por exemplo, localidades, estados etc.).

Importante: para garantir a performance ideal, selecione apenas as camadas necessárias.

Gerenciar camadas de elementos

1. No console do Google Cloud, acesse a página Estilos de mapa.

2. Selecione um projeto, se solicitado.

3. Selecione um estilo de mapa.

4. Clique no menu suspenso Camadas de elementos para adicionar ou remover camadas.

5. Clique em Salvar para disponibilizar as mudanças nos mapas.

Atualizar o código de inicialização do seu mapa

Nesta etapa, é necessário associar um ID do mapa a um estilo com uma ou mais camadas de elementos ativadas. Para verificar se o ID do mapa está configurado corretamente no Console do Cloud, revise como ele está configurado em Gerenciamento de mapas.

Swift

// A map ID using a style with one or more feature layers enabled

let mapID = GMSMapID(identifier: "YOUR_MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

Objective-C

// A map ID using a style with one or more feature layers enabled

GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];

Importante: para fins de teste, você pode pular a etapa de criação e configuração de um ID de mapa usando mapId: DEMO_MAP_ID no código do app. O código DEMO_MAP_ID é destinado apenas a testes. Não use DEMO_MAP_ID em um ambiente de produção.

Adicionar camadas de elementos a um mapa

Chame mapView.featureLayer(of:) na inicialização do mapa para consultar a referência a uma camada de elementos dele:

Swift

let layer = mapView.featureLayer(of: .locality)

Objective-C

GMSFeatureLayer *layer = [mapView featureLayerOfFeatureType:GMSFeatureTypeLocality];

Verificar recursos do mapa

O estilo baseado em dados para limites exige recursos que são ativados no Console do Google Cloud e associados a um ID do mapa. Como os IDs de mapa estão sujeitos a mudanças, chame mapView.mapCapabilities em um GMSMapView para verificar se um determinado recurso (por exemplo, estilo baseado em dados) está disponível antes de chamá-lo.

Também é possível detectar mudanças nos recursos do mapa se inscrevendo em GMSViewDelegate. Este exemplo mostra como usar o protocolo para verificar os requisitos de estilo orientados a dados.

Swift

class SampleViewController: UIViewController {

  private lazy var mapView: GMSMapView = GMSMapView(frame: .zero, mapID: GMSMapID(identifier: "YOUR_MAP_ID"), camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

  override func loadView() {
    self.view = mapView
    mapView.delegate = self
  }
}

extension SampleViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, didChange mapCapabilities: GMSMapCapabilityFlags) {
    if (!mapCapabilities.contains(.dataDrivenStyling)) {
      // Data-driven styling is *not* available, add a fallback.
      // Existing feature layers are also unavailable.
    }
  }
}

Objective-C

@interface SampleViewController: UIViewController <GMSMapViewDelegate>
@end

@implementation SampleViewController
- (void)loadView {
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:[GMSMapID mapIDWithIdentifier:@"MAP_ID"] camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];
  mapView.delegete = self;
  self.view = mapView;
}

- (void)mapView:(GMSMapView *)mapView didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities {
  if (!(mapCapabilities & GMSMapCapabilityFlagsDataDrivenStyling)) {
    // Data-driven styling is *not* available, add a fallback.
    // Existing feature layers are also unavailable.
  }
}
@end