.
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 | |
GroundOverlay | |
Marker | |
Polygon | |
Polyline | |
TileOverlay | |
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 | |
boolean | |
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 |
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) .
|
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 | |
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.
público estático final int MAP_TYPE_NONE
No hay mosaicos de mapa base.
público estático final int MAP_TYPE_NORMAL
Mapas básicos
público estático final int MAP_TYPE_SATELLITE
Mapas satelitales sin etiquetas.
público estático final int MAP_TYPE_TERRAIN
Mapas de terreno.
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
- El
GroundOverlay
que se agregó al mapa.
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
- El
TileOverlay
que se agregó al mapa.
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
- Es la
user location
que se muestra actualmente.
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
- El
Projection
del mapa en su estado actual.
public UiSettings getUiSettings ()
Obtiene la configuración de la interfaz de usuario del mapa.
Devuelve
- El
UiSettings
de este mapa.
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 conMapStyleOptions
, 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 esfalse
, 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:
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 mapa base.
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.