GoogleMap

classe final pública GoogleMap estende Object

Esta é a classe principal do SDK do Google Maps para Android e é o ponto de entrada de todos os métodos relacionados ao mapa. Não é possível instanciar um objeto GoogleMap diretamente. Em vez disso, é necessário conseguir um do método getMapAsync() em um MapFragment ou MapView que você adicionou ao aplicativo.

Observação: semelhante a um objeto View, um GoogleMap só pode ser lido e modificado na linha de execução de IU do Android. Chamar métodos GoogleMap de outra linha de execução resultará em uma exceção.

É possível ajustar o ponto de vista de um mapa alterando a posição da câmera (em oposição ao movimento do mapa). Você pode usar a câmera do mapa para definir parâmetros como localização, nível de zoom, ângulo de inclinação e rolamento. Para ver mais informações, consulte Câmera e visualização.

Guia do desenvolvedor

Para começar, leia o guia do desenvolvedor do SDK do Google Maps para Android.

Resumo da classe aninhada

interface	GoogleMap.CancelableCallback		Uma interface de callback para informar quando uma tarefa é concluída ou cancelada.
interface	GoogleMap.WindowAdapter.		Fornece visualizações para renderização personalizada de janelas de informações.
interface	GoogleMap.OnCameraChangeListener		Esta interface foi descontinuada. Substituído por GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener e GoogleMap.OnCameraIdleListener. A ordem em que o método onCameraChange descontinuado é chamado em relação aos métodos nos novos listeners de mudança de câmera é indefinida.
interface	GoogleMap.OnCameraIdleListener		Interface de callback para o término do movimento da câmera.
interface	GoogleMap.OnCameraMoveCanceledListener		Interface de retorno de chamada para quando o movimento da câmera for interrompido ou quando a câmera começar a se mover por um novo motivo.
interface	GoogleMap.OnCameraMoveListener		Interface de callback para quando a câmera mudar de posição.
interface	GoogleMap.OnCameraMoveStartedListener		Interface de callback para quando o movimento da câmera começar.
interface	GoogleMap.OnCircleClickListener		Interface de callback para quando um círculo for clicado
interface	GoogleMap.OnGroundOverlayClickListener		Interface de callback para quando uma sobreposição de solo é clicada.
interface	GoogleMap.OnIndoorStateChangeListener		Um listener para quando o estado interno mudar.
interface	GoogleMap.OnWindowClickListener		Interface de callback para eventos de clique/toque na janela de informações do marcador.
interface	GoogleMap.OnWindowCloseListener		Interface de callback para eventos próximos na janela de informações do marcador.
interface	GoogleMap.OnKeywordLongClickListener		Interface de retorno de chamada para quando o usuário tocar e manter pressionada uma janela de informações do marcador.
interface	GoogleMap.OnMapClickListener		Interface de callback para o momento em que o usuário toca no mapa.
interface	GoogleMap.OnMapLoadedCallback		Interface de callback para o término da renderização do mapa.
interface	GoogleMap.OnMapLongClickListener		Interface de callback para quando o usuário toca no mapa e o mantém pressionado.
interface	GoogleMap.OnMarkerClickListener		Define assinaturas de métodos chamados quando alguém clica ou toca em um marcador.
interface	GoogleMap.OnMarkerDragListener		Interface de callback para eventos de arrastar em marcadores.
interface	GoogleMap.OnMyLocationButtonClickListener		Interface de retorno quando o botão "Meu local" recebe um clique.
interface	GoogleMap.OnMyLocationChangeListener		Esta interface foi descontinuada. Use com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi fornece melhor localização de localização e uso de energia e é usado pelo ponto azul "My Location". Consulte o tutorial Selecionar lugar atual, que usa a FusedLocationProviderApi, ou o Guia do desenvolvedor de localização.
interface	GoogleMap.OnMyLocationClickListener		Interface de callback para o clique no ponto "My Location", que indica o local do usuário.
interface	GoogleMap.OnPoiClickListener		Um listener para toques em PDIs.
interface	GoogleMap.OnPolygonClickListener		Interface de callback para o clique em um polígono.
interface	GoogleMap.OnPolygonClickListener		Interface de callback para quando uma polilinha for clicada.
interface	GoogleMap.SnapshotReadyCallback		Interface de callback para notificar quando o snapshot for feito.

Resumo da constante

int	MAP_TYPE_HYBRID (link em japonês)	Mapas por satélite com uma camada transparente das principais ruas.
int	MAP_TYPE_NONE (em inglês)	Nenhum bloco de mapa básico.
int	MAP_TYPE_NORMAL (link em norueguês)	Mapas básicos.
int	MAP_TYPE_SATELLITE (em inglês)	Mapas de satélite sem rótulos.
int	MAP_TYPE_TERRAIN (em inglês)	Mapas de terrenos

