Ventanas de información

Selecciona la plataforma: Android iOS JavaScript

Una ventana de información que aparece sobre un marcador.

Las ventanas de información te permiten mostrarle información a un usuario cuando este presiona un marcador.

Las ventanas de información siempre se dibujan respecto de la pantalla del dispositivo, centradas encima del marcador asociado. La ventana de información predeterminada contiene el título en negrita y, abajo, el texto del fragmento de código.

El contenido de la ventana de información se define mediante las propiedades title y snippet del marcador. Si haces clic en el marcador, no se mostrará una ventana de información si las propiedades title y snippet están en blanco o son nil.

Solo se muestra una ventana de información a la vez. Si un usuario presiona otro marcador, se ocultará la ventana actual y se abrirá la nueva ventana de información. Si el usuario hace clic en un marcador que actualmente muestra una ventana de información, se cerrará y se volverá a abrir esa misma ventana.

Crea una ventana de información personalizada para agregar texto o imágenes adicionales. Una ventana de información personalizada te brinda control total sobre la apariencia de la ventana emergente.

Agrega una ventana de información

El siguiente fragmento crea un marcador simple con solo un título para el texto de la ventana de información.

Swift

let position = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127)
let london = GMSMarker(position: position)
london.title = "London"
london.map = mapView

Objective-C

CLLocationCoordinate2D position = CLLocationCoordinate2DMake(51.5, -0.127);
GMSMarker *london = [GMSMarker markerWithPosition:position];
london.title = @"London";
london.map = mapView;

Con la propiedad snippet, puedes agregar texto adicional que aparecerá debajo del título con una fuente más pequeña. Las cadenas que son más largas que el ancho de la ventana de información se ajustan automáticamente en varias líneas. Es posible que se trunquen los mensajes muy largos.

Swift

london.title = "London"
london.snippet = "Population: 8,174,100"
london.map = mapView

Objective-C

london.title = @"London";
london.snippet = @"Population: 8,174,100";
london.map = mapView;

Oculta o muestra una ventana de información

Las ventanas de información están diseñadas para responder a eventos táctiles del usuario en el marcador. Puedes mostrar u ocultar una ventana de información de manera programática si configuras la selectedMarker propiedad de GMSMapView:

  • Configura selectedMarker con el nombre del marcador para mostrarlo.
  • Configura selectedMarker como nil para ocultarlo.

Swift

london.title = "London"
london.snippet = "Population: 8,174,100"
london.map = mapView
// Show marker
mapView.selectedMarker = london
// Hide marker
mapView.selectedMarker = nil

Objective-C

london.title = @"London";
london.snippet = @"Population: 8,174,100";
london.map = mapView;
// Show marker
mapView.selectedMarker = london;
// Hide marker
mapView.selectedMarker = nil;

Configura una ventana de información para que se actualice automáticamente

Configura tracksInfoWindowChanges en el marcador como YES o true si quieres que las propiedades nuevas o el contenido de la ventana de información se muestren de inmediato cuando se cambien, en lugar de tener que esperar a que la ventana de información se oculte y luego se vuelva a mostrar. El valor predeterminado es NO o false.

Swift

london.tracksInfoWindowChanges = true

Objective-C

london.tracksInfoWindowChanges = YES;

Para decidir cuándo configurar la propiedad tracksInfoWindowChanges, debes sopesar las consideraciones de rendimiento con las ventajas de que la ventana de información se vuelva a dibujar automáticamente. Por ejemplo:

  • Si tienes una serie de cambios que realizar, puedes cambiar la propiedad a YES y luego volver a NO.
  • Cuando se ejecuta una animación o se carga el contenido de forma asíncrona, debes mantener la propiedad configurada como YES hasta que se completen las acciones.

Consulta también las notas que debes tener en cuenta cuando usas la propiedad iconView del marcador.

Cambia la posición de una ventana de información

Las ventanas de información siempre se dibujan respecto de la pantalla del dispositivo, centradas encima del marcador asociado. Puedes modificar la posición de la ventana de información en relación con el marcador si configuras la propiedad infoWindowAnchor. Esta propiedad acepta un CGPoint, definido como un desplazamiento (x,y) en el que tanto x como y varían entre 0.0 y 1.0. El desplazamiento predeterminado es (0.5, 0.0), es decir, la parte superior central. Configurar el desplazamiento infoWindowAnchor es útil para alinear la ventana de información con un ícono personalizado.

Swift

london.infoWindowAnchor = CGPoint(x: 0.5, y: 0.5)
london.icon = UIImage(named: "house")
london.map = mapView

Objective-C

london.infoWindowAnchor = CGPointMake(0.5, 0.5);
london.icon = [UIImage imageNamed:@"house"];
london.map = mapView;

Administra eventos en ventanas de información

Puedes escuchar los siguientes eventos de la ventana de información:

Para escuchar eventos, debes implementar el GMSMapViewDelegate protocolo. Consulta la guía sobre eventos y la lista de métodos en el GMSMapViewDelegate.

GitHub incluye muestras que muestran cómo administrar eventos de la ventana de información:

Ventanas de información personalizadas

Para personalizar el contenido de las ventanas de información, crea una subclase de UIView que defina el diseño de la ventana de información personalizada. En esa subclase, define la vista como quieras. Por ejemplo, puedes usar instancias personalizadas UILabel para mostrar el título y el texto del fragmento de código, y otras vistas, como UIImageView instancias, para agregar imágenes que se muestran en la ventana de información.

Asegúrate de que tu ViewController implemente el GMSIndoorDisplayDelegate protocolo y defina un objeto de escucha para el evento mapView:markerInfoWindow:. Se llama a este objeto de escucha de eventos cuando un marcador está a punto de seleccionarse, y te permite mostrar una instancia de tu clase UIView personalizada para definir la ventana de información personalizada que usa el marcador.

En las siguientes imágenes, se muestran tres ventanas de información: una predeterminada, otra con contenido personalizado y otra con el marco y el fondo personalizados.

Comparación de las distintas ventanas de información

Las muestras de código en GitHub que se proporcionan con el SDK de Maps para iOS incluyen ejemplos de ventanas de información personalizadas. Por ejemplo, consulta la definición de MarkerInfoWindowViewController.m (Objective-C) o MarkerInfoWindowViewController.swift (Swift).

Consulta las muestras de código para obtener información sobre cómo descargar y ejecutar estas muestras.