Criar rotas usando tokens de ponto de navegação

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

Com os tokens de ponto de navegação, é possível enviar informações contextuais importantes sobre um destino para o SDK Navigation para Android, o SDK Navigation para iOS ou a API Routes e melhorar o trajeto e a experiência do motorista. Isso é útil em casos como entrega de comida ou transporte por aplicativo, em que o ponto de encontro ou desembarque pode ser ambíguo sem a entrada do usuário.

Para criar e transmitir um token de ponto de navegação, use o método Destinations da API Geocoding para permitir que seus usuários selecionem um local preferido em uma lista de pontos de navegação. A seleção do usuário se torna um ponto de navegação retornado pelo método Destinations da API Geocoding.

Em seguida, transmita o token do ponto de navegação, que contém as coordenadas de destino e informações contextuais, para o SDK Navigation para Android, o SDK Navigation para iOS ou a API Routes, em que um ponto de parada é criado para um trajeto preciso. O destino será destacado para o motorista pelo SDK Navigation com base no lugar associado ao token.

Exemplo: caso de uso de carona compartilhada

Visão geral

Este exemplo mostra como combinar a API Geocoding, a API Routes e o SDK Navigation para iOS ou Android e criar um app de carona compartilhada que calcula o preço da rota e direciona os motoristas para o ponto de encontro correto.

Estas são as etapas gerais:

  1. Recupere um token de ponto de navegação usando a API Geocoding.
  2. Use a API Routes para calcular um trajeto e codificá-lo em um token de trajeto.
  3. Transmita o token do ponto de navegação e o token da rota para o SDK do Navigation.
  4. Use o SDK Navigation para direcionar o motorista até o ponto de encontro correto.

Consulte a seção Leitura complementar para links da API Routes relevante, do SDK Navigation para iOS e do SDK Navigation para documentação do Android.

Este diagrama mostra como um app de carona ou entrega usaria a API Geocoding, a API Routes e o SDK Navigation para iOS ou Android para traçar a rota de um motorista usando um token de rota e um token de ponto de navegação:

Diagrama de caso de uso de carona compartilhada ou entrega
Diagrama de um caso de uso de transporte por aplicativo ou entrega

Exemplo de carona compartilhada

Imagine um cenário de carona compartilhada em que há um app para o consumidor reservar a viagem e um segundo app para o motorista receber notificações sobre a viagem e informações de roteamento até o destino.

Esta imagem mostra exemplos de um app de carona compartilhada para consumidores em que o ponto de navegação é selecionado e um app para motoristas usando o SDK Navigation para Android para traçar a rota do motorista com precisão.

Exemplos de apps para consumidores e motoristas

Quando um consumidor abre o aplicativo para o consumidor, o app chama o método Destinations da API Geocoding e oferece uma seleção de possíveis pontos de navegação:

Consumidor escolhendo um ponto de entrega

O usuário escolhe o ponto preferido, que é um na matriz de navigationPoints no corpo da resposta de uma solicitação SearchDestinations:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

O back-end do app fornece o token do ponto de navegação à API Routes para calcular a rota e recuperar um token de rota.

Por fim, o token de ponto de navegação e o token de rota são transmitidos para um app móvel para motoristas que usa o SDK Navigation para iOS ou Android para criar um waypoint e direcionar o motorista para o ponto de retirada correto.

Leitura adicional