Una finestra informativa ti consente di mostrare informazioni all'utente quando tocca un indicatore.
Viene disegnata una finestra informativa orientata rispetto allo schermo del dispositivo, centrata sopra l'indicatore associato. La finestra informativa predefinita contiene il titolo in grassetto, con il testo dello snippet sotto il titolo.
I contenuti della finestra informativa sono definiti dalle proprietà title
e
snippet
dell'indicatore. Se fai clic sull'indicatore non viene visualizzata una
finestra informativa se le proprietà title
e snippet
sono vuote o nil
.
Viene visualizzata una sola finestra informativa alla volta. Se un utente tocca un altro indicatore, la finestra corrente viene nascosta e si apre la nuova finestra informativa. Se l'utente fa clic su un indicatore che attualmente mostra una finestra informativa, questa si chiude e si riapre.
Crea una finestra informativa personalizzata per aggiungere testo o immagini. Una finestra informativa personalizzata ti offre il controllo completo sull'aspetto del popup.
Aggiungi una finestra informativa
Il seguente snippet crea un semplice indicatore con solo un titolo per il testo della finestra informativa.
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 proprietà snippet
, puoi aggiungere altro testo che verrà visualizzato sotto il titolo con un carattere più piccolo. Le stringhe che superano la larghezza della finestra informativa vengono aggregate automaticamente su più righe. I messaggi molto lunghi
potrebbero essere troncati.
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;
Mostra/nascondi una finestra informativa
Le finestre informative sono progettate per rispondere agli eventi di tocco dell'utente sull'indicatore.
Puoi mostrare o nascondere una finestra informativa in modo programmatico impostando la proprietà selectedMarker
di GMSMapView
:
- Imposta
selectedMarker
sul nome dell'indicatore per mostrarlo. - Imposta
selectedMarker
sunil
per nasconderlo.
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;
Impostazione di una finestra informativa per l'aggiornamento automatico
Imposta tracksInfoWindowChanges
dell'indicatore su YES
o true
se vuoi che le nuove proprietà o i contenuti della
finestra informativa vengano visualizzati immediatamente in caso di modifica, anziché dover attendere
che la finestra informativa si nasconda e poi venga mostrata di nuovo. Il valore predefinito è NO
o false
.
Swift
london.tracksInfoWindowChanges = true
Objective-C
london.tracksInfoWindowChanges = YES;
Per decidere quando impostare la proprietà tracksInfoWindowChanges
, devi ponderare le considerazioni sulle prestazioni rispetto ai vantaggi della riorganizzazione automatica della finestra informativa. Ad esempio:
- Se devi apportare una serie di modifiche, puoi impostare la proprietà su
YES
e poi di nuovo impostareNO
. - Quando un'animazione è in esecuzione o i contenuti vengono caricati in modo asincrono, devi mantenere la proprietà impostata su
YES
fino al completamento delle azioni.
Fai riferimento anche alle note da considerare quando utilizzi la proprietà iconView
dell'indicatore.
Modifica della posizione di una finestra informativa
La finestra informativa viene disegnata orientata rispetto allo schermo del dispositivo, centrata
sopra l'indicatore associato. Puoi modificare la posizione della finestra informativa
rispetto all'indicatore impostando la proprietà infoWindowAnchor
. Questa
proprietà accetta un valore CGPoint
, definito come offset (x,y) in cui sia x che y
sono compresi tra 0,0 e 1,0. L'offset predefinito è (0,5, 0,0), ovvero il centro in alto. L'impostazione dell'offset infoWindowAnchor
è utile per allineare la finestra informativa
con un'icona personalizzata.
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;
Gestione degli eventi nelle finestre informative
Puoi ascoltare i seguenti eventi nella finestra informativa:
mapView:markerInfoWindow:
: viene chiamato quando un indicatore sta per essere selezionato. Facoltativamente, puoi restituire una finestra informativa personalizzata, comeUIView
, da utilizzare per l'indicatore. Per ulteriori informazioni, consulta la sezione Finestre informative personalizzate di seguito.mapView:markerInfoContents:
— Richiamato semapView:markerInfoWindow
restituisce nil.mapView:didCloseInfoWindowOfMarker:
: viene chiamato quando la finestra informativa dell'indicatore è chiusa.mapView:didLongPressInfoWindowOfMarker:
— Richiamato dopo la pressione prolungata della finestra informativa di un indicatore.
Per ascoltare gli eventi, devi implementare il protocollo GMSMapViewDelegate
. Consulta la guida agli eventi e l'elenco dei metodi nella GMSMapViewDelegate
.
GitHub include esempi che mostrano come gestire gli eventi della finestra informativa:
Finestre informative personalizzate
Personalizza i contenuti delle finestre informative creando una sottoclasse di UIView
che definisce il layout della finestra informativa personalizzata. In questa sottoclasse, definisci
la vista come preferisci. Ad esempio, puoi utilizzare le istanze di UILabel
personalizzate per visualizzare il testo del titolo e degli snippet e altre visualizzazioni, come le istanze UIImageView
, per aggiungere immagini mostrate nella finestra informativa.
Assicurati che ViewController
implementi il protocollo
GMSIndoorDisplayDelegate
e definisca un listener per l'evento
mapView:markerInfoWindow:. Questo listener di eventi viene chiamato quando un indicatore sta per essere selezionato e ti consente di restituire un'istanza della tua classe UIView
personalizzata per definire la finestra informativa personalizzata utilizzata dall'indicatore.
Le immagini di seguito mostrano una finestra informativa predefinita, una finestra informativa con contenuti personalizzati e una finestra informativa con cornice e sfondo personalizzati.
Gli esempi di codice su GitHub forniti con Maps SDK for iOS includono esempi di finestre informative personalizzate. Ad esempio, consulta la definizione di MarkerInfoWindowViewController.m (Objective-C) o MarkerInfoWindowViewController.swift (Swift).
Consulta gli esempi di codice per informazioni su come scaricare ed eseguire questi esempi.