Se usó la API de Cloud Translation para traducir esta página.

GoogleMap

la clase final pública GoogleMap extiende el objeto

Esta es la clase principal del SDK de Google Maps para Android y es el punto de entrada de todos los métodos relacionados con el mapa. No puedes crear una instancia de un objeto GoogleMap directamente, sino que debes obtener uno del método getMapAsync() en un MapFragment o MapView que hayas agregado a tu aplicación.

Nota: Al igual que un objeto View, un GoogleMap solo se puede leer y modificar desde el subproceso de IU de Android. Si llamas a los métodos GoogleMap desde otro subproceso, se generará una excepción.

Puedes ajustar el punto de vista de un mapa cambiando la posición de la cámara (en lugar de mover el mapa). Puedes usar la cámara del mapa para establecer parámetros como la ubicación, el nivel de zoom, el ángulo de inclinación y el rumbo. Para obtener más información, consulta Cámara y vista.

Guía para desarrolladores

Para comenzar, lee la guía para desarrolladores del SDK de Google Maps para Android.

Resumen de clases anidadas

interfaz	GoogleMap.CancelableCallback	Una interfaz de devolución de llamada para informar cuando una tarea se completa o se cancela.
interfaz	GoogleMap.InfoWindowAdapter.	Proporciona vistas para la renderización personalizada de ventanas de información.
interfaz	GoogleMap.OnCameraChangeListener.	Esta interfaz está obsoleta. Se reemplazó por `GoogleMap.OnCameraMoveStartedListener`, `GoogleMap.OnCameraMoveListener` y `GoogleMap.OnCameraIdleListener`. El orden en que se llamará al método `onCameraChange` obsoleto en relación con los métodos en los nuevos objetos de escucha de cambio de cámara no está definido.
interfaz	GoogleMap.OnCameraIdleListener	Interfaz de devolución de llamada para cuando finaliza el movimiento de la cámara
interfaz	GoogleMap.OnCameraMoveCanceledListener	Interfaz de devolución de llamada para cuando se detiene el movimiento de la cámara o cuando la cámara comienza a moverse por otro motivo
interfaz	GoogleMap.OnCameraMoveListener	Interfaz de devolución de llamada para cuando la cámara cambia de posición
interfaz	GoogleMap.OnCameraMoveStartedListener	Interfaz de devolución de llamada para cuando comienza el movimiento de la cámara
interfaz	GoogleMap.OnCircleClickListener.	Interfaz de devolución de llamada para cuando se hace clic en un círculo
interfaz	GoogleMap.OnGroundOverlayClickListener.	Interfaz de devolución de llamada para cuando se hace clic en una superposición de suelo
interfaz	GoogleMap.OnIndoorStateChangeListener.	Un objeto de escucha para cuando cambia el estado interior.
interfaz	GoogleMap.OnInfoWindowClickListener.	Interfaz de devolución de llamada para eventos de presionar o hacer clic en la ventana de información de un marcador
interfaz	GoogleMap.OnInfoWindowCloseListener	Interfaz de devolución de llamada para eventos cercanos en la ventana de información de un marcador
interfaz	GoogleMap.OnInfoWindowLongClickListener.	Interfaz de devolución de llamada para cuando el usuario mantiene presionada la ventana de información de un marcador
interfaz	GoogleMap.OnMapClickListener.	Interfaz de devolución de llamada para cuando el usuario presiona el mapa
interfaz	GoogleMap.OnMapLoadedCallback.	Interfaz de devolución de llamada para cuando el mapa haya terminado de renderizarse
interfaz	GoogleMap.OnMapLongClickListener.	Interfaz de devolución de llamada para cuando el usuario mantiene presionado el mapa
interfaz	GoogleMap.OnMarkerClickListener	Define las firmas de los métodos a los que se llama cuando se hace clic en un marcador o se lo presiona.
interfaz	GoogleMap.OnMarkerDragListener	Interfaz de devolución de llamada para eventos de arrastre en marcadores
interfaz	GoogleMap.OnMyLocationButtonClickListener.	Interfaz de devolución de llamada para cuando se hace clic en el botón Mi ubicación
interfaz	GoogleMap.OnMyLocationChangeListener.	Esta interfaz está obsoleta. En su lugar, usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi proporciona un mejor uso de la búsqueda y el uso de energía y se usa con el punto azul "Mi ubicación</a>. Consulta el instructivo Selecciona un lugar actual, que usa la FusedLocationProviderApi o la Guía para desarrolladores de ubicación.
interfaz	GoogleMap.OnMyLocationClickListener.	Es la interfaz de devolución de llamada cuando se hace clic en el punto de Mi ubicación (que indica la ubicación del usuario).
interfaz	GoogleMap.OnPoiClickListener.	Un objeto de escucha para los lugares de interés.
interfaz	GoogleMap.OnPolygonClickListener	Interfaz de devolución de llamada para cuando se hace clic en un polígono
interfaz	GoogleMap.OnPolylineClickListener	Interfaz de devolución de llamada para cuando se hace clic en una polilínea
interfaz	GoogleMap.SnapshotReadyCallback	Interfaz de devolución de llamada para notificar cuando se toma la instantánea

