Lorsque vous utilisez les modèles suivants, vous pouvez permettre aux utilisateurs d'interagir avec les cartes que vous dessinez, par exemple en effectuant des zooms et en passant en mode panoramique afin d'en voir différentes parties.
| Template | Compatibilité avec le niveau d'API Car App |
|---|---|
NavigationTemplate |
2 |
(obsolète) |
4 |
(obsolète) |
4 |
(obsolète) |
5 (modèle présenté) |
MapWithContentTemplate |
7 (modèle introduit) |
Implémenter des rappels d'interactivité
L'interface SurfaceCallback dispose de plusieurs méthodes de rappel que vous pouvez implémenter pour ajouter de l'interactivité aux cartes créées avec les modèles de la section précédente :
| Interaction | Méthode | Compatibilité avec le niveau d'API Car App |
|---|---|---|
| Appuyer | onClick |
5 |
| Pincer pour zoomer | onScale |
2 |
| Faire glisser d'un simple geste | onScroll |
2 |
| Faire glisser d'un simple geste vif | onFling |
2 |
| Appuyer deux fois |
(l'hôte du modèle détermine le facteur de scaling) |
2 |
| Geste de rotation en mode panoramique |
(l'hôte du modèle détermine le facteur de distance) |
2 |
Ajouter une bande d'actions de la carte
Ces modèles peuvent comporter une bande d'actions pour les actions associées à la carte, telles que le zoom avant et arrière, le recentrage, l'affichage d'une boussole et toute autre action que vous choisissez d'afficher. La bande d'actions sur la carte peut comporter jusqu'à quatre boutons ne contenant qu'une icône, qui peuvent être actualisés sans affecter la profondeur de la tâche. La bande d'actions est masquée à l'état inactif et réapparaît à l'état actif.
Pour recevoir des rappels d'interactivité sur la carte, vous devez ajouter un bouton Action.PAN dans la bande d'actions de la carte. Lorsque l'utilisateur appuie sur le bouton Panoramique, l'hôte passe en mode panoramique, comme décrit dans Comprendre le mode panoramique.
Si votre application omet le bouton Action.PAN dans la bande d'actions de la carte, elle ne reçoit pas les entrées utilisateur provenant des méthodes SurfaceCallback, et l'hôte ferme tout mode panoramique précédemment activé.
Sur un écran tactile, le bouton Panoramique n'est pas affiché.
Comprendre le mode panoramique
En mode panoramique, l'hôte du modèle traduit les entrées utilisateur des appareils d'entrées non tactiles, tels que les contrôleurs rotatifs et les pavés tactiles dans les méthodes SurfaceCallback appropriées. Répondez à l'action de l'utilisateur visant à ouvrir ou quitter le mode panoramique à l'aide de la méthode setPanModeListener dans le NavigationTemplate.Builder.
L'hôte peut masquer d'autres composants d'interface utilisateur dans le modèle lorsque l'utilisateur est en mode panoramique.