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 pelos motoristas aos seus sistemas empresariais. Ele usa tokens de autorização de viagem com um link direto no seu app para que o motorista possa tocar em um link ou botão e iniciar a navegação no aplicativo para o consumidor que preferir. 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 no seu app. Ela vincula com segurança a sessão do motorista ao seu back-end. Quando um motorista inicia uma viagem, ele vê a interface de navegação conhecida com duas adições: uma solicitação de consentimento para compartilhar dados da viagem (obrigatória a cada 12 meses) e um botão "Voltar" com marca para retornar ao seu app.

Por que usar a API Navigation Connect?

Com a API Navigation Connect, é possível integrar a localização da viagem em tempo real e as atualizações de ETA do Google Maps ou do Waze diretamente aos 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 produtos ou alimentos com base em dados de trânsito e rotas em tempo real.
  • Melhorar o gerenciamento e a expedição de frotas:tome decisões de expedição informadas para frotas ou equipes móveis que oferecem 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.

  • Acompanhar viagens de forma não invasiva:acompanhe as 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 as localizações dos motoristas em tempo real, as distâncias restantes e o tempo decorrido continuamente durante uma viagem.
  • Monitorar os ciclos de vida das viagens:configure a frequência de atualização dos dados de viagem 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 tecnologia dos algoritmos de roteamento em tempo real do Google.
  • Acompanhar o restante do trajeto e o trânsito:receba a polilinha do restante do trajeto e as condições de trânsito em tempo real do local atual do motorista até o destino final, exatamente como aparece no Google Maps ou no Waze. Esse recurso aciona a SKU do Navigation Connect Enterprise.
    • Corte dinâmico:conforme o veículo se move, o Navigation Connect corta automaticamente a polilinha da rota ativa do motorista (a rota completa percorrida no app) para garantir que você receba apenas a rota restante (o segmento da posição atual do motorista até o destino).
    • Frequência de atualização:as condições de rota e trânsito são atualizadas automaticamente quando a rota é recalculada, quando o cliente traça um novo trajeto de forma proativa no lado do cliente ou quando as condições de trânsito mudam.
  • Rastrear desvios de rota (somente no Waze): detecte quando um motorista sai da rota, identifique o local e o horário exatos do desvio e determine se ele foi iniciado pelo motorista (por exemplo, uma conversão errada) ou pelo sistema (por exemplo, um novo trajeto para evitar o trânsito). Esse recurso aciona a SKU do Navigation Connect Enterprise.
  • Ingerir dados de forma flexível:consuma dados de viagens em tempo real usando chamadas diretas da API REST ou transmita atualizações de forma 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 aplicativo móvel 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 localização, ETA e distância restante.

Recursos

A tabela a seguir resume os recursos disponíveis na API Navigation Connect, além dos 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 extração ou envio 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 Processar dados de viagem.

Como usar a API Navigation Connect

1 Configurar Comece com Configurar seu projeto do Google Cloud e siga as instruções.
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 de 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.