Resumo do método público

Circle	addCircle(opções CircleOptions) Adicionar um círculo ao mapa.
GroundOverlay	addGroundOverlay(opções GroundOverlayOptions) Adiciona uma imagem a este mapa.
Marker	addMarker(opções MarkerOptions) Adiciona um marcador ao mapa.
Polygon	addPolygon(opções PolygonOptions) Adiciona um polígono a este mapa.
Polyline	addPoly(opções PolyOptions) Adiciona uma polilinha a este mapa.
TileOverlay	addTileOverlay(opções TileOverlayOptions) Adiciona uma sobreposição de blocos a este mapa.
void	animateCamera(atualização do CameraUpdate) Anima o movimento da câmera da posição atual para a posição definida na atualização.
void	animateCamera(atualização do CameraUpdate, callback GoogleMap.CancelableCallback) Anima o movimento da câmera da posição atual para a posição definida na atualização e chama um retorno de chamada opcional na conclusão.
void	animateCamera(atualização do CameraUpdate, duração int de Ms, callback GoogleMap.CancelableCallback) Move o mapa de acordo com a atualização com uma animação durante um tempo especificado e chama um callback opcional na conclusão.
void	clear() Remove todos os marcadores, polilinhas, polígonos, sobreposições etc. do mapa.
CameraPosition	getCameraPosition(). Recebe a posição atual da câmera.
IndoorBuilding (link em inglês)	getFocusedBuilding () Recebe o edifício em foco no momento.
int	getStreetView () Recebe o tipo de mapa exibido no momento.
float	getMaxZoomLevel() Retorna o nível de zoom máximo da posição atual da câmera.
float	getMinZoomLevel() Retorna o nível de zoom mínimo.
Local	getMyLocation() Esse método foi descontinuado. Use com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi fornece melhor localização de localização e uso de energia e é usado pelo ponto azul "My Location". Consulte MyLocationDemoActivity na pasta de aplicativos de amostra para ver o código de exemplo ou o Guia do desenvolvedor de localização.
Projection	getEstimativa() Retorna um objeto Projection que pode ser usado para converter entre coordenadas de tela e coordenadas de latitude/longitude.
Configurações de IU	getUiSettings () Recebe as configurações da interface do usuário para o mapa.
boolean	isBuildingsEnabled() Retorna se a camada de construções em 3D está ativada.
boolean	isIndoorEnabled() Define se os mapas internos estão ativados.
boolean	isMyLocationEnabled() Acessa o status da camada my-location.
boolean	isTrafficEnabled() Verifica se o mapa está exibindo dados de trânsito.
void	moveCamera (atualização da CameraUpdate) Reposiciona a câmera de acordo com as instruções definidas na atualização.
void	resetMinMaxZoomPreference() Remove qualquer limite de zoom superior e inferior especificado anteriormente.
void	setBuildingsEnabled(booleano ativado) ativa ou desativa a camada de construções em 3D;
void	setContentDescription(descrição da string) Define uma contentDescription para o mapa.
boolean	setIndoorEnabled (booleano ativado) Define se os mapas internos devem ser ativados.
void	setWindowAdapter (adaptador GoogleMap.KeywordAdapter) Define um renderizador personalizado para o conteúdo das janelas de informações.
void	setLatLngBoundsForCameraTarget(limites de LatLngBounds) Especifica um LatLngBounds para restringir o alvo da câmera. Assim, quando os usuários rolam e movimentam o mapa, o alvo da câmera não se move fora desses limites.
void	setLocationSource(origem de LocationSource) Substitui a origem da localização da camada my-location.
boolean	setMapStyle (estilo MapStyleOptions) Define o estilo do mapa básico.
void	setStreetView(tipo int) Define o tipo de blocos de mapa que serão exibidos.
void	setMaxZoomPreference(flutuação maxZoomPreference) Define um limite superior preferido para o zoom da câmera.
void	setMinZoomPreference(float minZoomPreference) Define um limite inferior preferido para o zoom da câmera.
void	setMyLocationEnabled(booleano ativado) Ativa ou desativa a camada "my-location".
void	setOnCameraChangeListener(listener GoogleMap.OnCameraChangeListener) Esse método foi descontinuado. Substituído por setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) e setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).
void	setOnCameraIdleListener (listener GoogleMap.OnCameraIdleListener) Define um callback que é invocado quando o movimento da câmera termina.
void	setOnCameraMoveCanceledListener (listener GoogleMap.OnCameraMoveCanceledListener) Define um callback que é invocado quando o movimento da câmera é interrompido ou interrompido por um novo tipo de animação.
void	setOnCameraMoveListener(listener GoogleMap.OnCameraMoveListener) Define um callback que é invocado repetidamente enquanto a câmera está em movimento.
void	setOnCameraMoveStartedListener(listener GoogleMap.OnCameraMoveStartedListener) Define um callback que é invocado quando a câmera começa a se mover ou o motivo do movimento mudou.
void	setOnCircleClickListener (listener GoogleMap.OnCircleClickListener) Define um retorno de chamada que é invocado quando um círculo é clicado.
void	setOnGroundOverlayClickListener (listener GoogleMap.OnGroundOverlayClickListener) Define um callback que é invocado quando alguém clica em uma sobreposição de solo.
void	setOnIndoorStateChangeListener (listener GoogleMap.OnIndoorStateChangeListener) Define ou limpa o listener de eventos internos.
void	setOnWindowClickListener(listener GoogleMap.OnWindowClickListener) Define um retorno de chamada que é invocado quando uma janela de informações do marcador é clicada.
void	setOnWindowCloseListener (listener GoogleMap.OnWindowCloseListener) Define um retorno de chamada que é invocado quando uma janela de informações do marcador é fechada.
void	setOnWindowLongClickListener (listener GoogleMap.OnWindowLongClickListener) Define um retorno de chamada que é invocado quando uma janela de informações do marcador é pressionada e é pressionada.
void	setOnMapClickListener (listener GoogleMap.OnMapClickListener) Define um callback que é invocado quando o mapa é tocado.
void	setOnMapLoadedCallback (callback GoogleMap.OnMapLoadedCallback) Define um retorno de chamada que é invocado quando este mapa termina de ser renderizado.
void	setOnMapLongClickListener (listener GoogleMap.OnMapLongClickListener) Define um retorno de chamada que é invocado quando o mapa é pressionado por um período longo.
void	setOnMarkerClickListener(listener GoogleMap.OnMarkerClickListener) Define um retorno de chamada que é invocado quando um marcador é clicado.
void	setOnMarkerDragListener(listener GoogleMap.OnMarkerDragListener) Define um retorno de chamada que é invocado quando um marcador é arrastado.
void	setOnMyLocationButtonClickListener(listener GoogleMap.OnMyLocationButtonClickListener) Define um retorno de chamada que é invocado quando o botão "Meu local" é clicado.
void	setOnMyLocationChangeListener(listener GoogleMap.OnMyLocationChangeListener) Esse método foi descontinuado. Use com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi fornece melhor localização de localização e uso de energia e é usado pelo ponto azul "My Location". Consulte MyLocationDemoActivity na pasta de aplicativos de amostra para ver o código de exemplo ou o Guia do desenvolvedor de localização.
void	setOnMyLocationClickListener (listener GoogleMap.OnMyLocationClickListener) Define um callback que é invocado quando o ponto "Meu local" (que indica o local do usuário) é clicado.
void	setOnPoiClickListener (listener GoogleMap.OnPoiClickListener) Define um listener que será acionado quando um PDI for clicado ou tocado.
void	setOnPolygonClickListener(listener GoogleMap.OnPolygonClickListener) Define um retorno de chamada que é invocado quando um polígono é clicado.
void	setOnPolygonClickListener (listener GoogleMap.OnPolygonClickListener) Define um retorno de chamada que é invocado quando alguém clica em uma polilinha.
void	setPadding: int, left, int top, int right, int bottom) Define o padding no mapa.
void	setTrafficEnabled(booleano ativado) Ativa ou desativa a camada de trânsito.
void	snapshot (callback GoogleMap.SnapshotReadyCallback) Tira um snapshot do mapa.
void	snapshot(callback GoogleMap.SnapshotReadyCallback e bitmap de bitmap) Tira um snapshot do mapa.
void	stopAnimation() Para a animação da câmera, se houver uma em andamento.

