GoogleMap

classe final pública GoogleMap estende o objeto

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

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

Você pode ajustar o ponto de vista de um mapa alterando a posição da câmera (em vez de mover o 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 direção. Para ver mais informações, consulte Câmera e visualização.

Guia do desenvolvedor

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

Resumo de classes aninhadas

Interface GoogleMap.CancelableCallback Uma interface de callback para informar quando uma tarefa foi concluída ou cancelada. 
Interface GoogleMap.InfoWindowAdapter Oferece visualizações para a renderização personalizada de janelas de informações. 
Interface GoogleMap.OnCameraChangeListener Essa interface foi descontinuada. Substituído por GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener e GoogleMap.OnCameraIdleListener. A ordem em que o método onCameraChange descontinuado será chamado em relação aos métodos nos novos listeners de mudança de câmera é indefinida.  
Interface GoogleMap.OnCameraIdleListener Interface de callback para quando o movimento da câmera termina. 
Interface GoogleMap.OnCameraMoveCanceledListener Interface de callback para quando o movimento da câmera foi interrompido ou quando ela começa a se mover por um novo motivo. 
Interface GoogleMap.OnCameraMoveListener Interface de callback para quando a câmera muda de posição. 
Interface GoogleMap.OnCameraMoveStartedListener Interface de callback para quando o movimento da câmera começa. 
Interface GoogleMap.OnCircleClickListener Interface de callback para quando um círculo é 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 muda. 
Interface GoogleMap.OnInfoWindowClickListener Interface de callback para eventos de clique/toque na janela de informações de um marcador. 
Interface GoogleMap.OnInfoWindowCloseListener Interface de callback para eventos de fechamento na janela de informações de um marcador. 
Interface GoogleMap.OnInfoWindowLongClickListener Interface de callback para quando o usuário toca e mantém pressionada a janela de informações de um marcador. 
Interface GoogleMap.OnMapClickListener Interface de callback para quando o usuário toca no mapa. 
Interface GoogleMap.OnMapLoadedCallback Interface de callback para quando o mapa terminar a renderização. 
Interface GoogleMap.OnMapLongClickListener Interface de callback para quando o usuário toca no mapa e o mantém pressionado. 
Interface GoogleMap.OnMarkerClickListener Define assinaturas para métodos que são chamados quando um marcador é clicado ou tocado. 
Interface GoogleMap.OnMarkerDragListener Interface de callback para eventos de arrastar em marcadores. 
Interface GoogleMap.OnMyLocationButtonClickListener Interface de retorno de chamada para quando o usuário clicar no botão "Meu local".
Interface GoogleMap.OnMyLocationChangeListener Essa interface foi descontinuada. Use com.google.android.gms.location.FusedLocationProviderApi FusedLocationProviderApi fornece localização aprimorada de localização e uso de energia e é usado pelo ponto azul "Meu local". Consulte o tutorial Selecionar lugar atual, que usa a FusedLocationProviderApi, ou o guia para desenvolvedores de locais.  
Interface GoogleMap.OnMyLocationClickListener Interface de retorno de chamada para quando o ponto "My Location" (que significa a localização do usuário) é clicado. 
Interface GoogleMap.OnPoiClickListener Um listener para toques em PDIs. 
Interface GoogleMap.OnPolygonClickListener Interface de callback para quando um polígono é clicado. 
Interface GoogleMap.OnPolylineClickListener Interface de retorno de chamada para quando uma polilinha é clicada. 
Interface GoogleMap.SnapshotReadyCallback Interface de callback para notificar quando o snapshot foi criado. 

Resumo da constante

int MAP_TYPE_HYBRID Mapas de satélite com uma camada transparente das principais ruas.
int MAP_TYPE_NONE Nenhum bloco de mapa básico.
int MAP_TYPE_NORMAL Mapas básicos.
int MAP_TYPE_SATELLITE Mapas de satélite sem marcadores.
int MAP_TYPE_TERRAIN Mapas de terreno.

Resumo do método público

Circle
addCircle(opções de CircleOptions)
Adicione um círculo a este mapa.
GroundOverlay
addGroundOverlay(opções de GroundOverlayOptions)
Adiciona uma imagem ao mapa.
Marker
addMarker(opções de MarkerOptions)
Adiciona um marcador ao mapa.
Polygon
addPolygon(opções de PolygonOptions)
Adiciona um polígono ao mapa.
Polyline
addPolyline(opções de PolylineOptions)
Adiciona uma polilinha ao mapa.
TileOverlay
addTileOverlay(opções de TileOverlayOptions)
Adiciona uma sobreposição de blocos ao mapa.
void
animateCamera(atualização de CameraUpdate)
Anima o movimento da câmera da posição atual para a posição definida na atualização.
void
animateCamera(atualização de 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 callback opcional na conclusão.
void
animateCamera(atualização de CameraUpdate, intDurationMs, callback GoogleMap.CancelableCallback)
Move o mapa de acordo com a atualização com uma animação por uma duração especificada e chama um retorno de chamada opcional na conclusão.
void
clear()
Remove todos os marcadores, polilinhas, polígonos, sobreposições, etc. do mapa.
CameraPosition
getCameraPosition()
Acessa a posição atual da câmera.
IndoorBuilding
getFocusedBuilding()
Recebe o edifício em foco no momento.
int
getMapType()
Mostra o tipo de mapa exibido no momento.
float
getMaxZoomLevel()
Retorna o nível de zoom máximo para a 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 instead. FusedLocationProviderApi fornece localização aprimorada de localização e uso de energia e é usado pelo ponto azul "Meu local". Consulte MyLocationDemoActivity na pasta de aplicativos de exemplo para ver um exemplo de código ou o Guia para desenvolvedores sobre locais.
Projection
getProjection()
Retorna um objeto Projection que pode ser usado para converter entre coordenadas de tela e coordenadas de latitude/longitude.
UiSettings
getUiSettings()
Extrai 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()
Descobre se os mapas internos estão ativados.
boolean
isMyLocationEnabled()
Recebe o status da camada "my-location".
boolean
isTrafficEnabled()
Verifica se o mapa está exibindo dados de trânsito.
void
moveCamera(atualização de CameraUpdate)
reposiciona a câmera de acordo com as instruções definidas na atualização.
void
resetMinMaxZoomPreference()
Remove todos os limites de zoom superior e inferior especificados 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 precisam ser ativados.
void
setInfoWindowAdapter(adaptador GoogleMap.InfoWindowAdapter)
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 para fora desses limites.
void
setLocationSource(origem LocationSource)
Substitui a origem da localização da camada my-location.
boolean
setMapStyle(estilo MapStyleOptions)
Define o estilo do mapa básico.
void
setMapType(tipo int)
Define o tipo de blocos de mapa que devem ser exibidos.
void
setMaxZoomPreference(flutuante maxZoomPreference)
Define um limite superior preferido para o zoom da câmera.
void
setMinZoomPreference(flutuante minZoomPreference)
Define um limite inferior preferido para o zoom da câmera.
void
setMyLocationEnabled(booleano ativado)
Ativa ou desativa a camada "my-location".
void
void
setOnCameraIdleListener(listener GoogleMap.OnCameraIdleListener)
Define um callback invocado quando o movimento da câmera termina.
void
setOnCameraMoveCanceledListener(listener GoogleMap.OnCameraMoveCanceledListener)
Define um callback 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 invocado repetidamente enquanto a câmera está em movimento.
void
setOnCameraMoveStartedListener(listener GoogleMap.OnCameraMoveStartedListener)
Define um callback invocado quando a câmera começa a se mover ou quando o motivo do movimento é modificado.
void
setOnCircleClickListener(listener GoogleMap.OnCircleClickListener)
Define um callback invocado quando um círculo é clicado.
void
setOnGroundOverlayClickListener(listener GoogleMap.OnGroundOverlayClickListener)
Define um retorno de chamada que é invocado quando uma sobreposição de solo é clicada.
void
setOnIndoorStateChangeListener(listener GoogleMap.OnIndoorStateChangeListener)
Define ou limpa o listener de eventos internos.
void
setOnInfoWindowClickListener(listener GoogleMap.OnInfoWindowClickListener)
Define um callback invocado quando uma janela de informações do marcador é clicada.
void
setOnInfoWindowCloseListener(listener GoogleMap.OnInfoWindowCloseListener)
Define um callback invocado quando a janela de informações de um marcador é fechada.
void
setOnInfoWindowLongClickListener(listener GoogleMap.OnInfoWindowLongClickListener)
Define um callback invocado quando a janela de informações de um marcador é pressionada por um longo período.
void
setOnMapClickListener(listener GoogleMap.OnMapClickListener)
Define um callback invocado quando o mapa é tocado.
void
setOnMapLoadedCallback(callback de GoogleMap.OnMapLoadedCallback)
Define um callback invocado quando esse mapa termina a renderização.
void
setOnMapLongClickListener(listener GoogleMap.OnMapLongClickListener)
Define um callback invocado quando o mapa é pressionado.
void
setOnMarkerClickListener(listener GoogleMap.OnMarkerClickListener)
Define um callback invocado quando um marcador é clicado.
void
setOnMarkerDragListener(listener GoogleMap.OnMarkerDragListener)
Define um callback invocado quando um marcador é arrastado.
void
setOnMyLocationButtonClickListener(listener GoogleMap.OnMyLocationButtonClickListener)
Define um callback invocado quando o botão "My Location" é clicado.
void
setOnMyLocationChangeListener(listener GoogleMap.OnMyLocationChangeListener)
Esse método foi descontinuado. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi fornece localização aprimorada de localização e uso de energia e é usado pelo ponto azul "Meu local". Consulte MyLocationDemoActivity na pasta de aplicativos de exemplo para ver um exemplo de código ou o Guia para desenvolvedores sobre locais.
void
setOnMyLocationClickListener(listener GoogleMap.OnMyLocationClickListener)
Define um callback invocado quando o ponto "My Location" (que significa a localização do usuário) é clicado.
void
setOnPoiClickListener(listener GoogleMap.OnPoiClickListener)
Define um listener que será acionado quando o usuário clicar ou tocar em um PDI.
void
setOnPolygonClickListener(listener GoogleMap.OnPolygonClickListener)
Define um callback invocado quando um polígono é clicado.
void
setOnPolylineClickListener(listener GoogleMap.OnPolylineClickListener)
Define um retorno de chamada que é invocado quando uma polilinha é clicada.
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 de GoogleMap.SnapshotReadyCallback)
Faz um instantâneo do mapa.
void
snapshot(callback de GoogleMap.SnapshotReadyCallback, bitmap Bitmap)
Faz um instantâneo do mapa.
void
stopAnimation()
Interrompe a animação da câmera, se houver uma em andamento.

Resumo do método herdado

Constantes

público estático final int MAP_TYPE_HYBRID

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

Valor da constante: 4

público estático final int MAP_TYPE_NONE

Nenhum bloco de mapa básico.

Valor da constante: 0

público estático final int MAP_TYPE_NORMAL

Mapas básicos.

Valor da constante: 1

público estático final int MAP_TYPE_SATELLITE

Mapas de satélite sem marcadores.

Valor da constante: 2

público estático final int MAP_TYPE_TERRAIN

Mapas de terreno.

Valor da constante: 3

Métodos públicos

public Circle addCircle (CircleOptions opções)

Adicione um círculo a este mapa.

Parâmetros
opções Objeto de opções de círculo que define como renderizar o círculo.
Retorna
  • O objeto Circle adicionado ao mapa.

public GroundOverlay addGroundOverlay (GroundOverlayOptions options)

Adiciona uma imagem ao mapa.

Parâmetros
opções Um objeto de opções da 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
Gera
IllegalArgumentException se a imagem ou a posição não estiver especificada nas opções.

público Marker addMarker (MarkerOptions (opções)

Adiciona um marcador ao mapa.

O ícone do marcador é renderizado no mapa na posição Marker.position do local. Ao clicar no marcador, a câmera centraliza a imagem nele. Se Marker.title estiver 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 longo e arraste o marcador para movê-lo.

Parâmetros
opções Um objeto de opções do marcador que define como renderizar o marcador.
Retorna
  • O Marker que foi adicionado ao mapa.

public Polygon addPolygon (PolygonOptions opções)

Adiciona um polígono ao mapa.

Parâmetros
opções Um objeto de opções do polígono que define como renderizar o polígono.
Retorna
  • O objeto Polygon que é adicionado ao mapa.

público polilinha addPolyline (PolylineOptions opções)

Adiciona uma polilinha ao mapa.

Parâmetros
opções Um objeto de opções da polilinha que define como renderizar a polilinha.
Retorna
  • O objeto Polyline que foi adicionado ao mapa.

public TileOverlay addTileOverlay (opções de TileOverlayOptions)

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

Ao contrário de outras sobreposições, quando o mapa é recriado, as sobreposições de blocos não são restauradas automaticamente e precisam ser adicionadas de novo manualmente.

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
Gera
IllegalArgumentException se TileProvider não estiver especificado nas opções.

public void animateCamera (atualização de CameraUpdate)

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 CameraUpdateFactory para conferir o conjunto de atualizações.

Parâmetros
update A mudança que precisa ser aplicada à câmera.

public void animateCamera (atualização de 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 callback opcional na conclusão. Consulte CameraUpdateFactory para conferir 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 mudança que precisa ser aplicada à câmera.
callback O callback a ser invocado da linha de execução de interface 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 de dentro do onCancel().

public void animateCamera (atualização de CameraUpdate, intDurationMs, callback GoogleMap.CancelableCallback)

Move o mapa de acordo com a atualização com uma animação por uma duração especificada e chama um retorno de chamada opcional na conclusão. Consulte CameraUpdateFactory para conferir o conjunto de atualizações.

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

Parâmetros
update
durationMs É a duração da animação em milissegundos. Precisa ser estritamente positivo. Caso contrário, uma IllegalArgumentException será gerada.
callback Um callback opcional que será notificado na linha de execução de interface do Android quando a animação for interrompida. Se a animação parar devido à conclusão natural, o callback será notificado com onFinish(). Se a animação for interrompida devido à interrupção por um movimento posterior da câmera ou um gesto do usuário, onCancel() será chamado. O callback não pode tentar mover nem animar a câmera no método de cancelamento. Se um callback não for necessário, deixe como null.

public void clear ()

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

public CameraPosition getCameraPosition ()

Acessa 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 ver mais informações sobre como mudar a posição da câmera, consulte Câmera e visualização.

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

public IndoorBuilding getFocusedBuilding ()

Recebe o edifício em foco no momento.

Retorna
  • A construção em foco no momento ou null, se nenhum edifício estiver em foco.

public int getMapType ()

Mostra o tipo de mapa exibido no momento. Consulte MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN para conferir os possíveis valores.

Retorna
  • O tipo de mapa.

public float getMaxZoomLevel ()

Retorna o nível de zoom máximo para a posição atual da câmera. Esse valor considera o tipo de mapa usado no momento. Por exemplo, satélite ou 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 mudar 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.

public float getMinZoomLevel ()

Retorna o nível de zoom mínimo. É 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 mudar o nível de zoom da câmera, consulte Câmera e visualização.

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

público Local getMyLocation ()

Esse método foi descontinuado.
Use com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi fornece localização aprimorada de localização e uso de energia e é usado pelo ponto azul "Meu local". Consulte MyLocationDemoActivity na pasta de aplicativos de exemplo para ver um exemplo de código ou o Guia para desenvolvedores sobre locais.

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

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

public Projeção getProjection ()

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

O Projection retornado é um snapshot da projeção atual e não será atualizado automaticamente quando a câmera se mover. Como essa operação é cara, é necessário fazer a projeção apenas uma vez por tela. O Google Maps usa a projeção Mercator para criar mapas de dados geográficos e converter pontos em coordenadas geográficas.

Retorna

public UiSettings getUiSettings ()

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

Retorna

public booleano isBuildingsEnabled ()

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

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

public boolean isIndoorEnabled ()

Descobre se os mapas internos estão ativados.

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

public booleano isMyLocationEnabled ()

Recebe o status da camada "my-location".

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

public booleano isTrafficEnabled ()

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

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

public void moveCamera (atualização do CameraUpdate)

reposiciona a câmera de acordo com as instruções definidas na atualização. A mudança é instantânea, e um getCameraPosition() subsequente reflete a nova posição. Consulte CameraUpdateFactory para conferir um conjunto de atualizações.

Parâmetros
update A mudança que precisa ser aplicada à câmera.

public void resetMinMaxZoomPreference ()

Remove todos os limites de zoom superior e inferior especificados anteriormente.

public void setBuildingsEnabled (boolean enabled)

Ativa ou desativa a camada de construções em 3D.

Parâmetros
ativado Use true para ativar a camada de construções em 3D e 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 Map"

Parâmetros
Descrição uma string para usar como descrição.

public boolean setIndoorEnabled (boolean enabled)

Define se os mapas internos precisam ser ativados. No momento, os mapas internos só podem ser exibidos em um mapa por vez e, por padrão, este é o primeiro mapa adicionado ao seu app. Para ativar os mapas internos em outro mapa, primeiro é necessário desativá-los no original. Se você tentar ativar os mapas internos quando eles estiverem habilitados em outro mapa, nada acontecerá e a ação retornará false. Quando o modo interno não está ativado para um mapa, todos os métodos relacionados ao modo interno retornam null ou false.

Parâmetros
ativado true para tentar ativar os mapas internos e false para desativar mapas internos.
Retorna
  • se era possível ativar os mapas internos.

public void setInfoWindowAdapter (adaptador do GoogleMap.InfoWindowAdapter)

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.

public 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 para fora desses limites.

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

Quando a LatLngBounds é alterada, o SDK ajusta todas as atualizações posteriores da câmera 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 dentro dele.

public void setLocationSource (origem de LocationSource)

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

Parâmetros
source Uma fonte de localização para usar na camada "my-location". Defina como null para usar a origem do local padrão.

public boolean 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. Acesse MapStyleOptions para conferir detalhes sobre a definição de estilo

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

Parâmetros
estilo
Retorna
  • true se o estilo tiver sido analisado; false se forem detectados problemas com o 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 styler inválidas. Se o valor de retorno for false, o estilo atual não será alterado.

public void setMapType (int type)

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

Parâmetros
digitar 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 posteriores da câmera 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 demais no 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 mínimo como um nível de zoom maior do que o máximo atual, o SDK vai usar o novo valor mínimo para mínimo e máximo. Se você definir o zoom máximo como um nível menor que o mínimo, o SDK vai usar o novo valor máximo para mínimo e máximo. Por exemplo: suponha que o zoom mínimo atual seja 8 e o máximo seja 14. Em seguida, você define o zoom máximo para 6. O SDK usa um zoom mínimo de 6 e máximo de 6.

Parâmetros
maxZoomPreference 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 posteriores da câmera para respeitar esse mínimo, se possível. Há considerações técnicas que podem impedir que o SDK permita que os usuários aumentem o zoom muito baixo.

O SDK resolve qualquer conflito nos valores mínimo e máximo. Se você definir o mínimo como um nível de zoom maior do que o máximo atual, o SDK vai usar o novo valor mínimo para mínimo e máximo. Se você definir o zoom máximo como um nível menor que o mínimo, o SDK vai usar o novo valor máximo para mínimo e máximo. Por exemplo: suponha que o zoom mínimo atual seja 8 e o máximo seja 14. Em seguida, você define o zoom mínimo para 16. O SDK usa um zoom mínimo de 16 e máximo de 16.

Parâmetros
minZoomPreference O limite inferior preferido.

public void setMyLocationEnabled (boolean enabled)

Ativa ou desativa a camada "my-location".

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

Para usar o recurso my-location-layer, é necessário solicitar permissão para ACCESS_COARSE_LOCATION ou ACCESS_FINE_LOCATION, a menos que você tenha definido uma origem de local personalizada.

Se você tiver definido uma origem de local personalizada por setLocationSource(LocationSource), o SDK do Google Maps para Android não verificará se as permissões acima foram concedidas. No entanto, você ainda precisa conferir se o usuário concedeu todas as permissões necessárias para sua origem de local personalizada.

Parâmetros
ativado true para ativar e false para desativar.
Gera
SecurityException quando a permissão de localização não é concedida.

public 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).

Define um callback invocado quando a câmera muda.

Parâmetros
listener O callback invocado quando a câmera muda. Para cancelar a definição do callback, use null.

public void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener listener)

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

Parâmetros
listener O callback invocado. Para cancelar a definição do callback, use null.

public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener)

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

