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, pakietu SDK do nawigacji na iOS lub interfejsu Routes API, co pozwala ulepszyć wyznaczanie tras i zwiększyć komfort kierowcy. Jest to przydatne w przypadku usług takich jak dostawa jedzenia czy wspólne przejazdy, w których punkt odbioru lub wysiadki może być niejednoznaczny bez danych wejściowych użytkownika.

Aby utworzyć i przekazać token punktu nawigacyjnego, użyj metody 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 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 do nawigacji na Androida, pakietu SDK do nawigacji na iOS lub interfejsu Routes API, gdzie tworzony jest punkt pośredni do precyzyjnego wyznaczania trasy. Miejsce docelowe zostanie wyróżnione dla kierowcy przez Navigation SDK na podstawie miejsca, z którym powiązany jest token.

Przykład: przypadek użycia związany z przejazdami

Przegląd

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

Aby to zrobić:

  1. Pobierz 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 pakietu Navigation SDK token punktu nawigacyjnego i token trasy.
  4. Użyj pakietu Navigation SDK, aby wyznaczyć kierowcy trasę do prawidłowego miejsca odbioru.

W sekcji Dodatkowe informacje znajdziesz linki do odpowiedniej dokumentacji interfejsu Routes API oraz pakietów Navigation SDK na iOS i Androida.

Ten diagram pokazuje, jak aplikacja do przewozu osób lub dostaw może używać interfejsu Geocoding API, Routes API i Navigation SDK na iOS lub Androida do wyznaczania trasy dla kierowcy za pomocą tokena trasy i tokena punktu nawigacyjnego:

Diagram przedstawiający przypadek użycia w przypadku przejazdów lub dostaw
Diagram przedstawiający przypadek użycia związany z przewozem osób lub dostawą

Przykład wspólnych przejazdów

Wyobraź sobie sytuację, w której użytkownik zamawia przejazd w aplikacji, a kierowca otrzymuje powiadomienie o przejazdzie i informacje o trasie do miejsca docelowego w innej aplikacji.

Obraz przedstawia przykłady aplikacji do przewozu osób, w której wybrano punkt nawigacyjny, oraz aplikacji dla kierowców korzystającej z pakietu Navigation SDK na Androida do precyzyjnego wyznaczania trasy.

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

Gdy użytkownik otworzy aplikację użytkownika, wywoła ona metodę Destinations interfejsu Geocoding API i udostępni użytkownikowi 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
      }
    }
]

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 dla kierowców, która korzysta z pakietu Navigation SDK na iOS lub Androida, aby utworzyć punkt pośredni i wyznaczyć kierowcy trasę do właściwego miejsca odbioru.

Więcej informacji