GoogleMap

La clase final pública GoogleMap extiende Object
.

Es la clase principal del SDK de Google Maps para Android y 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 de otro subproceso, se generará una excepción.

Para ajustar el punto de vista de un mapa, cambia la posición de la cámara (en lugar de mover el mapa). Puedes usar la cámara del mapa para configurar 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 cancela. 
Interfaz GoogleMap.InfoWindowAdapter Proporciona vistas para la renderización personalizada de las ventanas de información. 
Interfaz GoogleMap.OnCameraChangeListener Esta interfaz dejó de estar disponible. Se reemplazó por GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener y GoogleMap.OnCameraIdleListener. No está definido el orden en el que se llamará al método obsoleto onCameraChange en relación con los métodos en los objetos de escucha de cambio de cámara nuevos.  
Interfaz GoogleMap.OnCameraIdleListener Interfaz de devolución de llamada para cuando finalice 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 esta comienza a moverse por un nuevo 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 de interiores
Interfaz GoogleMap.OnInfoWindowClickListener Interfaz de devolución de llamada para eventos de clic o presión en la ventana de información de un marcador
Interfaz GoogleMap.OnInfoWindowCloseListener Interfaz de devolución de llamada para cerrar eventos 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 se termina de renderizar el mapa. 
Interfaz GoogleMap.OnMapLongClickListener Interfaz de devolución de llamada para cuando el usuario mantiene presionado el mapa. 
Interfaz GoogleMap.OnMarkerClickListener Define las firmas para los métodos a los que se llama cuando se presiona un marcador o se hace clic en él. 
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 dejó de estar disponible. En su lugar, usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi proporciona una mejor búsqueda de ubicación y consumo de energía, y lo usa el punto azul "Mi ubicación". Consulta el instructivo Cómo seleccionar un lugar actual, que usa FusedLocationProviderApi, o la Guía para desarrolladores de ubicaciones.  
Interfaz GoogleMap.OnMyLocationClickListener Interfaz de devolución de llamada para cuando se hace clic en el punto Mi ubicación (que representa la ubicación del usuario).
Interfaz GoogleMap.OnPoiClickListener Es un objeto de escucha de toques en 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 que se tomó la instantánea. 

Resumen de constantes

int MAP_TYPE_HYBRID Mapas satelitales con una capa transparente de calles principales.
int MAP_TYPE_NONE No hay mosaicos de mapa base.
int MAP_TYPE_NORMAL Mapas básicos
int MAP_TYPE_SATELLITE Mapas satelitales sin etiquetas.
int MAP_TYPE_TERRAIN Mapas de terreno.

Resumen de métodos públicos