Resumo do método herdado

Da classe java.lang.Object

boolean	equals(Objeto arg0)
Classe final<?>	getClass()
int	hashCode().
anulação final	notify()
anulação final	notifyAll()
String	toString().
anulação final	wait(long arg0, int arg1)
anulação final	wait(long arg0)
anulação final	wait()

Constantes

int público estático final MAP_TYPE_HYBRID

Mapas por satélite com uma camada transparente das principais ruas.

Valor constante: 4

int público estático final MAP_TYPE_NONE

Nenhum bloco de mapa básico.

Valor da constante: 0

int público estático int MAP_TYPE_NORMAL

Mapas básicos.

Valor da constante: 1

int público estático int MAP_TYPE_SATELLITE

Mapas de satélite sem rótulos.

Valor da constante: 2

int público estático final MAP_TYPE_TERRAIN

Mapas de terrenos

Valor da constante: 3

Métodos públicos

público Circle addCircle (CircleOptions opções)

Adicionar um círculo ao mapa.

Parâmetros

opções	Um objeto de opções do círculo que define como renderizar o círculo.

Retorna

• O objeto Circle que é adicionado ao mapa

público GroundOverlay addGroundOverlay (GroundOverlayOptions opções)

Adiciona uma imagem a este mapa.

Parâmetros