Parâmetros
listener O callback invocado. Para cancelar a definição do callback, use null. Não atualize nem anime a câmera de dentro do onCameraMoveCanceled().

public void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener listener)

Define um callback invocado repetidamente enquanto a câmera está em movimento. O callback pode ser invocado uma vez por frame e não pode executar operações dispendiosas.

Parâmetros
listener O callback invocado. Para cancelar a definição do callback, use null.

public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener)

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

Parâmetros
listener O callback invocado. Para cancelar a definição do callback, use null. Não atualize nem anime a câmera de dentro do onCameraMoveStarted().

public void setOnCircleClickListener (GoogleMap.OnCircleClickListener listener)

Define um callback invocado quando um círculo é clicado.

Parâmetros
listener O callback invocado quando um círculo é clicado. Para cancelar a definição do callback, use null.

public void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener listener)

Define um retorno de chamada que é invocado quando uma sobreposição de solo é clicada.

Parâmetros
listener O retorno de chamada invocado quando uma sobreposição de solo é clicada. Para cancelar a definição do callback, use null.

public void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener)

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

Parâmetros
listener o listener de eventos internos se não for nulo; caso contrário, limpa o listener

public void setOnInfoWindowClickListener (listener GoogleMap.OnInfoWindowClickListener)

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

