Visão geral e requisitos da configuração

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:

  1. Criar e configurar um projeto do Google Cloud.
  2. Ative a API Navigation Connect e verifique seu app.
  3. Configure o OAuth para criar tokens OAuth.
  4. 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.

Caixa de diálogo de 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_ERROR no 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.