opções	Um objeto de opções de sobreposição de solo que define como renderizar a sobreposição. As opções precisam ter uma imagem (AnchoredBitmap) e uma posição especificada.

Retorna

• O GroundOverlay que foi adicionado ao mapa.

Gera

IllegalArgumentException	se a imagem ou a posição não for especificada nas opções.

Marker addMarker (MarkerOptions opções)

Adiciona um marcador ao mapa.

O ícone do marcador é renderizado no mapa na localização Marker.position. Um clique no marcador centraliza a câmera nele. Se Marker.title for definido, o mapa mostrará uma caixa de informações com o título e o snippet do marcador. Se o marcador for arrastável, clique nele e o arraste.

Parâmetros

opções	Um objeto de opções de marcador que define como renderizar o marcador.

Retorna

• O Marker que foi adicionado ao mapa.

público Polygon addPolygon (PolygonOptions opções)

Adiciona um polígono a este mapa.

Parâmetros

opções	Um objeto de opções de polígono que define como renderizar o polígono.

Retorna

• O objeto Polygon que é adicionado ao mapa.

polilinha adicionar polilinha (opções de polilinha)

Adiciona uma polilinha a este mapa.

Parâmetros

opções	Um objeto de opções de polilinha que define como renderizar a polilinha.

Retorna

• O objeto Polyline que foi adicionado ao mapa.

público TileOverlay addTileOverlay (OverlayOverlayOptions opções)

Adiciona uma sobreposição de blocos a este mapa. Consulte TileOverlay para mais informações.

Ao contrário de outras sobreposições, se o mapa for recriado, as sobreposições de blocos não serão restauradas automaticamente e precisarão ser adicionadas novamente de maneira manual.

Parâmetros

opções	Um objeto de opções de sobreposição de blocos que define como renderizar a sobreposição. As opções precisam ter um TileProvider especificado. Caso contrário, uma IllegalArgumentException será gerada.

Retorna

• O TileOverlay que foi adicionado ao mapa.

Gera

IllegalArgumentException	se TileProvider não estiver especificado nas opções.

public void animateCamera (CameraUpdate atualização)

Anima o movimento da câmera da posição atual para a posição definida na atualização. Durante a animação, uma chamada para getCameraPosition() retorna um local intermediário da câmera.

Consulte o conjunto de atualizações em CameraUpdateFactory.

Parâmetros

update	A alteração que deve ser aplicada à câmera.

void void animateCamera (CameraUpdate update, GoogleMap.CancelableCallback)

Anima o movimento da câmera da posição atual para a posição definida na atualização e chama um retorno de chamada opcional na conclusão. Consulte CameraUpdateFactory para ver um conjunto de atualizações.

Durante a animação, uma chamada para getCameraPosition() retorna um local intermediário da câmera.

Parâmetros

update	A alteração que deve ser aplicada à câmera.
callback	O callback a ser invocado na linha de execução de IU do Android quando a animação é interrompida. Se a animação for concluída normalmente, onFinish() será chamado. Caso contrário, onCancel() será chamado. Não atualize nem anime a câmera dentro do onCancel().

void public animateCamera (CameraUpdate update, int durationMs, GoogleMap.CancelableCallback callback)

Move o mapa de acordo com a atualização com uma animação durante um tempo especificado e chama um callback opcional na conclusão. Consulte o conjunto de atualizações em CameraUpdateFactory.

Se getCameraPosition() for chamado durante a animação, ele retornará o local atual da câmera em trânsito.

Parâmetros

update
duração Ms	É a duração da animação em milissegundos. Ele precisa ser estritamente positivo. Caso contrário, um IllegalArgumentException será gerado.
callback	Um callback opcional a ser notificado da linha de execução de IU do Android quando a animação for interrompida. Se a animação for interrompida devido à conclusão natural, o callback será notificado com onFinish(). Se a animação for interrompida por causa de uma interrupção por um movimento posterior da câmera ou um gesto do usuário, onCancel() será chamado. O callback não deve tentar mover nem animar a câmera no método de cancelamento. Se um callback não for obrigatório, deixe-o como null.

public void clear ()

Remove todos os marcadores, polilinhas, polígonos, sobreposições etc. do mapa.

público CameraPosition getCameraPosition ()

Recebe a posição atual da câmera.

O CameraPosition retornado é um instantâneo da posição atual e não será atualizado automaticamente quando a câmera se mover.

Para saber mais sobre como alterar a posição da câmera, consulte Câmera e visualização.

Retorna

• A posição atual da câmera.

IndoorBuilding getFocusedBuilding ()

Recebe o edifício em foco no momento.

Retorna

• O edifício com foco atual ou null se nenhum edifício estiver em foco.

int público getStreetView ()

Recebe o tipo de mapa exibido no momento. Consulte os valores possíveis em MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN.