Resumen de constantes

int	MAP_TYPE_HYBRID	Mapas satelitales con una capa transparente de calles importantes.
int	MAP_TYPE_NONE	No hay mosaicos de mapas básicos.
int	MAP_TYPE_NORMAL;	Mapas básicos.
int	MAP_TYPE_SATELLITE	Mapas satelitales sin etiquetas
int	MAP_TYPE_TERRAIN	Mapas de relieve.

Resumen de métodos públicos

Círculo	addCircle(opciones de CircleOptions) Agrega un círculo a este mapa.
GroundOverlay	addGroundOverlay(opciones de GroundOverlayOptions) Agrega una imagen a este mapa.
Marker	addMarker(opciones MarkerOptions) Agrega un marcador a este mapa.
Polygon	addPolygon(opciones de PolygonOptions) Agrega un polígono a este mapa.
Polyline	addPolyline(opciones de PolylineOptions) Agrega una polilínea a este mapa.
TileOverlay	addTileOverlay(opciones de TileOverlayOptions) Agrega una superposición de mosaicos a este mapa.
void	animateCamera(actualización de CameraUpdate) Anima el movimiento de la cámara desde la posición actual hasta la posición definida en la actualización.
void	animateCamera(actualización de CameraUpdate, GoogleMap.CancelableCallback) Anima el movimiento de la cámara de la posición actual a la posición definida en la actualización y llama a una devolución de llamada opcional al finalizar.
void	animateCamera(actualización CameraUpdate, int durationMs, devolución de llamada GoogleMap.CancelableCallback) Mueve el mapa según la actualización con una animación durante un período especificado y llama a una devolución de llamada opcional al completarse.
void	clear() Elimina del mapa todos los marcadores, las polilíneas, los polígonos, las superposiciones, etc.
Posición de la cámara	getCameraPosition() Obtiene la posición actual de la cámara.
Interior de edificios	getFocusedBuilding() Obtiene el edificio actualmente enfocado.
int	getMapType() Obtiene el tipo de mapa que se muestra actualmente.
flotante	getMaxZoomLevel() Muestra el nivel de zoom máximo de la posición actual de la cámara.
flotante	getMinZoomLevel() Muestra el nivel de zoom mínimo.
Ubicación	getMyLocation() Este método es obsoleto. usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi proporciona un mejor uso de la búsqueda y el uso de energía y se usa con el punto azul "Mi ubicación</a>. Consulta MyLocationDemoActivity en la carpeta de aplicaciones de muestra para ver el código de ejemplo o consulta la Guía para desarrolladores de ubicación.
Proyección	getProjection() Muestra un objeto `Projection` que puedes usar para convertir coordenadas de pantalla y de latitud y longitud.
UiSettings.	getUiSettings() Obtiene la configuración de la interfaz de usuario del mapa.
boolean	isBuildingsEnabled() Muestra si la capa de edificios 3D está habilitada.
boolean	isIndoorEnabled() Obtiene si los mapas de interiores están habilitados.
boolean	isMyLocationEnabled() Obtiene el estado de la capa de mi ubicación.
boolean	isTrafficEnabled() Comprueba si el mapa está dibujando datos de tráfico.
void	moveCamera(actualización de CameraUpdate) Cambia la posición de la cámara según las instrucciones definidas en la actualización.
void	resetMinMaxZoomPreference() Quita los límites de zoom inferior y superior especificados anteriormente.
void	setBuildingsEnabled(booleano habilitado) Activa o desactiva la capa Edificios 3D.
void	setContentDescription(Descripción de la cadena) Establece un valor contentDescription para el mapa.
boolean	setIndoorEnabled(booleano habilitado) Establece si se deben habilitar los mapas de interiores.
void	setInfoWindowAdapter(adaptador GoogleMap.InfoWindowAdapter) Establece un procesador personalizado para el contenido de las ventanas de información.
void	setLatLngBoundsForCameraTarget(límites LatLngBounds) Especifica un LatLngBounds para restringir el objetivo de la cámara, de modo que cuando los usuarios se desplacen y se desplacen lateralmente por el mapa, el objetivo de la cámara no se moverá fuera de estos límites.
void	setLocationSource(fuente LocationSource) Reemplaza la fuente de ubicación de la capa my-location.
boolean	setMapStyle(estilo MapStyleOptions) Establece el estilo del mapa base.
void	setMapType(tipo int) Establece el tipo de mosaico de mapa que se debe mostrar.
void	setMaxZoomPreference(float maxZoomPreference) Establece un límite superior preferido para el zoom de la cámara.
void	setMinZoomPreference(float minZoomPreference) Establece un límite inferior preferido para el zoom de la cámara.
void	setMyLocationEnabled(booleano habilitado) Habilita o inhabilita la capa my-location.
void	setOnCameraChangeListener(objeto de escucha GoogleMap.OnCameraChangeListener) Este método es obsoleto. Reemplazado por `setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener)`, `setOnCameraMoveListener(GoogleMap.OnCameraMoveListener)`, `setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener)` y `setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)`.
void	setOnCameraIdleListener(objeto de escucha GoogleMap.OnCameraIdleListener) Establece una devolución de llamada que se invoca cuando finaliza el movimiento de la cámara.
void	setOnCameraMoveCanceledListener(objeto de escucha GoogleMap.OnCameraMoveCanceledListener) Establece una devolución de llamada que se invoca cuando un nuevo tipo de animación detiene o interrumpe el movimiento de la cámara.
void	setOnCameraMoveListener(objeto de escucha GoogleMap.OnCameraMoveListener) Establece una devolución de llamada que se invoca reiteradamente mientras la cámara está en movimiento.
void	setOnCameraMoveStartedListener(objeto de escucha GoogleMap.OnCameraMoveStartedListener) Establece una devolución de llamada que se invoca cuando la cámara comienza a moverse o cambió el motivo del movimiento.
void	setOnCircleClickListener(objeto de escucha GoogleMap.OnCircleClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en un círculo.
void	setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en una superposición de suelo.
void	setOnIndoorStateChangeListener(objeto de escucha GoogleMap.OnIndoorStateChangeListener) Configura o borra el objeto de escucha para eventos de interiores.
void	setOnInfoWindowClickListener(objeto de escucha GoogleMap.OnInfoWindowClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en una ventana de información del marcador.
void	setOnInfoWindowCloseListener(objeto de escucha GoogleMap.OnInfoWindowCloseListener) Establece una devolución de llamada que se invoca cuando se cierra la ventana de información de un marcador.
void	setOnInfoWindowLongClickListener(objeto de escucha GoogleMap.OnInfoWindowLongClickListener) Establece una devolución de llamada que se invoca cuando se mantiene presionada la ventana de información de un marcador.
void	setOnMapClickListener(objeto de escucha GoogleMap.OnMapClickListener) Establece una devolución de llamada que se invoca cuando se presiona el mapa.
void	setOnMapLoadedCallback(devolución de llamada GoogleMap.OnMapLoadedCallback) Establece una devolución de llamada que se invoca cuando el mapa termina de renderizarse.
void	setOnMapLongClickListener(objeto de escucha GoogleMap.OnMapLongClickListener) Establece una devolución de llamada que se invoca cuando el mapa se mantiene presionado.
void	setOnMarkerClickListener(objeto de escucha GoogleMap.OnMarkerClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en un marcador.
void	setOnMarkerDragListener(objeto de escucha GoogleMap.OnMarkerDragListener) Establece una devolución de llamada que se invoca cuando se arrastra un marcador.
void	setOnMyLocationButtonClickListener(objeto de escucha GoogleMap.OnMyLocationButtonClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en el botón de mi ubicación.
void	setOnMyLocationChangeListener(objeto de escucha GoogleMap.OnMyLocationChangeListener) Este método es obsoleto. usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi proporciona un mejor uso de la búsqueda y el uso de energía y se usa con el punto azul "Mi ubicación</a>. Consulta MyLocationDemoActivity en la carpeta de aplicaciones de muestra para ver el código de ejemplo o consulta la Guía para desarrolladores de ubicación.
void	setOnMyLocationClickListener(objeto de escucha GoogleMap.OnMyLocationClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en el punto “My Location” (que indica la ubicación del usuario).
void	setOnPoiClickListener(objeto de escucha GoogleMap.OnPoiClickListener) Establece un objeto de escucha que se activará cuando se haga clic o se presione un lugar de interés.
void	setOnPolygonClickListener(objeto de escucha GoogleMap.OnPolygonClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en un polígono.
void	setOnPolylineClickListener(objeto de escucha GoogleMap.OnPolylineClickListener) Establece una devolución de llamada que se invoca cuando se hace clic en una polilínea.
void	setPadding(int izquierda, int superior, int derecha, int inferior) Establece el relleno en el mapa.
void	setTrafficEnabled(booleano habilitado) Activa o desactiva la capa de tráfico.
void	snapshot(devolución de llamada GoogleMap.SnapshotReadyCallback) Toma una instantánea del mapa.
void	snapshot(devolución de llamada GoogleMap.SnapshotReadyCallback, mapa de bits) Toma una instantánea del mapa.
void	stopAnimation(). Detiene la animación de la cámara si hay una en curso.

Resumen de métodos heredados

Desde la clase java.lang.Object

boolean	equals(objeto arg0)
final Class<td;?>	getClass().
int	hashCode().
vacío final	notificar()
vacío final	notifyAll()
String	toString()
vacío final	wait(argumento largo, int arg1)
vacío final	wait(argumento largo)
vacío final	wait()

Constantes

public static final int MAP_TYPE_HYBRID

Mapas satelitales con una capa transparente de calles importantes.

Valor de la constante: 4

public static final int MAP_TYPE_NONE

No hay mosaicos de mapas básicos.

Valor de la constante: 0

public static final int MAP_TYPE_NORMAL

Mapas básicos.

Valor de la constante: 1

public static final int MAP_TYPE_SATELLITE

Mapas satelitales sin etiquetas

Valor de la constante: 2

public static final int MAP_TYPE_TERRAIN

Mapas de relieve.

Valor de la constante: 3

Métodos públicos

Público addCircle (Opciones de círculo)

Agrega un círculo a este mapa.

Parámetros

opciones	Un objeto de opciones de círculo que define cómo procesar el círculo

Resultado que se muestra

El objeto Circle que se agrega al mapa

público GroundOverlay addGroundOverlay (GroundOverlayOptions opciones)

Agrega una imagen a este mapa.

Parámetros

opciones	Un objeto de opciones de superposición de suelo que define cómo renderizar la superposición. Las opciones deben tener una imagen (AnchoredBitmap) y una posición especificadas.

Resultado que se muestra

El GroundOverlay que se agregó al mapa.

Arroja

IllegalArgumentException	si la imagen o la posición no se especifican en las opciones.

público addMarker (Opciones de marcador)

Agrega un marcador a este mapa.

El ícono del marcador se representa en el mapa en la ubicación Marker.position. Al hacer clic en el marcador, se centra la cámara en él. Si se define Marker.title, el mapa muestra un cuadro de información con el título y el fragmento correspondientes. Si el marcador es arrastrable, haz clic largo y, luego, arrástralo para moverlo.

Parámetros

opciones	Un objeto de opciones de marcadores que define la manera en que se debe renderizar el marcador.

Resultado que se muestra

El Marker que se agregó al mapa.

público Polygon addPolygon (Opciones de polígono)

Agrega un polígono a este mapa.

Parámetros

opciones	Un objeto de opciones de polígono que define cómo representar el polígono.

Resultado que se muestra

El objeto Polygon que se agrega al mapa.

public Polyline addPolyline (Opciones de PolilineOptions)

Agrega una polilínea a este mapa.

Parámetros

opciones	Un objeto de opciones de polilínea que define cómo renderizar la polilínea.

Resultado que se muestra

El objeto Polyline que se agregó al mapa.

público TileOverlay addTileOverlay (TileOverlayOptions opciones)

Agrega una superposición de mosaicos a este mapa. Consulta TileOverlay para obtener más información.

Ten en cuenta que, a diferencia de otras superposiciones, si el mapa se vuelve a crear, las superposiciones de mosaicos no se restablecen automáticamente y deben volver a agregarse manualmente.

Parámetros

opciones	Un objeto de opciones de superposición de mosaicos que define cómo renderizar la superposición. Las opciones deben tener un `TileProvider` especificado; de lo contrario, se arrojará una `IllegalArgumentException`.

Resultado que se muestra

El TileOverlay que se agregó al mapa.

Arroja

IllegalArgumentException	si no se especifica `TileProvider` en las opciones.

vacío público animateCamera (CameraUpdate update)

Anima el movimiento de la cámara desde la posición actual hasta la posición definida en la actualización. Durante la animación, una llamada a getCameraPosition() muestra una ubicación intermedia de la cámara.

Consulta CameraUpdateFactory para ver un conjunto de actualizaciones.

Parámetros

update	El cambio que se debe aplicar a la cámara.

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

Anima el movimiento de la cámara de la posición actual a la posición definida en la actualización y llama a una devolución de llamada opcional al finalizar. Consulta CameraUpdateFactory para obtener un conjunto de actualizaciones.

Durante la animación, una llamada a getCameraPosition() muestra una ubicación intermedia de la cámara.

Parámetros

update	El cambio que se debe aplicar a la cámara.
devolución de llamada	Es la devolución de llamada que se invoca desde el subproceso de la IU de Android cuando se detiene la animación. Si la animación se completa normalmente, se llama a `onFinish()`; de lo contrario, se llama a `onCancel()`. No actualices ni anime la cámara desde `onCancel()`.

vacío público animateCamera (CameraUpdate update, int durationMs, GoogleMap.CancelableCallback callback)

Mueve el mapa según la actualización con una animación durante un período especificado y llama a una devolución de llamada opcional al completarse. Consulta CameraUpdateFactory para ver un conjunto de actualizaciones.

Si se llama a getCameraPosition() durante la animación, mostrará la ubicación actual de la cámara en tránsito.

Parámetros

update
duración m	Es la duración de la animación en milisegundos. Debe ser estrictamente positivo; de lo contrario, se arrojará una `IllegalArgumentException`.
devolución de llamada	Una devolución de llamada opcional para recibir una notificación del subproceso de IU de Android cuando se detiene la animación. Si la animación se detiene debido a su finalización natural, la devolución de llamada recibirá una notificación con `onFinish()`. Si la animación se detiene debido a una interrupción posterior de un movimiento de la cámara o un gesto del usuario, se llamará a `onCancel()`. La devolución de llamada no debe intentar mover ni animar la cámara en su método de cancelación. Si no se requiere una devolución de llamada, déjala como `null`.

vacío público borrar ()

Elimina del mapa todos los marcadores, las polilíneas, los polígonos, las superposiciones, etc.

public CameraPosition getCameraPosition ()

Obtiene la posición actual de la cámara.

El CameraPosition que se muestra es una instantánea de la posición actual y no se actualizará automáticamente cuando se mueva la cámara.

Para obtener más información sobre cómo cambiar la posición de la cámara, consulta Cámara y vista.

Resultado que se muestra

La posición actual de la cámara.

public IndoorBuilding getFocusedBuilding ()

Obtiene el edificio actualmente enfocado.

Resultado que se muestra

Es el edificio enfocado actual o null si no hay ningún edificio enfocado.

public intgetMapType()

Obtiene el tipo de mapa que se muestra actualmente. Consulta MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN para ver los valores posibles.

Resultado que se muestra

Qué tipo de mapa mostrar

público flotante getMaxZoomLevel ()

Muestra el nivel de zoom máximo de la posición actual de la cámara. Esto tiene en cuenta qué tipo de mapa se está usando en la actualidad, p.ej., los datos satelitales o el relieve pueden tener un nivel de zoom máximo inferior al de los mosaicos del mapa base.

Para obtener más información sobre cómo cambiar el nivel de zoom de la cámara, consulta Cámara y vista.

Resultado que se muestra

El nivel de zoom máximo disponible en la posición actual de la cámara.

flotante público getMinZoomLevel ()

Muestra el nivel de zoom mínimo. Es igual en todas las ubicaciones (a diferencia del nivel de zoom máximo), pero puede variar según el dispositivo y el tamaño de mapa.

Para obtener más información sobre cómo cambiar el nivel de zoom de la cámara, consulta Cámara y vista.

Resultado que se muestra

El nivel de zoom mínimo disponible.

public Location getMyLocation ()

Este método es obsoleto.
En su lugar, usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi proporciona un mejor uso de la búsqueda y el uso de energía y se usa con el punto azul "Mi ubicación</a>. Consulta MyLocationDemoActivity en la carpeta de aplicaciones de muestra para ver el código de ejemplo o consulta la Guía para desarrolladores de ubicación.

Muestra la ubicación del usuario que se muestra actualmente o null si no hay datos de ubicación disponibles.

Resultado que se muestra

El elemento user location que se muestra actualmente

Arroja

IllegalStateException	si la capa mi ubicación no está habilitada.

Proyección pública getProjection ()

Muestra un objeto Projection que puedes usar para convertir coordenadas de pantalla y de latitud y longitud.

El Projection que se muestra es una instantánea de la proyección actual y no se actualizará automáticamente cuando se mueva la cámara. Como esta operación es costosa, deberías obtener la proyección solo una vez por pantalla. Google Maps usa la proyección de Mercator para crear sus mapas a partir de datos geográficos y convertir los puntos del mapa en coordenadas geográficas.

Resultado que se muestra

El Projection del mapa en su estado actual.

public UiSettings getUiSettings ()

Obtiene la configuración de la interfaz de usuario del mapa.

Resultado que se muestra

El UiSettings de este mapa.

Booleano público isBuildingsEnabled ()

Muestra si la capa de edificios 3D está habilitada.

Resultado que se muestra

true si los edificios están habilitados; de lo contrario, false

Booleano público isIndoorEnabled ()

Obtiene si los mapas de interiores están habilitados.

Resultado que se muestra

true si los mapas de interiores están habilitados; false si están inhabilitados;

Booleano público isMyLocationEnabled ()

Obtiene el estado de la capa de mi ubicación.

Resultado que se muestra

true si la capa mi ubicación está habilitada; de lo contrario, false.

Booleano público isTrafficEnabled ()

Comprueba si el mapa está dibujando datos de tráfico. Esto está sujeto a la disponibilidad de los datos de tráfico.

Resultado que se muestra

true si los datos de tráfico están habilitados; de lo contrario, false.

vacío público moveCamera (actualización de CameraUpdate)

Cambia la posición de la cámara según las instrucciones definidas en la actualización. El movimiento es instantáneo y una getCameraPosition() posterior reflejará la nueva posición. Consulta CameraUpdateFactory para ver un conjunto de actualizaciones.

Parámetros

update	El cambio que se debe aplicar a la cámara.

vacío público resetMinMaxZoomPreference ()

Quita los límites de zoom inferior y superior especificados anteriormente.

vacío público setBuildingsEnabled (booleano habilitado)

Activa o desactiva la capa Edificios 3D.

Parámetros

habilitado	`true` para habilitar la capa de edificios 3D; `false` para inhabilitar los edificios 3D.

vacío público setContentDescription (Descripción de string)

Establece un valor contentDescription para el mapa.

Se usa para proporcionar una descripción hablada del mapa en el modo de accesibilidad. El valor predeterminado es & Google Map.

Parámetros

descripción	una string para usar como descripción.

Booleano público setIndoorEnabled (booleano habilitado)

Establece si se deben habilitar los mapas de interiores. Actualmente, los mapas de interiores solo se pueden mostrar en un mapa a la vez. De forma predeterminada, este es el primer mapa que se agrega a tu aplicación. Para habilitar los mapas de interiores en otro mapa, primero debes inhabilitarlos en el mapa original. Si intentas habilitar los mapas de interiores cuando se habiliten en otro mapa, no sucederá nada y se mostrará false. Cuando no esté habilitada la función de mapa de interiores, todos los métodos relacionados con interiores mostrarán null o false.

Parámetros

habilitado	`true` para intentar habilitar los mapas de interiores; `false` para inhabilitar los mapas de interiores.

Resultado que se muestra

si era posible habilitar los mapas de interiores.

vacío público setInfoWindowAdapter (GoogleMap.InfoWindowAdapter adaptador)

Establece un procesador personalizado para el contenido de las ventanas de información.

Al igual que los objetos de escucha de eventos del mapa, este estado no se serializa con el mapa. Si se vuelve a crear el mapa (p.ej., debido a un cambio de configuración), debes asegurarte de volver a llamar a este método para conservar la personalización.

Parámetros

adaptador	Adaptador para usar en el contenido de la ventana de información o `null` para usar el procesamiento de contenido predeterminado en las ventanas de información.

vacío público setLatLngBoundsForCameraTarget (LatLngBounds límites)

Especifica un LatLngBounds para restringir el objetivo de la cámara, de modo que cuando los usuarios se desplacen y se desplacen lateralmente por el mapa, el objetivo de la cámara no se moverá fuera de estos límites.

Configúralo como nulo para borrar por completo el cuadro de límite. Los nuevos límites reemplazan a cualquier cuadro de límite especificado con anterioridad.

Cuando LatLngBounds cambia, el SDK ajusta todas las actualizaciones posteriores de la cámara para respetar esos límites, si es posible. Ten en cuenta que hay consideraciones técnicas que pueden impedir que el SDK mantenga el objetivo de la cámara estrictamente dentro de los límites. Por ejemplo, errores de redondeo de precisión de punto flotante o un nivel de zoom muy bajo.

Parámetros

límites	Los límites para limitar el objetivo de la cámara.

public void setLocationSource (SourceSource fuente)

Reemplaza la fuente de ubicación de la capa my-location.

Parámetros

source	Una fuente de ubicación para usar en la capa de mi ubicación Configúralo como `null` para usar la fuente de ubicación predeterminada.

booleano público setMapStyle (estilo MapStyleOptions)

Establece el estilo del mapa base.

Con las opciones de estilo, puedes aplicar estilos personalizados a elementos y elementos del mapa. Consulta MapStyleOptions para obtener detalles sobre la definición de estilo.

Se establece en nulo para borrar cualquier estilo personalizado anterior.

Parámetros

estilo

Resultado que se muestra

true si el estilo se analizó correctamente; false si se detectaron problemas con MapStyleOptions; p.ej., no se pudo analizar el estilo JSON, el tipo de atributo no reconocido, el tipo de elemento no reconocido o las claves de estilo no válidas. Si el valor que se muestra es false, el estilo actual no se modifica.

vacío público setMapType (tipo int)

Establece el tipo de mosaico de mapa que se debe mostrar. Los valores permitidos son los siguientes:

MAP_TYPE_NORMAL: Mapa básico.
MAP_TYPE_SATELLITE: Imágenes satelitales.
MAP_TYPE_HYBRID: Imágenes satelitales con rutas y etiquetas
MAP_TYPE_TERRAIN: Datos topográficos.
MAP_TYPE_NONE: No hay mosaicos de mapas base.

Parámetros

type	El tipo de mapa que se mostrará.

vacío público setMaxZoomPreference (float maxZoomPreference)

Establece un límite superior preferido para el zoom de la cámara.

Cuando cambia el zoom máximo, el SDK ajusta todas las actualizaciones de cámara posteriores para respetarlo, de ser posible. Ten en cuenta que existen consideraciones técnicas que pueden impedir que el SDK permita que los usuarios acerquen demasiado el mapa. Por ejemplo, un mapa satelital o terrestre puede tener un nivel de zoom máximo inferior al de los mosaicos del mapa base.

El SDK resuelve los conflictos entre valores mínimos y máximos. Si estableces el zoom mínimo en un nivel de zoom más alto que el máximo actual, el SDK usa el nuevo valor mínimo para ambos. Si estableces el zoom máximo en un nivel de zoom inferior al mínimo, el SDK usará el nuevo valor máximo para ambos. Por ejemplo, supongamos que el zoom mínimo actual es 8 y el máximo es 14. A continuación, establece el zoom máximo en 6. El SDK usa un zoom mínimo de 6 y un máximo de 6.

Parámetros

MaxZoomPreference	El límite superior preferido.

public void setMinZoomPreference (float minZoomPreference)

Establece un límite inferior preferido para el zoom de la cámara.

Cuando cambia el zoom mínimo, el SDK ajusta todas las actualizaciones de cámara posteriores para respetarlo, si es posible. Ten en cuenta que existen consideraciones técnicas que pueden impedir que el SDK permita que los usuarios acerquen demasiado el zoom.

El SDK resuelve los conflictos entre valores mínimos y máximos. Si estableces el zoom mínimo en un nivel de zoom más alto que el máximo actual, el SDK usa el nuevo valor mínimo para ambos. Si estableces el zoom máximo en un nivel de zoom inferior al mínimo, el SDK usará el nuevo valor máximo para ambos. Por ejemplo, supongamos que el zoom mínimo actual es 8 y el máximo es 14. A continuación, establece el zoom mínimo en 16. El SDK usa un zoom mínimo de 16 y un máximo de 16.

Parámetros

minZoomPreference	El límite inferior preferido.

vacío público setMyLocationEnabled (booleano habilitado)

Habilita o inhabilita la capa my-location.

Cuando está habilitada y la ubicación está disponible, la capa Mi ubicación dibuja de forma continua una indicación de la ubicación y el rumbo actuales de un usuario, y muestra los controles de la IU que permiten al usuario interactuar con su ubicación (por ejemplo, para habilitar o inhabilitar el seguimiento de la ubicación y la orientación de la cámara).

A fin de usar la función my-location-layer, debes solicitar permiso para ACCESS_COARSE_LOCATION o ACCESS_FINE_LOCATION, a menos que hayas configurado una fuente de ubicación personalizada.

Si configuraste una fuente de ubicación personalizada a través de setLocationSource(LocationSource), el SDK de Google Maps para Android no comprobará si se otorgaron los permisos anteriores. Sin embargo, aún debes asegurarte de que el usuario haya otorgado todos los permisos necesarios para tu fuente de ubicación personalizada.

Parámetros

habilitado	`true` para habilitar; `false` para inhabilitar.

Arroja

SecurityException	si no se otorga el permiso de ubicación.

vacío público setOnCameraChangeListener (objeto de escucha de GoogleMap.OnCameraChangeListener)

Este método es obsoleto.
Reemplazado por setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) y setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

Establece una devolución de llamada que se invoca cuando cambia la cámara.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando cambia la cámara. Para desactivar la devolución de llamada, usa `null`.

vacío público setOnCameraIdleListener (objeto de escucha de GoogleMap.OnCameraIdleListener)

Establece una devolución de llamada que se invoca cuando finaliza el movimiento de la cámara.

Parámetros

objeto de escucha	Es la devolución de llamada que se invocó. Para desactivar la devolución de llamada, usa `null`.

public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener receptor)

Establece una devolución de llamada que se invoca cuando un nuevo tipo de animación detiene o interrumpe el movimiento de la cámara.

Parámetros

objeto de escucha	Es la devolución de llamada que se invocó. Para desactivar la devolución de llamada, usa `null`. No actualices ni anime la cámara desde `onCameraMoveCanceled()`.

vacío público setOnCameraMoveListener (objeto de escucha GoogleMap.OnCameraMoveListener)

Establece una devolución de llamada que se invoca reiteradamente mientras la cámara está en movimiento. La devolución de llamada se puede invocar con la misma frecuencia que una vez por cada fotograma y no debe realizar operaciones costosas.

Parámetros

objeto de escucha	Es la devolución de llamada que se invocó. Para desactivar la devolución de llamada, usa `null`.

vacío público setOnCameraMoveStartedListener (objeto de escucha de GoogleMap.OnCameraMoveStartedListener)

Establece una devolución de llamada que se invoca cuando la cámara comienza a moverse o cambió el motivo del movimiento.

Parámetros

objeto de escucha	Es la devolución de llamada que se invocó. Para desactivar la devolución de llamada, usa `null`. No actualices ni anime la cámara desde `onCameraMoveStarted()`.

public void setOnCircleClickListener (objeto de escucha de GoogleMap.OnCircleClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en un círculo.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en un círculo. Para desactivar la devolución de llamada, usa `null`.

public void setOnGroundOverlayClickListener (objeto de escucha de GoogleMap.OnGroundOverlayClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en una superposición de suelo.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en una superposición de suelo. Para desactivar la devolución de llamada, usa `null`.

público público setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener)

Configura o borra el objeto de escucha para eventos de interiores. Solo se puede configurar un objeto de escucha. Si configuras un nuevo objeto de escucha, se quitará el anterior.

Parámetros

objeto de escucha	el receptor para eventos de interiores si no es nulo; de lo contrario, borra el receptor

vacío público setOnInfoWindowClickListener (objeto de escucha de GoogleMap.OnInfoWindowClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en una ventana de información del marcador.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en una ventana de información del marcador. Para desactivar la devolución de llamada, usa `null`.

public void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener Listener)

Establece una devolución de llamada que se invoca cuando se cierra la ventana de información de un marcador.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se cierra la ventana de información de un marcador. Para desactivar la devolución de llamada, usa `null`.

vacío público setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener escucha)

Establece una devolución de llamada que se invoca cuando se mantiene presionada la ventana de información de un marcador.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se mantiene presionada la ventana de información de un marcador. Para desactivar la devolución de llamada, usa `null`.

public void setOnMapClickListener (objeto de escucha de GoogleMap.OnMapClickListener)

Establece una devolución de llamada que se invoca cuando se presiona el mapa.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se presiona el mapa. Para desactivar la devolución de llamada, usa `null`.

vacío público setOnMapLoadedCallback (Devolución de llamada de GoogleMap.OnMapLoadedCallback)

Establece una devolución de llamada que se invoca cuando el mapa termina de renderizarse. La devolución de llamada se invocará una sola vez.

Si se llama a este método cuando se renderiza por completo el mapa, se invocará inmediatamente la devolución de llamada. Este evento no se activará si el mapa nunca se carga debido a problemas de conectividad o si cambia constantemente y nunca completa la carga debido a que el usuario interactúa constantemente con el mapa.

Parámetros

devolución de llamada	Es la devolución de llamada que se invoca cuando el mapa termina de renderizarse. Para desactivar la devolución de llamada, usa `null`.

vacío público setOnMapLongClickListener (objeto de escucha de GoogleMap.OnMapLongClickListener)

Establece una devolución de llamada que se invoca cuando el mapa se mantiene presionado.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se mantiene presionado el mapa. Para desactivar la devolución de llamada, usa `null`.

vacío público setOnMarkerClickListener (GoogleMap.OnMarkerClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en un marcador.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en un marcador. Para desactivar la devolución de llamada, usa `null`.

public void setOnMarkerDragListener (objeto de escucha de GoogleMap.OnMarkerDragListener)

Establece una devolución de llamada que se invoca cuando se arrastra un marcador.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca en los eventos de arrastre de marcadores. Para desactivar la devolución de llamada, usa `null`.

vacío público setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en el botón de mi ubicación.

Si listener muestra true, se consume el evento y no se produce el comportamiento predeterminado. Si muestra false, se producirá el comportamiento predeterminado (es decir, la cámara se moverá de modo que se centre en la ubicación del usuario).

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en el botón Mi ubicación.

vacío público setOnMyLocationChangeListener (objeto de escucha de GoogleMap.OnMyLocationChangeListener)

Establece una devolución de llamada que se invoca cuando el punto de Mi ubicación cambia de ubicación.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando cambia el punto “My Location”.

public void setOnMyLocationClickListener (objeto de escucha de GoogleMap.OnMyLocationClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en el punto “My Location” (que indica la ubicación del usuario).

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en el punto “My Location”.

public void setOnPoiClickListener (GoogleMap.OnPoiClickListener objeto de escucha)

Establece un objeto de escucha que se activará cuando se haga clic o se presione un lugar de interés.

Pasa null para borrar el objeto de escucha.

Parámetros

objeto de escucha

vacío público setOnPolygonClickListener (objeto de escucha de GoogleMap.OnPolygonClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en un polígono.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en un polígono. Para desactivar la devolución de llamada, usa `null`.

public void setOnPolylineClickListener (objeto de escucha de GoogleMap.OnPolylineClickListener)

Establece una devolución de llamada que se invoca cuando se hace clic en una polilínea.

Parámetros

objeto de escucha	Es la devolución de llamada que se invoca cuando se hace clic en una polilínea. Para desactivar la devolución de llamada, usa `null`.

vacío público setPadding (int left, int top, int right, int bottom)

Establece el relleno en el mapa.

Este método te permite definir una región visible en el mapa para indicarle al mapa que las partes del mapa en los bordes pueden ocultarse estableciendo el relleno en cada uno de los cuatro bordes. Las funciones del mapa se adaptarán al padding. Por ejemplo, los controles de zoom, la brújula, los avisos de derechos de autor y el logotipo de Google se moverán para que quepan en la región definida, los movimientos de la cámara estarán relacionados con el centro de la región visible, etc.

Parámetros

left	la cantidad de píxeles de relleno que se agregarán a la izquierda del mapa.
superior	la cantidad de píxeles de relleno que se agregarán en la parte superior del mapa.
right	la cantidad de píxeles de relleno que se agregarán a la derecha del mapa.
Parte baja	la cantidad de píxeles de relleno que se agregarán en la parte inferior del mapa.

vacío público setTrafficEnabled (booleano habilitado)

Activa o desactiva la capa de tráfico.

Parámetros

habilitado

vacío público instantánea (Devolución de llamada de GoogleMap.SnapshotReadyCallback)

Toma una instantánea del mapa.

Puedes usar instantáneas dentro de la aplicación cuando un mapa interactivo sería difícil o imposible de usar. Por ejemplo, las imágenes producidas con el método snapshot() se pueden usar para mostrar una miniatura del mapa en tu app o una instantánea en el centro de notificaciones.

Nota: Las imágenes del mapa no se deben transmitir a tus servidores ni se deben usar fuera de la aplicación. Si necesitas enviar un mapa a otra aplicación o usuario, envía datos que les permitan reconstruir el mapa para el usuario nuevo en lugar de una instantánea.

Parámetros

devolución de llamada	Es el método de devolución de llamada que se invoca cuando se toma la instantánea.

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

Toma una instantánea del mapa.

Este método es equivalente a snapshot(SnapshotReadyCallback), pero te permite proporcionar un Bitmap preasignado. Si el mapa de bits no coincide con las dimensiones actuales del mapa, se asignará otro mapa que se ajuste a las dimensiones del mapa.

Si bien en la mayoría de los casos el objeto que pasa el método de devolución de llamada es el mismo que el que se proporciona en el parámetro a este método, en algunos casos el objeto que se muestra puede ser diferente (p.ej., si las dimensiones de la vista cambiaron para cuando se tomó la instantánea). Por lo tanto, solo debes confiar en el contenido del mapa de bits que pasa el método de devolución de llamada.

Parámetros

devolución de llamada	Es el método de devolución de llamada que se invoca cuando se toma la instantánea.
mapa de bits	Un mapa de bits preasignado. Si es `null`, se comporta como `snapshot(SnapshotReadyCallback)`.

vacío público stopAnimation ()

Detiene la animación de la cámara si hay una en curso. Cuando se llama al método, la cámara deja de moverse de inmediato y permanece en esa posición.