Cuando uses las siguientes plantillas, puedes agregar compatibilidad para que los usuarios interactúen con los mapas que dibujes, por ejemplo, permitiéndoles ver diferentes partes de un mapa con el uso del zoom y el desplazamiento lateral.
| Plantilla | Compatibilidad con el nivel de API de la app para vehículos |
|---|---|
NavigationTemplate |
2 |
(obsoleto) |
4 |
(obsoleto) |
4 |
(obsoleto) |
5 (se introduce la plantilla) |
MapWithContentTemplate |
7 (se introdujo la plantilla) |
Implementa devoluciones de llamada de interactividad
La interfaz de SurfaceCallback tiene varios métodos de devolución de llamada que puedes implementar para agregar interactividad a los mapas compilados con las plantillas de la sección anterior:
| Interacción | Método | Compatibilidad con el nivel de API de la app para vehículos |
|---|---|---|
| Presionar | onClick |
5 |
| Pellizcar para acercar | onScale |
2 |
| Arrastrar con un toque | onScroll |
2 |
| Deslizar con un toque | onFling |
2 |
| Presionar dos veces |
(el host de la plantilla determina el factor de escala) |
2 |
| Rotar ligeramente en modo de desplazamiento lateral |
(el host de la plantilla determina el factor de distancia) |
2 |
Cómo agregar una barra de acciones en el mapa
Estas plantillas pueden tener una barra de acciones en mapa, como acercar y alejar la imagen, volver a centrar, mostrar una brújula y otras acciones que decidas mostrar. La barra de acciones del mapa puede contener hasta cuatro botones de ícono que pueden actualizarse sin afectar la profundidad de la tarea. La barra de acción se oculta cuando está en estado inactivo y vuelve a aparecer en el estado activo.
Para recibir devoluciones de llamada de interactividad con mapas, debes agregar un botón Action.PAN en la barra de acciones en mapa. Cuando el usuario presiona el botón Desplazamiento lateral, el host ingresa al modo de desplazamiento lateral, como se describe en Acerca del modo de desplazamiento lateral.
Si tu app omite el botón Action.PAN en la barra de acciones en mapa, no recibirá entradas del usuario de los métodos SurfaceCallback, por lo que el host cerrará el modo de desplazamiento lateral que se haya activado antes.
En una pantalla táctil, no se muestra el botón Desplazamiento lateral.
Información sobre el modo de desplazamiento lateral
En el modo de desplazamiento lateral, el host de la plantilla convierte la entrada del usuario proveniente de dispositivos de entrada no táctiles, como controladores rotativos y paneles táctiles, en los métodos SurfaceCallback correspondientes. Puedes responder a la acción del usuario de ingresar o salir del modo de desplazamiento lateral con el método setPanModeListener en el NavigationTemplate.Builder.
El host puede ocultar otros componentes de la IU en la plantilla mientras el usuario se encuentra en el modo de desplazamiento lateral.