Retorna

• O tipo de mapa.

ponto flutuante público getMaxZoomLevel ()

Retorna o nível de zoom máximo da posição atual da câmera. Esse valor considera o tipo de mapa usado no momento, por exemplo, o satélite ou o terreno pode ter um nível de zoom máximo menor que os blocos do Mapa básico.

Para ver mais informações sobre como alterar o nível de zoom da câmera, consulte Câmera e visualização.

Retorna

• O nível de zoom máximo disponível na posição atual da câmera.

flutuante público getMinZoomLevel ()

Retorna o nível de zoom mínimo. Isso é o mesmo para todos os locais (ao contrário do nível de zoom máximo), mas pode variar entre dispositivos e tamanhos de mapa.

Para ver mais informações sobre como alterar o nível de zoom da câmera, consulte Câmera e visualização.

Retorna

• O nível de zoom mínimo disponível.

local Local getMyLocation ()

Esse método foi descontinuado.
, use com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi fornece melhor localização de localização e uso de energia e é usado pelo ponto azul "My Location". Consulte MyLocationDemoActivity na pasta de aplicativos de amostra para ver o código de exemplo ou o Guia do desenvolvedor de localização.

Retorna a localização do usuário exibida no momento ou null se não houver dados de local disponíveis.

Retorna

• O user location exibido no momento.

Gera

IllegalStateException	se a camada my-location não estiver ativada.

público Projeção get existente ()

Retorna um objeto Projection que pode ser usado para converter entre coordenadas de tela e coordenadas de latitude/longitude.

O Projection retornado é um instantâneo da projeção atual e não será atualizado automaticamente quando a câmera se mover. Como essa operação é cara, só use a projeção uma vez por tela. O Google Maps usa a projeção de Mercator para criar mapas com base nos dados geográficos e converter pontos no mapa em coordenadas geográficas.

Retorna

• Projection do mapa no estado atual.

UiSettings público getUiSettings ()

Recebe as configurações da interface do usuário para o mapa.

Retorna

• O UiSettings para este mapa.

booleano público isBuildingsEnabled ()

Retorna se a camada de construções em 3D está ativada.

Retorna

• true se as construções estiverem ativadas. Caso contrário, false.

booleano público isIndoorEnabled ()

Define se os mapas internos estão ativados.

Retorna

• true se os mapas internos estiverem ativados; false se os mapas internos estiverem desativados

booleano público isMyLocationEnabled ()

Acessa o status da camada my-location.

Retorna

• true se a camada my-location estiver ativada. Caso contrário, false.

booleano público isTrafficEnabled ()

Verifica se o mapa está exibindo dados de trânsito. Isso está sujeito à disponibilidade de dados de tráfego.

Retorna

• true se os dados de tráfego estiverem ativados. Caso contrário, false.

public void moveCamera (CameraUpdate atualização)

Reposiciona a câmera de acordo com as instruções definidas na atualização. A movimentação é instantânea, e um getCameraPosition() subsequente refletirá a nova posição. Consulte CameraUpdateFactory para ver um conjunto de atualizações.

Parâmetros

update	A alteração que deve ser aplicada à câmera.

public void resetMinMaxZoomPreference ()

Remove qualquer limite de zoom superior e inferior especificado anteriormente.

public void setBuildingsEnabled (booleano ativado)

ativa ou desativa a camada de construções em 3D;

Parâmetros

ativado	Use true para ativar a camada de construções em 3D. false para desativar construções em 3D.

public void setContentDescription (descrição da string)

Define uma contentDescription para o mapa.

É usado para fornecer uma descrição falada do mapa no modo de acessibilidade. O valor padrão é "Google Maps"

Parâmetros

descrição	Uma string a ser usada como descrição.

booleano público setIndoorEnabled (booleano ativado)

Define se os mapas internos devem ser ativados. Atualmente, os mapas internos só podem ser exibidos em um mapa por vez e, por padrão, esse é o primeiro mapa adicionado ao seu aplicativo. Para ativar mapas internos em outro mapa, primeiro você precisa desativá-los no mapa original. Se você tentar ativar os mapas internos em outro mapa, nada acontecerá. false Quando Indoor não está ativado para um mapa, todos os métodos relacionados a ambientes internos retornam null ou false.

Parâmetros

ativado	true para tentar ativar mapas internos; false para desativar mapas internos.

Retorna

• se foi possível ativar mapas internos.

void void setWindowAdapter (GoogleMap.WindowAdapter)

Define um renderizador personalizado para o conteúdo das janelas de informações.

Como os listeners de eventos do mapa, esse estado não é serializado com o mapa. Se o mapa for recriado (por exemplo, devido a uma mudança de configuração), chame esse método novamente para preservar a personalização.

Parâmetros

