Um ID de mapa é um identificador exclusivo que representa as configurações de estilo e configuração do Google Maps armazenadas no Google Cloud. Você usa IDs de mapa para ativar recursos ou gerenciar ou estilizar mapas em seus sites e aplicativos. É possível criar IDs de mapa para cada plataforma de que você precisa (JavaScript, Android, iOS ou mapas estáticos) no projeto do console do Google Cloud na página Gerenciamento de mapas.
Para mais detalhes e recursos que usam IDs de mapa, consulte Visão geral do ID do mapa.
Permissões necessárias
Para criar ou gerenciar IDs de mapa no seu projeto, use um principal com as permissões de nível de papel adequadas (editor ou proprietário) na página IAM do console do Cloud para o projeto. Para mais detalhes, consulte Referência dos papéis básicos e predefinidos do IAM.
Criar IDs de mapa
Crie IDs de mapa no console do Cloud seguindo estas etapas:
Faça login e abra um projeto do console do Cloud com as permissões necessárias.
No console do Cloud, acesse a página Gerenciamento de mapas.
Clique em Criar ID do mapa.
Na página Criar novo ID de mapa, faça o seguinte:
- Em Nome, dê um nome ao ID do mapa.
- Opcional: em Descrição, descreva para que o ID do mapa é usado.
- Em Tipo de mapa, selecione a plataforma em que você planeja usar o ID do mapa. Se você escolher JavaScript, também escolha um tipo de mapa rasterizado (padrão) ou vetorial. Para mais informações sobre mapas vetoriais, consulte Mapas vetoriais.
- Clique em Salvar para mostrar o novo ID do mapa.
Associar um ID do mapa a um estilo de mapa
Se você estiver usando a Estilização de mapas baseada na nuvem, associe um estilo de mapa ao ID. Para mais detalhes, consulte Associar seu estilo a um ID do mapa.
Adicionar o ID do mapa ao seu app
Android
Adicione o ID de mapa com um <fragment> elemento no
arquivo de layout da atividade, usando a classe MapView ou aplicando a classe GoogleMapOptions por programação.
Por exemplo, suponha que você tenha criado um ID do mapa armazenado como um valor de string chamado map_id em res/values/strings.xml:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>
No caso de mapas adicionados ao arquivo de layout da atividade usando um elemento <fragment>,
todos os fragmentos que devem ter o estilo personalizado precisam especificar o
ID no atributo map:mapId:
<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
map:name="com.google.android.gms.maps.SupportMapFragment"
…
map:mapId="@string/map_id" />
Você também pode usar o atributo map:mapId da classe MapView para especificar um ID do mapa:
<com.google.android.gms.maps.MapView
xmlns:map="http://schemas.android.com/apk/res-auto"
....
map:mapId="@string/map_id" />
Se quiser especificar um ID de maneira programática, transmita para uma instância MapFragment usando a classe GoogleMapOptions:
Java
MapFragment mapFragment = MapFragment.newInstance(
new GoogleMapOptions()
.mapId(getResources().getString(R.string.map_id)));
Kotlin
val mapFragment = MapFragment.newInstance(
GoogleMapOptions()
.mapId(resources.getString(R.string.map_id))
)
No Android Studio, crie e execute seu app normalmente. Os estilos personalizados configurados na primeira etapa são aplicados a todos os mapas com o ID especificado.
iOS
Para instanciar um mapa usando um ID, faça o seguinte:
- Crie um
GMSMapIDcom a string do ID do mapa no console do Cloud. - Crie um
GMSMapViewespecificando o ID do mapa que você acabou de criar.
Swift
let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
longitude:-122.336471
zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;
Se você estiver usando seu próprio ID do mapa, poderá defini-lo no console do Cloud para ter um novo estilo a qualquer momento. Esse estilo será refletido na visualização do mapa automaticamente para você e os usuários em cerca de seis horas.
Se quiser ver as mudanças imediatamente, feche e reinicie o app saindo do app, forçando o encerramento do app na lista de apps usados recentemente e reabrindo-o. O mapa atualizado vai aparecer.
JavaScript
Para criar um mapa com um ID no código do aplicativo:
Se você já estiver personalizando o mapa com código JSON incorporado, remova a
stylespropriedade do seuMapOptionsobjeto. Caso contrário, pule esta etapa.Adicione um ID ao mapa usando a propriedade
mapId. Exemplo:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
Maps Static
Para adicionar um ID do mapa a um mapa novo ou atual que usa uma das nossas APIs de serviço da Web, anexe o parâmetro de URL map_id e defina-o como o ID do mapa. Este exemplo mostra como adicionar um ID a um mapa usando a API Maps Static.
<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=MAP_ID&signature=YOUR_SIGNATURE" />