Package google.maps.navconnect.v1

Indeks

• NavConnectService (interfejs)
• AuthToken (komunikat)
• CreateTripRequest (komunikat)
• GetTripRequest (komunikat)
• Location (komunikat)
• Stop (komunikat)
• Trip (komunikat)
• Trip.State (wyliczenie)
• TripConfig (komunikat)
• TripExecution (komunikat)

NavConnectService

Usługa dla klientów NavConnect, która umożliwia tworzenie i pobieranie tras.

CreateTrip
rpc CreateTrip(CreateTripRequest) returns (Trip) Tworzy podróż. Tę funkcję należy wywołać, zanim aplikacja mobilna rozpocznie przejazd. Zwrócona podróż będzie miała ustawione pole auth_token. Zakresy autoryzacji Wymaga następującego zakresu OAuth: https://www.googleapis.com/auth/cloud-platform

GetTrip
rpc GetTrip(GetTripRequest) returns (Trip) Otrzymuje przejazd. Zakresy autoryzacji Wymaga następującego zakresu OAuth: https://www.googleapis.com/auth/cloud-platform

AuthToken

Token uwierzytelniania.

Pola
token	string Tylko dane wyjściowe. Token uwierzytelniania, który należy przekazać do aplikacji mobilnej.
expire_time	Timestamp Tylko dane wyjściowe. Czas wygaśnięcia tokena uwierzytelniania.

CreateTripRequest

Wiadomość z prośbą o wywołanie NavConnectService.CreateTrip.

Pola
parent	string Wymagane. Zasób nadrzędny, w którym zostanie utworzona ta podróż. Format: projects/{numer_projektu}
trip_id	string Wymagane. Identyfikator do użycia w przypadku przejazdu, który stanie się ostatnim komponentem nazwy zasobu przejazdu. Wartość musi być prawidłowym identyfikatorem UUID zgodnym z RFC-4122.
trip	Trip Wymagane. Podróż do utworzenia.

GetTripRequest

Komunikat żądania dla NavConnectService.GetTrip.

Pola
name	string Wymagane. Nazwa zasobu przejazdu do pobrania. Format: projects/{project}/trips/{trip_id}

Lokalizacja

Lokalizacja zgłoszona przez aplikację mobilną.

Pola
point	LatLng Tylko dane wyjściowe. Szerokość i długość geograficzna lokalizacji.
source_time	Timestamp Tylko dane wyjściowe. Czas, w którym lokalizacja została pozyskana, zgodnie z informacjami podanymi przez klienta.
server_time	Timestamp Tylko dane wyjściowe. Godzina, o której serwer otrzymał tę informację o zmianie lokalizacji.

Zatrzymaj

Przystanek w podróży, na którym należy wykonać jakieś zadanie.

Pola
point	LatLng Wymagane. Lokalizacja przystanku w postaci szerokości i długości geograficznej.

Podróż

podróż,

Pola
name	string Tylko dane wyjściowe. Identyfikator. Nazwa zasobu podróży. Format: projects/{project_number}/trips/{trip_id}.
config	TripConfig Niezmienna. Konfiguracja wycieczki.
android_app_id	string Tylko dane wejściowe. Niezmienna. Identyfikator aplikacji na Androida, która będzie korzystać z przejazdu. Musisz ustawić co najmniej jedną z tych właściwości: android_app_id lub ios_app_id.
ios_app_id	string Tylko dane wejściowe. Niezmienna. Identyfikator pakietu iOS aplikacji mobilnej, która będzie korzystać z przejazdu. Musisz ustawić co najmniej jedną z tych właściwości: android_app_id lub ios_app_id.
auth_token	AuthToken Tylko dane wyjściowe. Nieprzezroczysty token, który autoryzuje rozpoczęcie podróży w NavConnect w Mapach Google lub Waze i przyznaje tym aplikacjom dostęp do aktualizowania podróży. Zwracany tylko przez CreateTrip.
state	State Tylko dane wyjściowe. Stan podróży.
execution	TripExecution Tylko dane wyjściowe. Najnowsze dane dotyczące realizacji podróży. Może nie być ustawiona, jeśli przejazd jest w stanie błędu.
create_time	Timestamp Tylko dane wyjściowe. Czas utworzenia przejazdu na serwerze.
update_time	Timestamp Tylko dane wyjściowe. Czas, w którym serwer otrzymał najnowszą aktualizację przejazdu.

Stan

Wszystkie możliwe stany przejazdu.

Wartości w polu enum
STATE_UNSPECIFIED	Stan przejazdu jest nieokreślony.
NEW	Podróż została utworzona, ale jeszcze się nie rozpoczęła.
ENROUTE	Przewoźnik jest w drodze do miejsca docelowego.
ARRIVED	Przewoźnik dotarł do miejsca docelowego.
SUSPENDED	Podróż została zawieszona.
FAILED	Nie udało się ukończyć przejazdu.
CLIENT_ERROR	Przejazd nie powiódł się z powodu błędu klienta.

TripConfig

Konfiguracja wycieczki.

Pola
enable_high_frequency_updates	bool Opcjonalnie. Czy włączyć bardzo częste aktualizacje przejazdów. UWAGA: włączenie tej funkcji powoduje rejestrowanie przejazdu w ramach korzystania z usługi na poziomie Enterprise i podlega stawkom obowiązującym na tym poziomie.
enable_pubsub	bool Opcjonalnie. Czy włączyć powiadomienia Pub/Sub dotyczące przejazdu.
pubsub_field_mask	FieldMask Opcjonalnie. Jeśli ta opcja jest ustawiona, w powiadomieniach pubsub będzie uwzględniany tylko określony podzbiór pól podróży. Jeśli nie ustawisz tego pola, wszystkie pola obiektu Trip będą uwzględniane w powiadomieniach Pub/Sub (domyślne działanie). Następujące pola nie są obsługiwane: android_app_id ios_app_id auth_token config UWAGA: to pole jest ignorowane, jeśli wartość enable_pubsub to „false”.

TripExecution

Dane dotyczące realizacji przejazdu.

Pola
origin	Location Tylko dane wyjściowe. Miejsce rozpoczęcia podróży, które jest zwykle lokalizacją przewoźnika na początku podróży NavConnect.
destination	Stop Tylko dane wyjściowe. Miejsce docelowe podróży podane przez aplikację mobilną.
location	Location Tylko dane wyjściowe. Sygnał lokalizacji reprezentujący ostatnią znaną lokalizację przewoźnika. Jeśli jest dostępna, będzie to lokalizacja przyciągnięta do drogi.
traveled_duration	Duration Tylko dane wyjściowe. Czas podróży do tej pory.
remaining_duration	Duration Tylko dane wyjściowe. Szacowany przez Google czas pozostały do końca podróży.
traveled_distance_meters	int32 Tylko dane wyjściowe. Odległość pokonana od punktu początkowego w metrach.
remaining_distance_meters	int32 Tylko dane wyjściowe. Pozostała odległość do miejsca docelowego w metrach.
stop_added_in_route	bool Tylko dane wyjściowe. Wskazuje, czy na trasie dodano przystanek.