adaptador	O adaptador a ser usado para o conteúdo da janela de informações ou null para usar a renderização de conteúdo padrão em janelas de informações.

void void setLatLngBoundsForCameraTarget (LatLngBounds limites)

Especifica um LatLngBounds para restringir o alvo da câmera. Assim, quando os usuários rolam e movimentam o mapa, o alvo da câmera não se move fora desses limites.

Defina como nulo para limpar completamente a caixa delimitadora. Os novos limites substituem qualquer caixa delimitadora especificada anteriormente.

Quando LatLngBounds é alterado, o SDK ajusta todas as atualizações de câmera futuras para respeitar esses limites, se possível. Há considerações técnicas que podem impedir que o SDK mantenha o alvo da câmera estritamente dentro dos limites. Por exemplo, erros de arredondamento de precisão de ponto flutuante ou um nível de zoom muito baixo.

Parâmetros

limites	Os limites para restringir o alvo da câmera.

void public setLocationSource (LocationSource fonte)

Substitui a origem da localização da camada my-location.

Parâmetros

source	Uma origem de local a ser usada na camada my-location. Defina como null para usar a fonte de localização padrão.

booleano público setMapStyle (estilo MapStyleOptions)

Define o estilo do mapa básico.

Com as opções de estilo, você pode aplicar estilos personalizados a elementos e elementos no mapa. Consulte MapStyleOptions para ver detalhes de definição de estilo.

Defina como "null" para limpar o estilo personalizado anterior.

Parâmetros

style

Retorna

• true se o estilo foi analisado, false se foram detectados problemas com MapStyleOptions, incluindo, por exemplo, JSON de estilo não analisável, tipo de recurso não reconhecido, tipo de elemento não reconhecido ou chaves de estilizador inválidas. Se o valor de retorno for false, o estilo atual não será alterado.

public void setCodelab (int type)

Define o tipo de blocos de mapa que serão exibidos. Os valores permitidos são:

• MAP_TYPE_NORMAL: mapa básico.
• MAP_TYPE_SATELLITE: imagens de satélite.
• MAP_TYPE_HYBRID: imagens de satélite com vias e rótulos.
• MAP_TYPE_TERRAIN: dados topográficos.
• MAP_TYPE_NONE: não há blocos de mapa básico.

Parâmetros

tipo	O tipo de mapa a ser exibido.

public void setMaxZoomPreference (float maxZoomPreference)

Define um limite superior preferido para o zoom da câmera.

Quando o zoom máximo muda, o SDK ajusta todas as atualizações de câmera posteriores para respeitar esse máximo, se possível. Há considerações técnicas que podem impedir que o SDK permita que os usuários aumentem o zoom do mapa. Por exemplo, um mapa de satélite ou de terreno pode ter um zoom máximo menor que os blocos do Mapa básico.

O SDK resolve qualquer conflito nos valores mínimo e máximo. Se você definir o zoom mínimo para um nível de zoom maior que o máximo atual, o SDK usará o novo valor mínimo para o mínimo e o máximo. Se você definir o zoom máximo em um nível inferior ao mínimo, o SDK usará o novo valor máximo para o mínimo e o máximo. Por exemplo, suponha que o zoom mínimo atual seja 8 e o máximo seja 14. Depois, defina o zoom máximo como 6. O SDK usa um zoom mínimo de 6 e máximo de 6.

Parâmetros

Preferência de zoom máx.	O limite superior preferido.

public void setMinZoomPreference (float minZoomPreference)

Define um limite inferior preferido para o zoom da câmera.

Quando o zoom mínimo muda, o SDK ajusta todas as atualizações de câmera posteriores para respeitar esse mínimo, se possível. Há considerações técnicas que podem impedir que o SDK permita que os usuários apliquem zoom muito baixo.

O SDK resolve qualquer conflito nos valores mínimo e máximo. Se você definir o zoom mínimo para um nível de zoom maior que o máximo atual, o SDK usará o novo valor mínimo para o mínimo e o máximo. Se você definir o zoom máximo em um nível inferior ao mínimo, o SDK usará o novo valor máximo para o mínimo e o máximo. Por exemplo, suponha que o zoom mínimo atual seja 8 e o máximo seja 14. Depois, defina o zoom mínimo como 16. O SDK usa um zoom mínimo de 16 e 16.

Parâmetros

minZoomPreference	O limite inferior preferido.

void public setMyLocationEnabled (booleano ativado)

Ativa ou desativa a camada "my-location".

Enquanto ativada e a localização estiver disponível, a camada "my-location" desenha continuamente uma indicação da localização e do rolamento atuais do usuário e exibe controles da IU que permitem que um usuário interaja com a localização dele (por exemplo, para ativar ou desativar o rastreamento da câmera da localização e do rolamento dele).

