Wenn Sie die folgenden Vorlagen verwenden, können Sie Nutzern die Interaktion mit den von Ihnen gezeichneten Karten ermöglichen, z. B. durch Zoomen und Schwenken.
| Vorlage | Unterstützung von API-Levels für Auto-Apps |
|---|---|
NavigationTemplate |
2 |
(eingestellt) |
4 |
(eingestellt) |
4 |
(eingestellt) |
5 (Vorlage eingeführt) |
MapWithContentTemplate |
7 (Vorlage eingeführt) |
Interaktivitäts-Callbacks implementieren
Die SurfaceCallback-Schnittstelle enthält mehrere Callback-Methoden, die Sie implementieren können, um Karten, die mit den Vorlagen im vorherigen Abschnitt erstellt wurden, interaktiver zu gestalten:
| Interaktion | Methode | Unterstützung von API-Levels für Auto-Apps |
|---|---|---|
| Tippen | onClick |
5 |
| Zum Zoomen auseinander- und zusammenziehen | onScale |
2 |
| Ziehen mit einem Finger | onScroll |
2 |
| Übertragung durch einmaliges Tippen | onFling |
2 |
| Doppeltippen |
(template host determines scale factor) |
2 |
| Drehbewegung im Schwenkmodus |
(Vorlagenhost bestimmt den Distanzfaktor) |
2 |
Kartenaktionsleiste hinzufügen
Diese Vorlagen können eine Kartenaktionsleiste für kartenbezogene Aktionen wie das Ein- und Auszoomen, das Zentrieren, das Anzeigen eines Kompasses und andere Aktionen enthalten, die Sie anzeigen möchten. Der Kartenaktionsbereich kann bis zu vier Schaltflächen nur mit Symbolen enthalten, die aktualisiert werden können, ohne die Tiefe der Aufgabe zu beeinträchtigen. Die Aktionsleiste wird im Leerlauf ausgeblendet und im aktiven Zustand wieder eingeblendet.
Wenn Sie Interaktivitäts-Callbacks für Karten erhalten möchten, müssen Sie der Aktionsleiste der Karte eine Action.PAN-Schaltfläche hinzufügen. Wenn der Nutzer auf die Schaltfläche Schwenken drückt, wechselt der Host in den Schwenkmodus, wie unter Schwenkmodus beschrieben.
Wenn Ihre App die Schaltfläche Action.PAN im Kartenaktionsbereich nicht enthält, empfängt sie keine Nutzereingaben über die SurfaceCallback-Methoden und der Host schließt alle zuvor aktivierten Schwenkmodi.
Auf einem Touchscreen wird die Schaltfläche Schwenken nicht angezeigt.
Informationen zum Schwenkmodus
Im Schwenkmodus übersetzt der Vorlagenhost Nutzereingaben von Nicht-Touch-Eingabegeräten wie Drehreglern und Touchpads in die entsprechenden SurfaceCallback-Methoden. Reagieren Sie mit der Methode setPanModeListener in NavigationTemplate.Builder auf die Nutzeraktion zum Aufrufen oder Beenden des Schwenkmodus.
Der Host kann andere UI-Komponenten in der Vorlage ausblenden, während sich der Nutzer im Schwenkmodus befindet.