Criar rotas usando tokens de ponto de navegação

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

Os tokens de ponto de navegação permitem enviar informações contextuais importantes sobre um destino ao SDK do Navigation para Android ou ao SDK do Navigation para iOS, melhorando 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 embarque ou desembarque pode ser ambíguo sem a entrada do usuário.

Esta imagem mostra exemplos de um app de transporte por aplicativo para o consumidor em que o ponto de navegação é selecionado e um app de motorista que usa o SDK do Navigation para Android para rotear o 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 para permitir 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, você pode transmitir o token de ponto de navegação, que contém as coordenadas de destino e informações contextuais, para o SDK do Navigation para Android ou o SDK do Navigation para iOS, em que um waypoint é criado para um roteamento preciso. O destino será destacado para o motorista pelo SDK do Navigation com base no lugar ao qual o token está associado.

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

Por exemplo, imagine um caso de uso de transporte por aplicativo, em que há um app para o consumidor reservar a viagem e um segundo app para o motorista receber a notificação da viagem e as informações de roteamento para o destino.

Quando um consumidor abre o app, ele chama o endpoint Destinations da API Geocoding e oferece ao consumidor 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 SearchDestinations solicitação:

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

O token de ponto de navegação da resposta é transmitido a um app de motorista para dispositivos móveis que usa o SDK do Navigation para Android ou iOS para criar um waypoint para rotear o motorista até o ponto de embarque correto.