Tratar erros

Este guia descreve como solucionar 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 de API com erros de digitação ou um token de viagem expirado na resposta CreateTrip inicial.

Se o status permanecer NEW, o dispositivo do motorista poderá impedir a autenticação. Como o Navigation Connect não envia mensagens de erro para esses 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 acessíveis por estrada.
  • Se a sessão não for autenticada, verifique se há parâmetros de API com erros de digitação ou um token de viagem expirado na resposta CreateTrip.
  • Se o status permanecer NEW depois de verificar os cenários acima, peça ao motorista para ativar a localização precisa e aceitar o aviso de consentimento no Google Maps ou no Waze.
  • Se o motorista estiver no modo de navegação anônima no Google Maps, o app vai mostrar um erro e a sessão não será iniciada. Peça ao motorista para desativar o modo de navegação anônima.

Status FAILED ou CLIENT_ERROR recebido 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 pessoais da viagem. Verifique as seguintes causas:

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

Nenhuma outra atualização de viagem recebida

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

  • O Google Maps ou o Waze foram fechados 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, o seguinte poderá 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 localização precisa de satélites 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.