In einem Infofenster können Sie Informationen für den Nutzer einblenden lassen, wenn er auf eine Markierung tippt.
Infofenster werden am Gerätebildschirm ausgerichtet und über der zugehörigen Markierung zentriert. Das Standardinfofenster enthält den Titel in Fettdruck und darunter den Snippet-Text.
Der Inhalt des Infofensters wird durch die Eigenschaften title
und snippet
der Markierung definiert. Wenn die beiden Eigenschaften title
und snippet
leer sind oder nil
leer sind, wird kein Infofenster angezeigt, wenn Sie auf die Markierung klicken.
Es wird immer nur ein Infofenster gleichzeitig eingeblendet. Wenn ein Nutzer auf eine andere Markierung tippt, wird das aktuelle Fenster ausgeblendet und das neue Infofenster geöffnet. Klickt der Nutzer auf eine Markierung, zu der aktuell ein Infofenster angezeigt wird, wird es geschlossen und wieder geöffnet.
Erstellen Sie ein benutzerdefiniertes Infofenster, in das Sie zusätzlichen Text oder Bilder einfügen können. In einem benutzerdefinierten Infofenster können Sie die Darstellung des Pop-ups vollständig steuern.
Infofenster hinzufügen
Mit dem folgenden Snippet wird eine einfache Markierung erstellt, die nur einen Titel für den Text des Infofensters hat.
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;
Mit der Eigenschaft snippet
können Sie zusätzlichen Text hinzufügen, der in kleinerer Schriftart unter dem Titel angezeigt wird. Strings, die länger als die Breite des Infofensters sind, werden automatisch auf mehrere Zeilen umgebrochen. Sehr lange Nachrichten werden möglicherweise abgeschnitten.
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;
Infofenster ein-/ausblenden
Infofenster reagieren auf die Touch-Ereignisse der Markierung.
Sie können ein Infofenster programmatisch ein- oder ausblenden, indem Sie das Attribut selectedMarker
von GMSMapView
festlegen:
- Legen Sie für
selectedMarker
den Namen der Markierung fest, damit sie angezeigt wird. - Lege für
selectedMarker
den Wertnil
fest, um ihn auszublenden.
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;
Automatische Aktualisierung eines Infofensters festlegen
Legen Sie tracksInfoWindowChanges
für die Markierung auf YES
oder true
fest, wenn neue Eigenschaften oder der Inhalt des Infofensters nach der Änderung sofort angezeigt werden sollen. Sie müssen also nicht warten, bis das Infofenster aus- und wieder eingeblendet wird. Der Standardwert ist NO
oder false
.
Swift
london.tracksInfoWindowChanges = true
Objective-C
london.tracksInfoWindowChanges = YES;
Bei der Entscheidung, wann die Eigenschaft tracksInfoWindowChanges
festgelegt werden soll, sollten Sie die Leistung gegen die Vorteile einer automatischen Neuzeichnung des Infofensters abwägen. Beispiel:
- Wenn Sie eine Reihe von Änderungen vornehmen möchten, können Sie das Attribut in
YES
und dann wieder inNO
ändern. - Wenn eine Animation ausgeführt wird oder die Inhalte asynchron geladen werden, sollten Sie die Eigenschaft auf
YES
belassen, bis die Aktionen abgeschlossen sind.
Beachten Sie auch die Hinweise, wenn Sie die Eigenschaft iconView
der Markierung verwenden.
Position eines Infofensters ändern
Infofenster werden am Gerätebildschirm ausgerichtet und über der zugehörigen Markierung zentriert. Sie können die Position des Infofensters relativ zur Markierung ändern, indem Sie die Eigenschaft infoWindowAnchor
festlegen. Dieses Attribut akzeptiert ein CGPoint
-Element, das als (x, y)-Offset definiert ist, wobei x und y zwischen 0,0 und 1,0 liegen. Der Standardversatz ist (0,5, 0,0), das heißt die Mitte oben. Das Festlegen des Offsets infoWindowAnchor
ist nützlich, um das Infofenster an einem benutzerdefinierten Symbol auszurichten.
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;
Ereignisse in Infofenstern verarbeiten
Sie können auf die folgenden Infofensterereignisse warten:
mapView:markerInfoWindow:
: Wird aufgerufen, wenn eine Markierung ausgewählt wird. Optional kann ein benutzerdefiniertes Infofenster alsUIView
zurückgegeben werden, das für die Markierung verwendet wird. Weitere Informationen finden Sie unten im Abschnitt Benutzerdefinierte Infofenster.mapView:markerInfoContents:
: Wird aufgerufen, wennmapView:markerInfoWindow
„nil“ zurückgibt.mapView:didCloseInfoWindowOfMarker:
: Wird beim Schließen des Infofensters der Markierung aufgerufen.mapView:didLongPressInfoWindowOfMarker:
: Wird aufgerufen, nachdem das Infofenster einer Markierung lange gedrückt wurde.
Wenn Sie auf Ereignisse warten möchten, müssen Sie das GMSMapViewDelegate
-Protokoll implementieren. Weitere Informationen finden Sie im Leitfaden zu Ereignissen und in der Liste der Methoden in der GMSMapViewDelegate
.
GitHub enthält Beispiele, die zeigen, wie Infofensterereignisse verarbeitet werden:
Benutzerdefinierte Infofenster
Passen Sie den Inhalt von Infofenstern an. Erstellen Sie dazu eine abgeleitete Klasse von UIView
, die das Layout des benutzerdefinierten Infofensters definiert. Definieren Sie in dieser Unterklasse die Ansicht so, wie Sie möchten. Sie können beispielsweise benutzerdefinierte UILabel
-Instanzen verwenden, um Titel und Snippet-Text sowie andere Ansichten wie UIImageView
-Instanzen anzuzeigen und Bilder hinzuzufügen, die im Infofenster angezeigt werden.
In ViewController
muss das GMSIndoorDisplayDelegate
-Protokoll implementiert und ein Listener für das Ereignis mapView:markerInfoWindow: definiert sein. Dieser Event-Listener wird aufgerufen, wenn eine Markierung ausgewählt wird. Sie können damit eine Instanz Ihrer benutzerdefinierten UIView
-Klasse zurückgeben, um das von der Markierung verwendete benutzerdefinierte Infofenster zu definieren.
Die folgenden Bilder zeigen ein Standardinfofenster, ein Infofenster mit angepasstem Inhalt und ein Infofenster mit angepasstem Rahmen und Hintergrund.
Die Codebeispiele auf GitHub, die mit dem Maps SDK for iOS bereitgestellt werden, enthalten Beispiele für benutzerdefinierte Infofenster. Sehen Sie sich beispielsweise die Definition von MarkerInfoWindowViewController.m (Objective-C) oder MarkerInfoWindowViewController.swift (Swift) an.
Informationen zum Herunterladen und Ausführen dieser Beispiele finden Sie in den Codebeispielen.