Parâmetros
listener O callback invocado quando uma janela de informações do marcador é clicada. Para cancelar a definição do callback, use null.

public void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener)

Define um callback invocado quando a janela de informações de um marcador é fechada.

Parâmetros
listener O callback invocado quando a janela de informações de um marcador é fechada. Para cancelar a definição do callback, use null.

public void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener listener)

Define um callback invocado quando a janela de informações de um marcador é pressionada por um longo período.

Parâmetros
listener O callback invocado quando a janela de informações de um marcador é pressionada. Para cancelar a definição do callback, use null.

public void setOnMapClickListener (GoogleMap.OnMapClickListener listener)

Define um callback invocado quando o mapa é tocado.

Parâmetros
listener O callback invocado quando o mapa é tocado. Para cancelar a definição do callback, use null.

public void setOnMapLoadedCallback (callback de GoogleMap.OnMapLoadedCallback)

Define um callback invocado quando esse mapa termina a renderização. O callback será invocado apenas uma vez.

Se esse método for chamado quando o mapa estiver totalmente renderizado, o callback será invocado imediatamente. Esse evento não será disparado se o mapa não for carregado devido a problemas de conectividade ou se ele estiver mudando continuamente e nunca concluir o carregamento devido à interação constante do usuário.

Parâmetros
callback O callback invocado quando o mapa termina a renderização. Para cancelar a definição do callback, use null.