Para usar o recurso my-location-layer, você precisa solicitar permissão para ACCESS_COARSE_LOCATION ou ACCESS_FINE_LOCATION, a menos que tenha definido uma origem de localização personalizada.

Se você definiu uma origem de local personalizada via setLocationSource(LocationSource), o SDK do Google Maps para Android não verificará se as permissões acima foram concedidas. No entanto, você ainda precisa garantir que o usuário conceda todas as permissões necessárias para a origem de localização personalizada.

Parâmetros

ativado	true para ativar e false para desativar.

Gera

SecurityException	se a permissão de localização não for concedida.

public void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener)

Esse método foi descontinuado.
Substituído por setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) e setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

Define um callback que é invocado quando a câmera muda.

Parâmetros

listener	O callback que é invocado quando a câmera muda. Para cancelar a chamada, use null.

void public setOnCameraIdleListener (GoogleMap.OnCameraIdleListener)

Define um callback que é invocado quando o movimento da câmera termina.

Parâmetros

listener	O retorno de chamada que é invocado. Para cancelar a chamada, use null.

public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener)

Define um callback que é invocado quando o movimento da câmera é interrompido ou interrompido por um novo tipo de animação.

Parâmetros

listener	O retorno de chamada que é invocado. Para cancelar a chamada, use null. Não atualize nem anime a câmera dentro do onCameraMoveCanceled().

void void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener)

Define um callback que é invocado repetidamente enquanto a câmera está em movimento. O callback pode ser invocado com a mesma frequência de cada frame e não deve executar operações de alto custo.

Parâmetros

listener	O retorno de chamada que é invocado. Para cancelar a chamada, use null.

void void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener)

Define um callback que é invocado quando a câmera começa a se mover ou o motivo do movimento mudou.

Parâmetros

listener	O retorno de chamada que é invocado. Para cancelar a chamada, use null. Não atualize nem anime a câmera dentro do onCameraMoveStarted().

void void setOnCircleClickListener (GoogleMap.OnCircleClickListener)

Define um retorno de chamada que é invocado quando um círculo é clicado.

Parâmetros

listener	Chamada de retorno que é invocada quando um círculo é clicado. Para cancelar a chamada, use null.

void void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener)

Define um callback que é invocado quando alguém clica em uma sobreposição de solo.

Parâmetros

listener	O callback que é invocado quando alguém clica em uma sobreposição de solo. Para cancelar a chamada de retorno, use null.

void void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener)

Define ou limpa o listener de eventos internos. Só é possível definir um listener. Definir um novo listener removerá o listener anterior.

Parâmetros

listener	O listener de eventos internos, se não for nulo, caso contrário, limpa o listener.

void void setOnWindowClickListener (GoogleMap.OnTextViewClickListener)

Define um retorno de chamada que é invocado quando uma janela de informações do marcador é clicada.

Parâmetros

listener	O retorno de chamada invocado quando uma janela de informações do marcador é clicada. Para cancelar a chamada de retorno, use null.

void void setOnWindowCloseListener (GoogleMap.OnWindowCloseListener)

Define um retorno de chamada que é invocado quando uma janela de informações do marcador é fechada.

Parâmetros

listener	Chamada de retorno que é invocada quando a janela de informações de um marcador é fechada. Para cancelar a chamada de retorno, use null.

void void setOnWindowLongClickListener (GoogleMap.OnKeywordLongClickListener)

Define um retorno de chamada que é invocado quando uma janela de informações do marcador é pressionada e é pressionada.

Parâmetros

listener	O retorno de chamada invocado quando uma janela de informações do marcador é pressionada e é pressionada. Para desativar o callback, use null.

void void setOnMapClickListener (GoogleMap.OnMapClickListener listener)

Define um callback que é invocado quando o mapa é tocado.

Parâmetros

listener	O callback que é invocado quando o mapa é tocado. Para cancelar a chamada, use null.

void void setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback)

Define um retorno de chamada que é invocado quando este mapa termina de ser renderizado. O callback será invocado apenas uma vez.

Se esse método for chamado quando o mapa estiver completamente renderizado, o callback será invocado imediatamente. Este evento não será disparado se o mapa nunca for carregado devido a problemas de conectividade ou se ele estiver mudando continuamente e nunca concluir o carregamento devido ao usuário interagir constantemente com o mapa.

Parâmetros

callback	O callback invocado quando a renderização do mapa é concluída. Para cancelar a chamada de retorno, use null.

void void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener listener)

Define um retorno de chamada que é invocado quando o mapa é pressionado por um período longo.

Parâmetros

listener	Chamada de retorno que é invocada quando o mapa é pressionado por um período longo. Para cancelar a chamada de retorno, use null.

void void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener)

Define um retorno de chamada que é invocado quando um marcador é clicado.

Parâmetros

listener	O retorno de chamada invocado quando um marcador é clicado. Para cancelar a chamada, use null.

void void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener)