Circle
addCircle(opciones CircleOptions)
Agrega un círculo a este mapa.
GroundOverlay
addGroundOverlay(opciones GroundOverlayOptions)
Agrega una imagen a este mapa.
Marker
addMarker(opciones de MarkerOptions)
Agrega un marcador a este mapa.
Polygon
addPolygon(opciones 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, devolución de llamada GoogleMap.CancelableCallback)
Anima el movimiento de la cámara desde la posición actual hasta la posición definida en la actualización y llama a una devolución de llamada opcional al finalizar.
void
animateCamera(actualización de CameraUpdate, duración int, devolución de llamada GoogleMap.CancelableCallback)
Mueve el mapa según la actualización con una animación durante un tiempo especificado y llama a una devolución de llamada opcional cuando se completa.
void
clear()
Elimina todos los marcadores, polilíneas, polígonos, superposiciones, etc. del mapa.
CameraPosition
getCameraPosition()
Obtiene la posición actual de la cámara.
IndoorBuilding
getFocusedBuilding()
Obtiene el edificio enfocado actualmente.
int
getMapType()
Obtiene el tipo de mapa que se muestra en el momento.
float
getMaxZoomLevel()
Muestra el nivel de zoom máximo para la posición actual de la cámara.
float
getMinZoomLevel()
Muestra el nivel de zoom mínimo.
Location
getMyLocation()
Este método dejó de estar disponible. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi proporciona una mejor búsqueda de ubicación y consumo de energía, y lo usa el punto azul "Mi ubicación". Consulta MyLocationDemoActivity en la carpeta de aplicaciones de ejemplo para ver el código de ejemplo o la Guía para desarrolladores de ubicaciones.
Proyección
getProjection()
Muestra un objeto Projection que puedes usar para convertir entre coordenadas de pantalla y coordenadas 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 actualmente.
boolean
isMyLocationEnabled().
Obtiene el estado de la capa my-location.
boolean
isTrafficEnabled()
Comprueba si el mapa está generando 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 inferiores y superiores que se especificaron anteriormente.
void
setBuildingsEnabled(booleano habilitado)
Activa o desactiva la capa de edificios 3D.
void
setContentDescription(Descripción de la cadena)
Establece un contentDescription para el mapa.
boolean
setIndoorEnabled(booleano habilitado)
Establece si se deben habilitar los mapas de interiores.
void
setInfoWindowAdapter(adaptador GoogleMap.InfoWindowAdapter)
Configura un procesador personalizado para el contenido de las ventanas de información.
void
setLatLngBoundsForCameraTarget(límites LatLngBounds)
Especifica un objeto LatLngBounds para restringir el objetivo de la cámara, de modo que, cuando los usuarios se desplacen por el mapa, el objetivo de la cámara no se mueva 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 diseño del mapa base.
void
setMapType(tipo de int)
Establece el tipo de mosaicos de mapas que deben mostrarse.
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)
Configura una devolución de llamada que se invoca cuando un nuevo tipo de animación se 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 repetidamente mientras la cámara está en movimiento.
void
setOnCameraMoveStartedListener(objeto de escucha GoogleMap.OnCameraMoveStartedListener)
Configura una devolución de llamada que se invoca cuando la cámara comienza a moverse o el motivo del movimiento de la cámara cambia.
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.
void
setOnGroundOverlayClickListener(objeto de escucha 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)
Establece o borra el objeto de escucha para eventos en interiores.
void
setOnInfoWindowClickListener(objeto de escucha GoogleMap.OnInfoWindowClickListener)
Establece una devolución de llamada que se invoca cuando se hace clic en la ventana de información de un 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 finaliza la renderización de este mapa.
void
setOnMapLongClickListener(objeto de escucha GoogleMap.OnMapLongClickListener)
Establece una devolución de llamada que se invoca cuando se mantiene presionado el mapa.
void
setOnMarkerClickListener(objeto de escucha de GoogleMap.OnMarkerClickListener)
Establece una devolución de llamada que se invoca cuando se hace clic en un marcador.
void
setOnMarkerDragListener(objeto de escucha de 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 Mi ubicación.
void
setOnMyLocationChangeListener(objeto de escucha GoogleMap.OnMyLocationChangeListener)
Este método dejó de estar disponible. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi proporciona una mejor búsqueda de ubicación y consumo de energía, y lo usa el punto azul "Mi ubicación". Consulta MyLocationDemoActivity en la carpeta de aplicaciones de ejemplo para ver el código de ejemplo o la Guía para desarrolladores de ubicaciones.
void
setOnMyLocationClickListener(objeto de escucha de GoogleMap.OnMyLocationClickListener)
Configura una devolución de llamada que se invoca cuando se hace clic en el punto Mi ubicación (que representa la ubicación del usuario).
void
setOnPoiClickListener(objeto de escucha GoogleMap.OnPoiClickListener)
Establece un objeto de escucha que se activará cuando se haga clic en un lugar de interés o se lo presione.
void
setOnPolygonClickListener(objeto de escucha de 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)
Configura el padding en el mapa.
void
setTrafficEnabled(booleano habilitado)
Activa o desactiva la capa de tráfico.
void
instantánea(devolución de llamada GoogleMap.SnapshotReadyCallback)
Toma una instantánea del mapa.
void
Snapshot(devolución de llamada GoogleMap.SnapshotReadyCallback, mapa de bits de 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

público estático final int MAP_TYPE_HYBRID

Mapas satelitales con una capa transparente de calles principales.

Valor de la constante: 4

público estático final int MAP_TYPE_NONE

No hay mosaicos de mapa base.

Valor de la constante: 0

público estático final int MAP_TYPE_NORMAL

Mapas básicos

Valor de la constante: 1

público estático final int MAP_TYPE_SATELLITE

Mapas satelitales sin etiquetas.

Valor de la constante: 2

público estático final int MAP_TYPE_TERRAIN

Mapas de terreno.

Valor de la constante: 3

Métodos públicos

público Circle addCircle (CircleOptions opciones)

Agrega un círculo a este mapa.

Parámetros
Opciones Un objeto de opciones de círculo que define cómo renderizar el círculo
Devuelve
  • El objeto Circle que se agrega al mapa

GroundOverlay addGroundOverlay (GroundOverlayOptions)

Agrega una imagen a este mapa.

Parámetros
Opciones Es 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.
Devuelve
Arroja
IllegalArgumentException si la imagen o la posición no se especifican en las opciones.

público Marker addMarker (Opciones de MarkerOptions)

Agrega un marcador a este mapa.

El ícono del marcador se renderiza en el mapa en la ubicación Marker.position. Si haces clic en el marcador, se centra la cámara sobre el marcador. Si se define Marker.title, se mostrará en el mapa un cuadro de información con el título y el fragmento del marcador. Si el marcador es arrastrable, lo mueves durante un clic prolongado y, luego, arrastrándolo.

Parámetros
Opciones Es un objeto de opciones de marcador que define cómo renderizar el marcador.
Devuelve
  • El Marker que se agregó al mapa.

público Polygon addPolygon (opciones de PolygonOptions)

Agrega un polígono a este mapa.

Parámetros
Opciones Un objeto de opciones de polígono que define cómo renderizar el objeto Polygon.
Devuelve
  • El objeto Polygon que se agrega al mapa.

public Polyline addPolyline (opciones de PolylineOptions)

Agrega una polilínea a este mapa.

Parámetros
Opciones Es un objeto de opciones de polilínea que define cómo renderizar la polilínea.
Devuelve
  • El objeto Polyline que se agregó al mapa.

TileOverlay addTileOverlay (TileOverlayOptions options)

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 se vuelve a crear el mapa, las superposiciones de mosaicos no se restablecen automáticamente, sino que se deben volver a agregar de forma manual.

Parámetros
Opciones Es 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.
Devuelve
Arroja
IllegalArgumentException Si TileProvider no se especifica en las opciones.

public 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. Durante la animación, una llamada a getCameraPosition() muestra una ubicación intermedia de la cámara.

Consulta CameraUpdateFactory para ver una serie de actualizaciones.

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

público público animateCamera (actualización de CameraUpdate, devolución de llamada de GoogleMap.CancelableCallback)

Anima el movimiento de la cámara desde la posición actual hasta la posición definida en la actualización y llama a una devolución de llamada opcional al finalizar. Consulta CameraUpdateFactory para ver una serie 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.
callback Es la devolución de llamada que se debe invocar desde el subproceso de IU de Android cuando se detiene la animación. Si la animación se completa con normalidad, se llama a onFinish(). De lo contrario, se llama a onCancel(). No actualices ni animes la cámara desde onCancel().

público público animateCamera (actualización de CameraUpdate, duración int, devolución de llamada GoogleMap.CancelableCallback)

Mueve el mapa según la actualización con una animación durante un tiempo especificado y llama a una devolución de llamada opcional cuando se completa. Consulta CameraUpdateFactory para ver una serie de actualizaciones.

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

Parámetros
update
durationMs Es la duración de la animación, expresada en milisegundos. Debe ser estrictamente positivo; de lo contrario, se arrojará una IllegalArgumentException.
callback Una devolución de llamada opcional para recibir una notificación del subproceso de IU de Android cuando se detenga la animación. Si la animación se detiene debido a su finalización natural, la devolución de llamada se notificará con onFinish(). Si la animación se detiene debido a una interrupción por un movimiento posterior 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.

public void clear ()

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

public CameraPosition getCameraPosition ()

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

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

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

Devuelve
  • Es la posición actual de la cámara.

public IndoorBuilding getFocusedBuilding ()

Obtiene el edificio enfocado actualmente.

Devuelve
  • El edificio enfocado actual o null si no hay ningún edificio enfocado.

public int getMapType ()

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

Devuelve
  • Qué tipo de mapa mostrar

public float getMaxZoomLevel ()

Muestra el nivel de zoom máximo para la posición actual de la cámara. Tiene en cuenta el tipo de mapa utilizado actualmente, p.ej., los mapas satelitales o de terreno 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.

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

public float getMinZoomLevel ()

Muestra el nivel de zoom mínimo. Es igual para 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.

Devuelve
  • El nivel de zoom mínimo disponible.

ubicación pública getMyLocation ()

Este método es obsoleto.
En su lugar, usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi proporciona una mejor búsqueda de ubicación y consumo de energía, y lo usa el punto azul "Mi ubicación". Consulta MyLocationDemoActivity en la carpeta de aplicaciones de ejemplo para ver el código de ejemplo, o la Guía para desarrolladores de ubicaciones.

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

Devuelve
Arroja
IllegalStateException si la capa my-location no está habilitada.

Projection getProjection ()

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

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

Devuelve

public UiSettings getUiSettings ()

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

Devuelve

público booleano isBuildingsEnabled ()

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

Devuelve
  • true si los edificios están habilitados; false de lo contrario.

público booleano isIndoorEnabled ()

Obtiene si los mapas de interiores están habilitados actualmente.

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

público booleano isMyLocationEnabled ()

Obtiene el estado de la capa my-location.

Devuelve
  • true si la capa my-location está habilitada; de lo contrario, false.

público booleano isTrafficEnabled ()

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

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

public void 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 un elemento getCameraPosition() posterior reflejará la nueva posición. Consulta CameraUpdateFactory para ver una serie de actualizaciones.

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

público público resetMinMaxZoomPreference ()

Quita los límites de zoom inferiores y superiores que se especificaron anteriormente.

público público setBuildingsEnabled (boolean enabled)

Activa o desactiva la capa de edificios 3D.

Parámetros
habilitado true para habilitar la capa de edificios 3D; false para inhabilitar los edificios 3D.

public void setContentDescription (Descripción de la cadena)

Establece un contentDescription para el mapa.

Se usa para proporcionar una descripción por voz del mapa en el modo de accesibilidad. El valor predeterminado es "Google Maps".

Parámetros
descripción una cadena para usar como descripción.

público booleano setIndoorEnabled (boolean enabled)

Establece si se deben habilitar los mapas de interiores. Actualmente, los mapas de interiores solo se pueden mostrar en un mapa a la vez y, de forma predeterminada, este es el primer mapa que agregas a tu aplicación. Para habilitar los mapas de interiores en otro mapa, primero debes inhabilitar los mapas de interiores en el mapa original. Si intentas habilitar los mapas de interiores cuando están habilitados en otro mapa, no sucederá nada y se mostrará el valor false. Cuando la función Indoor no esté habilitada para un mapa, 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.
Devuelve
  • si era posible habilitar los mapas de interiores.

public void setInfoWindowAdapter (adaptador GoogleMap.InfoWindowAdapter)

Configura 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 preservar la personalización.

Parámetros
adaptador El adaptador que se usará para el contenido de las ventanas de información o null para usar el procesamiento de contenido predeterminado en esas ventanas.

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

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

Si se establece como nulo, se borrará por completo el cuadro delimitador. Los límites nuevos reemplazan cualquier cuadro de límite especificado con anterioridad.

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

Parámetros
límites Los límites para restringir el objetivo de la cámara en el interior.

público público setLocationSource (fuente de LocationSource)

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

Parámetros
source Una fuente de ubicación para usar en la capa my-location. Configúralo en null para usar la fuente de ubicación predeterminada.

público booleano setMapStyle (estilo de MapStyleOptions)

Establece el diseño del mapa base.

Con las opciones de diseño, puedes aplicar diseños personalizados a los componentes y elementos del mapa. Consulta MapStyleOptions para obtener detalles sobre la definición de estilo.

Configúralo como nulo para borrar cualquier estilo personalizado anterior.

Parámetros
estilo
Devuelve
  • true si el estilo se analizó correctamente; false si se detectaron problemas con MapStyleOptions, incluidos, p.ej., un estilo JSON que no se puede analizar, el tipo de componente no reconocido, el tipo de elemento no reconocido o las claves de parámetro de diseño no válidas. Si el valor que se muestra es false, el diseño actual no se modifica.

público público setMapType (tipo de int)

Establece el tipo de mosaicos de mapas que deben mostrarse. Los valores permitidos son los siguientes:

Parámetros
tipo Es el tipo de mapa que se mostrará.

público void 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 posteriores de la cámara para respetar ese máximo, si es posible. Ten en cuenta que existen consideraciones técnicas que podrían impedir que el SDK permita a los usuarios acercar demasiado el zoom en 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 cualquier conflicto que exista en los valores mínimo y máximo. Si estableces el zoom mínimo en un nivel de zoom superior al máximo actual, el SDK usará el nuevo valor mínimo para el mínimo y el máximo. Si estableces el zoom máximo en un nivel de zoom inferior al mínimo, el SDK usará el nuevo valor máximo para el valor mínimo y máximo. Por ejemplo, supongamos que el zoom mínimo actual es de 8 y el máximo es de 14. A continuación, estableces el zoom máximo en 6. El SDK usa un zoom mínimo de 6 y un máximo de 6.

Parámetros
maxZoomPreference Es el límite superior preferido.

público público 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 posteriores de la cámara para respetar ese mínimo, si es posible. Ten en cuenta que existen consideraciones técnicas que podrían impedir que el SDK permita a los usuarios acercar demasiado el mapa.

El SDK resuelve cualquier conflicto que exista en los valores mínimo y máximo. Si estableces el zoom mínimo en un nivel de zoom superior al máximo actual, el SDK usará el nuevo valor mínimo para el mínimo y el máximo. Si estableces el zoom máximo en un nivel de zoom inferior al mínimo, el SDK usará el nuevo valor máximo para el valor mínimo y máximo. Por ejemplo, supongamos que el zoom mínimo actual es de 8 y el máximo es de 14. A continuación, estableces el zoom mínimo en 16. El SDK usa un zoom mínimo de 16 y uno máximo de 16.

Parámetros
minZoomPreference Es el límite inferior preferido.

público público setMyLocationEnabled (boolean enabled)

Habilita o inhabilita la capa my-location.

Cuando está habilitada y la ubicación está disponible, la capa mi ubicación dibuja de manera continua una indicación de la ubicación y el rumbo actuales del usuario, y muestra 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 el rumbo de la cámara).

Para 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 verificará 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.

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

Este método dejó de estar disponible.
Se reemplazó 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.

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

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

Parámetros
objeto de escucha La devolución de llamada que se invoca Para desactivar la devolución de llamada, usa null.

público público setOnCameraMoveCanceledListener (objeto de escucha GoogleMap.OnCameraMoveCanceledListener)

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

Parámetros
objeto de escucha La devolución de llamada que se invoca Para desactivar la devolución de llamada, usa null. No actualices ni animes la cámara desde onCameraMoveCanceled().

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

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

Parámetros
objeto de escucha La devolución de llamada que se invoca Para desactivar la devolución de llamada, usa null.

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

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

Parámetros
objeto de escucha La devolución de llamada que se invoca Para desactivar la devolución de llamada, usa null. No actualices ni animes la cámara desde onCameraMoveStarted().

público público 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.

público público setOnGroundOverlayClickListener (objeto de escucha 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 (objeto de escucha de GoogleMap.OnIndoorStateChangeListener)

Establece o borra el objeto de escucha para eventos en 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 receptor de eventos en interiores si no es nulo; de lo contrario, borra al receptor

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

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

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

void público setOnInfoWindowCloseListener (objeto de escucha de GoogleMap.OnInfoWindowCloseListener)

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.

público público setOnInfoWindowLongClickListener (objeto de escucha de GoogleMap.OnInfoWindowLongClickListener)

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.

público público 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.

público void setOnMapLoadedCallback (devolución de llamada GoogleMap.OnMapLoadedCallback)

Establece una devolución de llamada que se invoca cuando finaliza la renderización de este mapa. La devolución de llamada solo se invocará una vez.

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

Parámetros
callback Es la devolución de llamada invocada cuando se termina de renderizar el mapa. Para desactivar la devolución de llamada, usa null.

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

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

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.

público público setOnMarkerClickListener (objeto de escucha de 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.

void público 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 del marcador. Para desactivar la devolución de llamada, usa null.

público público setOnMyLocationButtonClickListener (objeto de escucha de GoogleMap.OnMyLocationButtonClickListener)

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

Si listener muestra true, el evento se consume y no se producirá 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.

público 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 una mejor búsqueda de ubicación y consumo de energía, y lo usa el punto azul "Mi ubicación". Consulta MyLocationDemoActivity en la carpeta de aplicaciones de ejemplo para ver el código de ejemplo, o la Guía para desarrolladores de ubicaciones.

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 de Mi ubicación.

público público setOnMyLocationClickListener (objeto de escucha de GoogleMap.OnMyLocationClickListener)

Configura una devolución de llamada que se invoca cuando se hace clic en el punto Mi ubicación (que representa 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 Mi ubicación.

público público setOnPoiClickListener (objeto de escucha de GoogleMap.OnPoiClickListener)

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

Pasa null para borrar el objeto de escucha.

Parámetros
objeto de escucha

público 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.

público público 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.

público público setPadding (int left, int top, int right, int low)

Configura el padding en el mapa.

Este método te permite definir una región visible en el mapa para indicarle que partes del mapa alrededor de los bordes pueden quedar oscurecidas. Para ello, debes establecer un padding en cada uno de los cuatro bordes del mapa. 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 se ajusten a la región definida; los movimientos de la cámara dependerán del centro de la región visible, etcétera.

Parámetros
izquierda el número de píxeles de relleno que se agregará a la izquierda del mapa.
superior la cantidad de píxeles de relleno que se agregarán en la parte superior del mapa.
derecha el número de píxeles de relleno que se agregará a la derecha del mapa.
inferior la cantidad de píxeles de relleno que se agregarán en la parte inferior del mapa.

public void setTrafficEnabled (boolean enabled)

Activa o desactiva la capa de tráfico.

Parámetros
habilitado

público público instantánea (devolución de llamada GoogleMap.SnapshotReadyCallback)

Toma una instantánea del mapa.

Puedes usar instantáneas dentro de tu aplicación cuando un mapa interactivo resulta 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: No se deben transmitir imágenes del mapa a tus servidores ni usarse 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
callback Método de devolución de llamada invocado cuando se toma la instantánea.

público void instantánea (devolución de llamada GoogleMap.SnapshotReadyCallback, mapa de bits de 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 de bits que sí coincida con las dimensiones del mapa.

Aunque en la mayoría de los casos el objeto que pasa el método de devolución de llamada es el mismo que el proporcionado en el parámetro de este método, en algunos casos, el objeto que se muestra puede ser diferente (p.ej., si las dimensiones de la vista cambiaron en el momento en que 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
callback Método de devolución de llamada invocado cuando se toma la instantánea.
mapa de bits Es un mapa de bits preasignado. Si es null, se comporta como snapshot(SnapshotReadyCallback).

público void stopAnimation ()

Detiene la animación de la cámara si hay una en curso. Cuando se lo llama, la cámara deja de moverse inmediatamente y permanece en esa posición.