Visão geral e requisitos da configuração

Este documento explica o processo de configuração da API Navigation Connect e lista 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, siga estas etapas de configuração:

  1. Crie e configure 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 ativar a comunicação entre a 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 local e horário previsto de chegada, para o servidor de back-end.

Versões de apps com suporte

O dispositivo precisa ter a versão 5.15.5 ou mais recente do Waze ou a versão 26.14 ou mais recente do Google Maps instalada.

Local exato ativado

Peça ao motorista para ativar as permissões de local exato 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 exige o consentimento do motorista para compartilhar dados de viagem. Não é necessário acionar a caixa de diálogo de consentimento. O Google Maps ou o Waze processam essa interface do usuário automaticamente.

Na primeira viagem iniciada no seu app, o Google Maps ou o Waze pede ao motorista para compartilhar os dados da viagem.

  • Se o motorista tocar em Permitir, o Navigation Connect vai começar a compartilhar dados de localização em tempo real e HEC com o 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. O back-end vai receber 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.