public void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener)

Define um callback invocado quando o mapa é pressionado.

Parâmetros
listener O callback invocado quando o mapa é pressionado. Para cancelar a definição do callback, use null.

public void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener listener)

Define um callback invocado quando um marcador é clicado.

Parâmetros
listener O callback invocado quando um marcador é clicado. Para cancelar a definição do callback, use null.

public void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener listener)

Define um callback invocado quando um marcador é arrastado.

Parâmetros
listener O callback invocado nos eventos de arrastar o marcador. Para cancelar a definição do callback, use null.

public void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener)

Define um callback invocado quando o botão "My Location" é clicado.

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

Parâmetros
listener O retorno de chamada invocado quando o botão "Meu local" é clicado.

public void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener)

Esse método foi descontinuado.
Use com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi fornece localização aprimorada de localização e uso de energia e é usado pelo ponto azul "Meu local". Consulte MyLocationDemoActivity na pasta de aplicativos de exemplo para ver um exemplo de código ou o Guia para desenvolvedores sobre locais.

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

Parâmetros
listener O retorno de chamada invocado quando o ponto "Meu local" é alterado.

public void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener listener)

Define um callback invocado quando o ponto "My Location" (que significa a localização do usuário) é clicado.

Parâmetros
listener O callback invocado quando o ponto "Meu local" é clicado.

