Visão geral da API Navigation Connect

Desenvolvedores do Espaço Econômico Europeu (EEE)

A API Navigation Connect é um serviço que conecta o uso da navegação do Google Maps e do Waze pelo motorista aos seus sistemas empresariais. Ele usa tokens de autorização de viagem e um link direto no app para que o motorista possa tocar em um link ou botão e iniciar a navegação no aplicativo para o consumidor de sua escolha. Enquanto o motorista navega na viagem, você pode receber dados de localização em tempo real, como locais em tempo real, ETAs altamente precisos e status do ciclo de vida da viagem.

A API Navigation Connect oferece uma alternativa leve ao SDK Navigation usando os apps autônomos Google Maps e Waze para rotas, em vez de exigir que você crie e incorpore uma interface de navegação personalizada ao seu app. Ela vincula com segurança a sessão do motorista ao seu back-end. Quando um motorista inicia uma viagem, ele usa a interface de navegação familiar com duas adições: um pedido de permissão para compartilhar dados de viagem (necessário a cada 12 meses) e um botão de retorno com marca para voltar ao seu app.

Por que usar a API Navigation Connect

Com a API Navigation Connect, você pode integrar a localização da viagem em tempo real e as atualizações de ETA do Google Maps ou do Waze diretamente aos seus processos de back-end. Isso ajuda você a tomar decisões de negócios importantes e compartilhar atualizações precisas com seus clientes, enquanto os motoristas usam o app de navegação preferido, o Google Maps ou o Waze.

Exemplos de casos de uso:

  • Aumentar a transparência do transporte por aplicativo:ofereça aos clientes e passageiros atualizações precisas e em tempo real sobre a localização do motorista e os horários de chegada estimados.
  • Melhorar o rastreamento de entregas:informe aos clientes os horários precisos de entrega de alimentos ou de envio com base em dados de trânsito em tempo real e roteamento.
  • Melhorar o gerenciamento e o envio de frotas:tome decisões de envio informadas para frotas ou equipes móveis que prestam serviços sob demanda (como assistência em caso de avaria, manutenção ou transporte) rastreando a localização dos motoristas em tempo real.

O que você pode fazer com a API Navigation Connect

Com a API Navigation Connect, você recebe atualizações de localização em tempo real e HEC do Google Maps ou do Waze diretamente no seu back-end.

  • Rastrear viagens de forma não intrusiva:rastreie viagens sem mudar a escolha do motorista de usar o Google Maps ou o Waze nem modificar a experiência do usuário.
  • Acessar dados de localização em tempo real:obtenha localizações de motoristas, distâncias restantes e tempo decorrido em tempo real durante toda uma viagem.
  • Monitore os ciclos de vida das viagens:configure a frequência de atualização dos dados para acompanhar o status exato de uma viagem e saber imediatamente quando um motorista está a caminho, chegou ou suspendeu uma viagem.
  • Consumir e compartilhar HECs:receba atualizações de HEC altamente precisas com base nos algoritmos de roteamento em tempo real do Google.
  • Acompanhar o trajeto restante e o trânsito (somente no Waze): receba a polilinha do trajeto ativo e as condições de trânsito em tempo real do local atual do motorista até o destino final, exatamente como mostrado no Waze.
    • Corte dinâmico:conforme o veículo se move, o Navigation Connect corta automaticamente a polilinha da rota ativa para garantir que você receba apenas a parte restante da viagem.
    • Frequência de atualização:as condições de rota e trânsito são atualizadas automaticamente quando a rota é recalculada, quando há um redirecionamento proativo do lado do cliente ou quando as condições de trânsito mudam.
  • Ingerir dados de maneira flexível:consuma dados de viagens em tempo real usando chamadas diretas da API REST ou transmita atualizações de maneira eficiente usando assinaturas do Google Cloud Pub/Sub.

Como a API Navigation Connect funciona

A API Navigation Connect aceita uma solicitação CreateTrip que contém os identificadores do seu aplicativo para dispositivos móveis e a configuração da sessão. O serviço gera uma instância de viagem exclusiva e retorna um token de viagem. Esse token é anexado a um link direto do Google Maps ou do Waze. Depois que o motorista inicia a navegação e dá consentimento, o serviço processa dados de navegação em tempo real e retorna atualizações de telemetria, incluindo local, ETA e distância restante.

Recursos

A tabela a seguir resume os recursos disponíveis na API Navigation Connect e os dados que ela retorna. Para detalhes específicos, consulte a referência da API Navigation Connect.

Recursos de dados Dados retornados

Autenticação e identificadores de apps para dispositivos móveis no formato JSON.

Consulte Criar uma viagem.

Um token de viagem exclusivo usado para inicializar a conexão no Google Maps ou no Waze.

Consulte Iniciar o Google Maps ou o Waze.

O ID exclusivo da viagem e um método de pull ou push no formato JSON.

Consulte Recuperar dados de viagem.

Telemetria de viagem em tempo real, incluindo:

  • Status e metadados da viagem
  • Local atual (lat/lng)
  • Horário previsto de chegada (HEC)
  • Distância e tempo restantes

Consulte Tratar dados de viagem.

Como usar a API Navigation Connect

1 Começar a configurar Comece com Configurar seu projeto do Google Cloud e siga as instruções abaixo.
2 Criar uma viagem Envie uma chamada de API Navigation Connect para criar uma viagem com um ID exclusivo e salve o token.
3 Abra o Google Maps ou o Waze. Transmita o token de viagem e inicie o Google Maps ou o Waze para ativar o compartilhamento de dados pessoais.
4 Recuperar dados da viagem Envie uma chamada de API Navigation Connect para recuperar dados da viagem. Se quiser, inscreva-se para receber atualizações usando o Google Cloud Pub/Sub.
5 Processar os dados da viagem Entenda como processar o status e outros dados da viagem.