Ao usar os modelos a seguir, você pode adicionar suporte para que os usuários interajam com os mapas que você desenha, como permitir que eles vejam diferentes partes de um mapa usando zoom e movimento.
| Modelo | Suporte a níveis da API Car App |
|---|---|
NavigationTemplate |
2 |
(uso suspenso) |
4 |
(uso suspenso) |
4 |
(uso suspenso) |
5 (modelo apresentado) |
MapWithContentTemplate |
7 (modelo apresentado) |
Implementar callbacks de interatividade
A interface SurfaceCallback tem vários métodos de callback que podem ser
implementados para adicionar interatividade aos mapas criados com os modelos na seção
anterior:
| Interação | Método | Suporte a níveis da API Car App |
|---|---|---|
| Toque | onClick |
5 |
| Fazer gesto de pinça para aplicar zoom | onScale |
2 |
| Arrastar com um único toque | onScroll |
2 |
| Deslizar rapidamente com um único toque | onFling |
2 |
| Tocar duas vezes |
(o host do modelo determina o fator de escalonamento) |
2 |
| Alerta giratório no modo "Movimentar" |
(o host do modelo determina o fator de distância) |
2 |
Adicionar uma faixa de ações no mapa
Esses modelos podem ter uma faixa de ações no mapa para ações relacionadas a ele, como aumentar e diminuir o zoom, recentralizar, exibir uma bússola e outras ações que você escolher mostrar. A faixa de ações no mapa pode ter até quatro botões somente de ícones que podem ser atualizados sem afetar a profundidade da tarefa. A faixa de ações fica oculta no estado inativo e reaparece no estado ativo.
Para receber callbacks de interatividade do mapa, adicione um botão Action.PAN
à faixa de ações do mapa. Quando o usuário pressiona o botão Movimentar, o
host entra no modo de movimentação, conforme descrito em Entender o modo de movimentação.
Se o app omitir o botão Action.PAN na faixa de ações, ele não vai
receber entradas do usuário dos métodos SurfaceCallback, e o host vai fechar qualquer
modo de movimentação ativado anteriormente.
Em uma tela touchscreen, o botão Movimentar não é exibido.
Entenda o modo panorâmico
No modo de movimentação, o host do modelo converte a entrada do usuário de
dispositivos de entrada sem toque, como controles giratórios e touchpads, em métodos
SurfaceCallback adequados. Responda à ação do usuário para entrar ou sair do modo de movimentação
com o método setPanModeListener no NavigationTemplate.Builder.
O host pode ocultar outros componentes de interface no modelo enquanto o usuário está no modo de movimentação.