GoogleMap

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
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
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

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

public UiSettings getUiSettings ()

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

Resultado que se muestra

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:

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)

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.

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.