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 ao SDK Navigation para Android e melhorar o roteamento e a experiência do motorista. Isso é útil em casos como entrega de comida ou transporte por aplicativo, em que o ponto de coleta ou desembarque pode ser ambíguo sem a entrada do usuário.

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

Para criar e transmitir um token de ponto de navegação, use o endpoint Destinations da API Geocoding e permita que os 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 endpoint 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, em que um ponto de parada é criado para um roteamento preciso. O destino será destacado para o motorista pelo SDK Navigation com base no lugar associado ao token.

Como um token de ponto de navegação é criado e enviado ao SDK Navigation para roteamento

Por exemplo, imagine um caso de uso 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.

Quando um consumidor abre o app dele, o app chama o endpoint Destinations da API Geocoding e oferece uma seleção de possíveis pontos de navegação:

Consumidor escolhendo um ponto de desembarque

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 token do ponto de navegação da resposta é transmitido para um app de motorista para dispositivos móveis que usa o SDK Navigation para Android para criar um Waypoint e direcionar o motorista até o ponto de coleta correto.