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

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Tokeny punktów nawigacyjnych umożliwiają wysyłanie kluczowych informacji kontekstowych o miejscu docelowym do pakietu SDK do nawigacji na Androida, pakietu SDK do nawigacji na iOS lub interfejsu Routes API, aby ulepszyć wyznaczanie trasy i zwiększyć komfort kierowcy. Jest to przydatne w przypadku dostawy jedzenia lub przejazdów, gdy miejsce odbioru lub wysiadania może być niejednoznaczne bez danych wejściowych użytkownika.

Aby utworzyć i przekazać token punktu nawigacyjnego, użyj metody Destinations interfejsu Geocoding API, która umożliwia użytkownikom wybór preferowanej lokalizacji z listy punktów nawigacyjnych. Wybór użytkownika staje się punktem nawigacyjnym zwracanym przez metodę 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 Navigation dla Androida, pakietu SDK Navigation dla iOS lub Routes API, gdzie tworzony jest punkt na trasie na potrzeby precyzyjnego wyznaczania trasy. Miejsce docelowe zostanie wyróżnione dla kierowcy przez pakiet Navigation SDK na podstawie miejsca, z którym powiązany jest token.

Przykład: przejazdy współdzielone

Przegląd

Ten przykład pokazuje, jak połączyć interfejsy Geocoding API i Routes API oraz pakiet Navigation SDK na iOS lub Androida, aby utworzyć aplikację do wspólnych przejazdów, która oblicza cenę trasy i kieruje kierowców do właściwego punktu odbioru.

Oto ogólne kroki:

  1. pobrać token punktu nawigacyjnego za pomocą interfejsu Geocoding API,
  2. Użyj interfejsu Routes API, aby obliczyć trasę i zakodować ją w tokenie trasy.
  3. Przekaż do Navigation SDK zarówno token punktu nawigacyjnego, jak i token trasy.
  4. Użyj pakietu Navigation SDK, aby skierować kierowcę do właściwego punktu odbioru.

Więcej informacji znajdziesz w sekcji Dodatkowe materiały, w której podano linki do dokumentacji interfejsu Routes API, pakietu Navigation SDK na iOS i pakietu Navigation SDK na Androida.

Ten diagram pokazuje, jak aplikacja do przejazdów współdzielonych lub dostaw korzysta z Geocoding API, Routes API i Navigation SDK na iOS lub Androida, aby wyznaczyć trasę dla kierowcy za pomocą tokena trasy i tokena punktu nawigacyjnego:

Diagram przypadku użycia przejazdów i dostaw
Diagram przedstawiający przypadek użycia związany z przejazdami lub dostawami

Przykład wspólnych przejazdów

Wyobraź sobie scenariusz przejazdu, w którym konsument korzysta z aplikacji do rezerwacji przejazdu, a kierowca – z drugiej aplikacji, w której otrzymuje powiadomienie o przejeździe i informacje o trasie do miejsca docelowego.

Ten obraz przedstawia przykłady aplikacji konsumenckiej do wspólnych przejazdów, w której wybrano punkt nawigacyjny, oraz aplikacji dla kierowcy, która korzysta z pakietu Navigation SDK na Androida, aby precyzyjnie wyznaczać trasę.

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

Gdy użytkownik otwiera aplikację użytkownika, wywołuje ona metodę Destinations interfejsu Geocoding API i udostępnia użytkownikowi wybór potencjalnych punktów nawigacyjnych:

Klient wybiera punkt nadania.

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
      }
    }
]

Backend aplikacji przekazuje token punktu nawigacyjnego do interfejsu Routes API, aby obliczyć trasę i pobrać token trasy.

Na koniec token punktu nawigacyjnego i token trasy są przekazywane do aplikacji mobilnej kierowcy, która używa pakietu Navigation SDK na iOS lub Androida, aby utworzyć punkt na trasie i skierować kierowcę do właściwego punktu odbioru.

Więcej informacji