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, conclua as seguintes 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 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 local e horário previsto de chegada, ao servidor de back-end.

Versões de apps compatíveis

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

Local exato ativado

Peça para o motorista 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 exige o 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 processam 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 dados de localização em tempo real e ETA com seu back-end.
  • Se o motorista tocar em Não permitir ou revogar o consentimento depois, 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 na nuvem do Google.