Wyznaczanie trasy za pomocą tokenów punktów nawigacyjnych

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Tokeny punktów nawigacyjnych umożliwiają przesyłanie kluczowych informacji kontekstowych o miejscu docelowym do pakietu SDK do nawigacji na Androida lub pakietu SDK do nawigacji na iOS, co pozwala ulepszyć wyznaczanie tras i zwiększyć komfort kierowcy. Jest to przydatne w przypadku usług takich jak dostawa jedzenia czy przejazdy, w których punkt odbioru lub docelowy może być niejednoznaczny bez interakcji użytkownika.

Obraz przedstawia przykłady aplikacji do przewozów pasażerskich, w której wybrano punkt nawigacyjny, oraz aplikacji dla kierowców korzystającej z pakietu Navigation SDK na Androida, aby precyzyjnie wyznaczyć trasę.

Przykłady aplikacji dla klientów i kierowców

Aby utworzyć i przekazać token punktu nawigacyjnego, użyj punktu końcowego Destinations interfejsu Geocoding API, aby umożliwić użytkownikom wybór preferowanej lokalizacji z listy punktów nawigacyjnych. Wybór użytkownika staje się punktem nawigacyjnym zwracanym przez punkt końcowy Destinations interfejsu Geocoding API. Następnie możesz przekazać token punktu nawigacyjnego, który zawiera zarówno współrzędne miejsca docelowego, jak i informacje kontekstowe, do pakietu SDK do nawigacji na Androida lub pakietu SDK do nawigacji na iOS, gdzie tworzony jest punkt pośredni na potrzeby precyzyjnego wyznaczania trasy. Miejsce docelowe zostanie wyróżnione dla kierowcy przez Navigation SDK na podstawie miejsca, z którym powiązany jest token.

Jak token punktu nawigacyjnego jest tworzony i wysyłany do pakietu Nav SDK na potrzeby wyznaczania trasy

Wyobraź sobie na przykład aplikację do zamawiania przejazdów, w której konsument może zarezerwować przejazd, oraz drugą aplikację, w której kierowca otrzymuje powiadomienie o przejazdzie i informacje o trasie do miejsca docelowego.

Gdy klient otworzy aplikację konsumencką, wywoła ona punkt końcowy Destinations interfejsu Geocoding API i udostępni klientowi wybór potencjalnych punktów nawigacyjnych:

Klient wybiera punkt odbioru

Użytkownik wybiera preferowany punkt, który jest jednym z elementów tablicy navigationPoints w treści odpowiedzi na żądanie SearchDestinations:

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

Token punktu nawigacyjnego z odpowiedzi jest przekazywany do aplikacji mobilnej dla kierowców, która korzysta z pakietu Navigation SDK na Androida lub iOS, aby utworzyć punkt pośredni i wyznaczyć trasę do prawidłowego miejsca odbioru.