Tratar erros

Este guia descreve como resolver erros de payload e problemas de feed de dados ao usar o Navigation Connect.

Nenhum status ENROUTE recebido

Se você não receber um status ENROUTE, provavelmente ocorreu um erro de autenticação. Verifique se há parâmetros da API com erros de ortografia ou um token de viagem expirado na resposta inicial de CreateTrip.

Se o status continuar NEW, o dispositivo do motorista poderá impedir a autenticação. Como o Navigation Connect não envia mensagens de erro nesses casos, verifique os seguintes cenários:

  • Se o app de navegação não encontrar o destino, confirme se você transmitiu um destino válido no URL de inicialização.
  • Se não houver uma rota válida, verifique se a origem e o destino estão corretos e podem ser alcançados por via terrestre.
  • Se a autenticação da sessão falhar, verifique se há parâmetros da API com erros de ortografia ou um token de viagem expirado na resposta CreateTrip.
  • Se o status continuar NEW depois de verificar os cenários acima, peça para o motorista ativar o local exato e aceitar a solicitação de consentimento no Google Maps ou no Waze.
  • Se o motorista estiver no modo de navegação anônima do Google Maps, o app vai mostrar um erro e a sessão não será iniciada. Peça para o motorista desativar o modo de navegação anônima.

Recebeu o status FAILED ou CLIENT_ERROR no início da viagem

Se o status mudar para FAILED ou CLIENT_ERROR quando o motorista iniciar uma viagem, algo bloqueou o compartilhamento de dados da viagem. Verifique as seguintes causas:

  • Problemas de conectividade do driver.
  • O motorista está usando o Android Auto ou o Apple CarPlay.
  • O motorista não aceitou ou revogou o consentimento.
  • Problemas com a autenticação do motorista.
  • O motorista iniciou uma viagem nos Estados Unidos, mas o compartilhamento de dados pessoais de viagens nos Estados Unidos não está ativado no seu app.

Nenhuma outra atualização de viagem foi recebida

Se o tópico do Google Cloud Pub/Sub ou as chamadas de API GetTrip não receberem FAILED ou mais atualizações de viagem após ENROUTE, os seguintes problemas poderão causar a falta de atualizações de viagem:

  • O Google Maps ou o Waze fecham inesperadamente.
  • Problemas de conectividade de rede no smartphone do motorista.

Payload esperado não recebido

Se você não receber um payload esperado depois de verificar as etapas acima e confirmar que toda a configuração está correta, os seguintes fatores podem causar a falta de payloads:

  • Problemas de conectividade de rede podem causar a perda de payloads.
  • Sinal de GPS/GNSS ruim: a navegação requer uma localização precisa de satélites de GPS/GNSS. Isso pode não ser possível em estacionamentos subterrâneos, cânions urbanos ou túneis. A posição do dispositivo no veículo também pode afetar a qualidade do sinal.
  • Qualidade e idade do dispositivo: dispositivos mais antigos ou mais baratos podem ter chips de GPS de qualidade inferior, afetando a precisão dos relatórios de localização.