Define um retorno de chamada que é invocado quando um marcador é arrastado.

Parâmetros

listener	O callback que é invocado em eventos de arrastar o marcador. Para cancelar a chamada, use null.

void void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener listener)

Define um retorno de chamada que é invocado quando o botão "Meu local" é clicado.

Se listener retornar true, o evento será consumido, e o comportamento padrão não ocorrerá. Se ela retornar false, vai ocorrer o comportamento padrão, ou seja, quando a câmera se mover para que fique centralizada na localização do usuário.

Parâmetros

listener	Chamada de retorno que é invocada quando o botão "My Location" é clicado.

void void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener)

Esse método foi descontinuado.
, use com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi fornece melhor localização de localização e uso de energia e é usado pelo ponto azul "My Location". Consulte MyLocationDemoActivity na pasta de aplicativos de amostra para ver o código de exemplo ou o Guia do desenvolvedor de localização.

Define um callback que é invocado quando o ponto "Meu local" muda o local.

Parâmetros

listener	O callback que é invocado quando o ponto "Meu local" muda.

void void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener listener)

Define um callback que é invocado quando o ponto "Meu local" (que indica o local do usuário) é clicado.

Parâmetros

listener	Chamada de retorno que é invocada quando o ponto "My Location" é clicado.

void void setOnPoiClickListener (GoogleMap.OnPoiClickListener)

Define um listener que será acionado quando um PDI for clicado ou tocado.

Transmita null para limpar o listener.

Parâmetros

listener

void void setOnPolygonClickListener (GoogleMap.OnPolygonClickListener listener)

Define um retorno de chamada que é invocado quando um polígono é clicado.

Parâmetros

listener	O callback que é invocado quando alguém clica em um polígono. Para cancelar a chamada, use null.

void public setOnPolygonClickListener (GoogleMap.OnPolygonClickListener listener)

Define um retorno de chamada que é invocado quando alguém clica em uma polilinha.

Parâmetros

listener	O callback que é invocado quando alguém clica em uma polilinha. Para cancelar a chamada, use null.

public void setPadding (int esquerdo, int top, int right, int bottom)

Define o padding no mapa.

Esse método permite definir uma região visível no mapa para sinalizar ao mapa que partes do mapa nas bordas podem ser obscurecidas, definindo o padding em cada uma das quatro bordas. As funções do mapa serão adaptadas ao padding. Por exemplo, os controles de zoom, a bússola, os avisos de direitos autorais e o logotipo do Google serão movidos para caber na região definida, os movimentos da câmera serão relativos ao centro da região visível etc.

Parâmetros

esquerda	o número de pixels de preenchimento a serem adicionados à esquerda do mapa.
superior	o número de pixels de preenchimento a serem adicionados na parte superior do mapa.
direita	o número de pixels de preenchimento a serem adicionados à direita do mapa.
inferior	o número de pixels de preenchimento a serem adicionados na parte inferior do mapa.

public void setTrafficEnabled (booleano ativado)

Ativa ou desativa a camada de trânsito.

Parâmetros

ativado

void void snapshot (GoogleMap.SnapshotReadyCallback)

Tira um snapshot do mapa.

Use snapshots no seu aplicativo quando for difícil ou impossível usar um mapa interativo. Por exemplo, as imagens produzidas com o método snapshot() podem ser usadas para exibir uma miniatura do mapa no seu app ou um snapshot na central de notificações.

Observação:as imagens do mapa não podem ser transmitidas para seus servidores ou usadas fora do aplicativo. Se você precisar enviar um mapa para outro aplicativo ou usuário, envie dados que permitam reconstruir o mapa para o novo usuário em vez de um snapshot.

Parâmetros

callback	Método de callback invocado quando o snapshot é capturado.

void public snapshot (GoogleMap.SnapshotReadyCallback, bitmap de Bitmap)

Tira um snapshot do mapa.

Esse método é equivalente a snapshot(SnapshotReadyCallback), mas permite fornecer um Bitmap pré-alocado. Se o bitmap não corresponder às dimensões atuais do mapa, será alocado outro bitmap que se ajusta às dimensões do mapa.

Embora na maioria dos casos o objeto transmitido pelo método de callback seja o mesmo fornecido no parâmetro desse método, em alguns casos o objeto retornado pode ser diferente (por exemplo, se as dimensões da visualização mudarem quando o snapshot for realmente capturado). Portanto, confie apenas no conteúdo do bitmap transmitido pelo método de callback.

Parâmetros

callback	Método de callback invocado quando o snapshot é capturado.
bitmap	Um bitmap pré-alocado. Se null, se comporta como snapshot(SnapshotReadyCallback).

void null stopAnimation ()

Para a animação da câmera, se houver uma em andamento. Quando o método é chamado, a câmera para de se mover imediatamente e permanece nessa posição.