Quando utilizzi i seguenti modelli, puoi aggiungere il supporto per l'interazione degli utenti con le mappe che disegni, ad esempio consentendo loro di vedere diverse parti di una mappa tramite zoom e panoramica.
| Modello | Supporto del livello API Car App |
|---|---|
NavigationTemplate |
2 |
(obsoleto) |
4 |
(obsoleto) |
4 |
(obsoleto) |
5 (modello introdotto) |
MapWithContentTemplate |
7 (modello introdotto) |
Implementare i callback di interattività
L'interfaccia SurfaceCallback ha diversi metodi di callback che puoi implementare per aggiungere interattività alle mappe create con i modelli nella sezione precedente:
| Interazione | Metodo | Supporto del livello API Car App |
|---|---|---|
| Tocca | onClick |
5 |
| Pizzica per eseguire lo zoom | onScale |
2 |
| Trascinamento con un solo tocco | onScroll |
2 |
| Trasferimento con un solo tocco | onFling |
2 |
| Tocca due volte |
(l'host del modello determina il fattore di scala) |
2 |
| Rotary nudge in modalità panoramica |
(l'host del modello determina il fattore di distanza) |
2 |
Aggiungere una striscia di azioni della mappa
Questi modelli possono avere una barra delle azioni della mappa per azioni correlate alla mappa, come ingrandire e ridurre, ricentrare, visualizzare una bussola e altre azioni che scegli di visualizzare. La barra delle azioni della mappa può contenere fino a quattro pulsanti solo con icone che possono essere aggiornati senza influire sulla profondità dell'attività. La striscia delle azioni è nascosta nello stato di inattività e riappare nello stato attivo.
Per ricevere callback di interattività della mappa, devi aggiungere un pulsante Action.PAN
nella barra delle azioni della mappa. Quando l'utente preme il pulsante Panoramica, l'organizzatore entra in modalità panoramica, come descritto in Informazioni sulla modalità panoramica.
Se la tua app omette il pulsante Action.PAN nella barra delle azioni della mappa, non riceve l'input dell'utente dai metodi SurfaceCallback e l'host chiude qualsiasi modalità di panoramica attivata in precedenza.
Su un touchscreen, il pulsante Panoramica non viene visualizzato.
Informazioni sulla modalità panoramica
In modalità panoramica, l'host del modello traduce l'input dell'utente da dispositivi di input non touch, come controller rotativi e touchpad, nei metodi di
SurfaceCallback appropriati. Rispondi all'azione dell'utente per attivare o disattivare la modalità panoramica
con il metodo setPanModeListener in NavigationTemplate.Builder.
L'host può nascondere altri componenti dell'interfaccia utente nel modello mentre l'utente è in modalità
panoramica.