public void setOnPoiClickListener (GoogleMap.OnPoiClickListener)

Define um listener que será acionado quando o usuário clicar ou tocar em um PDI.

Transmita null para limpar o listener.

Parâmetros
listener

public void setOnPolygonClickListener (listener GoogleMap.OnPolygonClickListener)

Define um callback invocado quando um polígono é clicado.

Parâmetros
listener O callback invocado quando um polígono é clicado. Para cancelar a definição do callback, use null.

public void setOnPolylineClickListener (listener GoogleMap.OnPolylineClickListener)

Define um retorno de chamada que é invocado quando uma polilinha é clicada.

Parâmetros
listener O callback invocado quando uma polilinha é clicada. Para cancelar a definição do callback, use null.

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

Define o padding no mapa.

Com esse método, é possível definir uma região visível no mapa para sinalizar que partes do mapa ao redor das bordas podem ser obscurecidas. Para isso, defina o padding em cada uma das quatro bordas do mapa. As funções do mapa serão adaptadas ao padding. Por exemplo, os controles de zoom, a bússola, as notificações 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 ser adicionado à esquerda do mapa.
superior o número de pixels de preenchimento a ser adicionado à parte superior do mapa.
à direita o número de pixels de preenchimento a ser adicionado à direita do mapa.
inferior o número de pixels de preenchimento a ser adicionado na parte inferior do mapa.

