Package google.maps.navconnect.v1

Indeks

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

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Tworzy przejazd. Tę metodę należy wywołać, zanim aplikacja mobilna będzie mogła rozpocząć przejazd. Zwrócony przejazd będzie miał ustawione pole auth_token.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform
Uprawnienia

Wymaga tych uprawnień IAM w zasobie parent:

  • navigationconnect.trips.create

Więcej informacji znajdziesz w dokumentacji IAM.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Otrzymuje przejazd.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform
Uprawnienia

Wymaga tych uprawnień IAM w zasobie name:

  • navigationconnect.trips.get

Więcej informacji znajdziesz w dokumentacji IAM.

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 uwierzytelniającego.

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

RoutePolylineFormat

Opcjonalnie. Format linii łamanej trasy do zwrócenia. Jeśli nie zostanie ustawiona, zostanie zwrócona linia łamana trasy SIMPLE.

RoutePolylineFormat

Określa format linii łamanej trasy.

Wartości w polu enum
ROUTE_POLYLINE_FORMAT_UNSPECIFIED Format polilinii trasy nie został określony.
SIMPLE Linia łamana trasy jest zwracana jako prosta tablica punktów w formacie google.type.LatLng.
ENCODED Linia łamana trasy jest zwracana jako zakodowany ciąg znaków. Zobacz https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
S2ENCODED Linia łamana trasy jest zakodowana jako S2Polyline. Zobacz https://s2geometry.io/devguide/basic_types.html.
GEO_JSON Linia łamana trasy jest zwracana jako GeoJSON LineString. Patrz https://tools.ietf.org/html/rfc7946#section-3.1.4.

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.

Trasa

linię łamaną trasy,

Pola
traffic_information[]

SpeedReadingInterval

Tylko dane wyjściowe. Informacje o ruchu na polilinii opisane jako przedziały odczytu prędkości.

UWAGI:

  • Przedziały nie nakładają się na siebie.
  • Przedziały są ciągłe.
  • Przedziały obejmują całą linię łamaną.
  • Przedziały są sortowane według rosnącego indeksu.
  • Szybkość jest określana dla każdego interwału.

Pole zbiorcze format. Format trasy.

Format wypełnianej wartości jest kontrolowany przez parametr route_polyline_format. Jeśli nie jest ustawiony, domyślnie jest to prosta linia łamana. format może mieć tylko jedną z tych wartości:
simple_polyline

SimplePolyline

Tylko dane wyjściowe. Trasa jako prosta lista par latlng.
encoded_polyline

string

Tylko dane wyjściowe. Trasa jako zakodowana linia łamana. Zobacz https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
s2_polyline

bytes

Tylko dane wyjściowe. Trasa jako zakodowana linia łamana S2. Zobacz https://s2geometry.io/devguide/basic_types.html.
geo_json

Struct

Tylko dane wyjściowe. Trasa w formacie GeoJSON LineString. Patrz https://tools.ietf.org/html/rfc7946#section-3.1.4.

SimplePolyline

Reprezentuje polilinię za pomocą prostej listy punktów.

Pola
points[]

LatLng

Tylko dane wyjściowe. Uporządkowana lista punktów reprezentujących polilinię.

SpeedReadingInterval

Wskaźnik gęstości ruchu na ciągłym odcinku ścieżki. W przypadku ścieżki z punktami P_0, P_1, ... , P_N (indeksowanie od zera) element SpeedReadingInterval definiuje przedział i opisuje ruch w nim za pomocą kategorii Speed.

Pola
speed

Speed

Tylko dane wyjściowe. Prędkość ruchu w tym przedziale.
start_polyline_point_index

int32

Tylko dane wyjściowe. Indeks początkowy tego przedziału na ścieżce.
end_polyline_point_index

int32

Tylko dane wyjściowe. Indeks końcowy tego przedziału w ścieżce.

Szybkość

Klasyfikacja prędkości linii łamanej na podstawie danych o ruchu.

Wartości w polu enum
SPEED_UNSPECIFIED Szybkość nie została określona.
NORMAL Normalna prędkość, brak opóźnień w ruchu.
SLOW Wykryto spowolnienie, małe lub średnie natężenie ruchu.
TRAFFIC_JAM opóźnienia w ruchu, w tym korki;

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

Wartość niezmienna. Konfiguracja wycieczki.
android_app_id

string

Tylko dane wejściowe. Wartość 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. Wartość 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 podróż jest w stanie błędu.
create_time

Timestamp

Tylko dane wyjściowe. Czas utworzenia podróży na serwerze.
update_time

Timestamp

Tylko dane wyjściowe. Czas, w którym serwer otrzymał ostatnią 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.
CANCELED Podróż została wyraźnie anulowana przez dewelopera.

TripConfig

Konfiguracja przejazdu.

Pola
enable_high_frequency_updates

bool

Opcjonalnie. Czy włączyć częste aktualizacje przejazdu.

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 Trip.

Jeśli nie ustawisz tego pola, w powiadomieniach Pub/Sub zostaną uwzględnione wszystkie pola obiektu Trip (domyślne działanie).

Te 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”.
enable_remaining_route_reporting

bool

Opcjonalnie. Określa, czy włączyć raportowanie pozostałej części trasy.

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.

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.
remaining_route

Route

Tylko dane wyjściowe. Zawiera linię łamaną pozostałej części trasy.
traveled_duration

Duration

Tylko dane wyjściowe. Czas podróży.
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.