Um ID de mapa é um identificador exclusivo usado para representar uma única instância de um mapa do Google. Você usa IDs de mapa para ativar recursos ou gerenciar ou estilizar mapas nos seus sites e aplicativos. É possível criar IDs de mapa para cada plataforma necessária (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 adequadas no nível de função, editor ou proprietário, na página do IAM do console do Cloud para o projeto. Para mais detalhes, consulte a 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, atribua um nome ao ID do mapa.
- Opcional: em Descrição, explique 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 Raster (padrão) ou Vetor. Para mais informações sobre mapas vetoriais, consulte Mapas vetoriais.
- Clique em Salvar para mostrar o novo ID do mapa.
Associar um ID de mapa a um estilo
Se você estiver usando a Estilização de mapas baseada na nuvem, vai associar um estilo ao seu ID. Para saber mais, consulte Associar um.
Adicionar o ID do mapa ao seu app
Android
Adicione o ID do mapa com um elemento <fragment> no
arquivo de layout da atividade usando a classe MapView ou de forma programática
usando a classe GoogleMapOptions.
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 usando um elemento <fragment> no arquivo de layout da atividade,
todos os fragmentos que devem ter o estilo personalizado precisam especificar o
ID do mapa 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:android="http://schemas.android.com/apk/res/android"
....
map:mapId="@string/map_id" />
Se quiser especificar um ID de mapa de maneira programática, transmita-o 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 de 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á definir o ID 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 você quiser conferir as mudanças imediatamente, feche e reinicie o app. Para isso, saia dele, forçando o encerramento da 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á está personalizando seu mapa com um código JSON incorporado, remova a propriedade
stylesdo objetoMapOptions. 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 existente 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 de mapa 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" />