Neste documento, explicamos o processo de configuração da API Navigation Connect e listamos os requisitos do dispositivo do motorista para usar a API Navigation Connect.
Processo de configuração do Navigation Connect
Antes de usar a API Navigation Connect, conclua as seguintes etapas de configuração:
- Criar e configurar um projeto do Google Cloud.
- Ative a API Navigation Connect e verifique seu app.
- Configure o OAuth para criar tokens OAuth.
- Configure sua conta de serviço para permitir a comunicação entre sua infraestrutura de back-end e o Google Maps ou o Waze.
Requisitos mínimos do dispositivo para usar o Navigation Connect
Esses requisitos são necessários para que o dispositivo do motorista execute uma sessão do Navigation Connect. Uma sessão usa a API Navigation Connect para enviar dados de viagem em tempo real, como localização e horário previsto de chegada, ao seu servidor de back-end.
Versões compatíveis do app
O dispositivo precisa ter o Waze ou o Google Maps para Android instalado. A tabela a seguir lista a versão mínima de cada app para o Navigation Connect e para recursos que precisam de uma versão mais recente.
| App | Versão mínima | Relatório de rota restante | Relatórios de desvio de rota |
|---|---|---|---|
| Waze para Android | 5.15.5 | 5.20.0.2 | 5.22 |
| Waze para iOS | 5.15.5 | 5.20.0.1 | 5.22 |
| Google Maps para Android | 26.14 | 26,27 | Sem suporte |
Local exato ativado
Peça ao motorista para ativar as permissões de localização exata no dispositivo. O Waze e o Google Maps exigem o local exato para iniciar a navegação.
Consentimento do motorista
O Navigation Connect precisa do consentimento do motorista para compartilhar dados da viagem. Não é necessário acionar a caixa de diálogo de consentimento. O Google Maps ou o Waze processa automaticamente essa interface do usuário.
Na primeira viagem iniciada no seu app, o Google Maps ou o Waze pede que o motorista compartilhe os dados da viagem.
- Se o motorista tocar em Permitir, o Navigation Connect vai começar a compartilhar a localização em tempo real e os dados de HEC com seu back-end.
- Se o motorista tocar em Não permitir ou revogar o consentimento mais tarde, o Google Maps ou o Waze
vai fornecer navegação guiada, mas o Navigation Connect não vai enviar
dados. Seu back-end recebe um status
CLIENT_ERRORno payload de dados da viagem.
Os motoristas precisam confirmar esse consentimento a cada 12 meses.
A seguir
A primeira etapa para configurar a API Navigation Connect é criar e configurar um projeto do Google Cloud.