public void setTrafficEnabled (boolean enabled)

Ativa ou desativa a camada de trânsito.

Parâmetros
ativado

public void snapshot (callback de GoogleMap.SnapshotReadyCallback)

Faz um instantâneo do mapa.

Use snapshots no seu aplicativo quando um mapa interativo for difícil ou impossível de usar. Por exemplo, 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 nem usadas fora do app. Se precisar enviar um mapa para outro app ou usuário, envie dados que permitam que ele reconstrua o mapa para o novo usuário, em vez de um snapshot.

Parâmetros
callback Método de retorno de chamada invocado quando o instantâneo é capturado.

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

Faz um instantâneo 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 para essas dimensões.

Embora na maioria dos casos o objeto transmitido pelo método de callback seja o mesmo fornecido no parâmetro para esse método, em alguns casos o objeto retornado pode ser diferente (por exemplo, se as dimensões da visualização tiverem sido alteradas no momento em que o snapshot é realmente capturado). Portanto, você só deve confiar no conteúdo do bitmap transmitido pelo método de callback.

Parâmetros
callback Método de retorno de chamada invocado quando o instantâneo é capturado.
bitmap Um bitmap pré-alocado. Se null, vai se comportar como snapshot(SnapshotReadyCallback).

public void stopAnimation ()

Interrompe 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.