REST Resource: projects.trips

Zasób: Trip

podróż,

Zapis JSON 
{
  "name": string,
  "config": {
    object (TripConfig)
  },
  "androidAppId": string,
  "iosAppId": string,
  "authToken": {
    object (AuthToken)
  },
  "state": enum (State),
  "execution": {
    object (TripExecution)
  },
  "createTime": string,
  "updateTime": string
}
Pola
name

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu podróży. Format: projects/{project_number}/trips/{tripId}.
config

object (TripConfig)

Wartość niezmienna. Konfiguracja wycieczki.
androidAppId

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: androidAppId lub iosAppId.
iosAppId

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: androidAppId lub iosAppId.
authToken

object (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 trips.create.
state

enum (State)

Tylko dane wyjściowe. Stan podróży.
execution

object (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.
createTime

string (Timestamp format)

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

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, w którym serwer otrzymał ostatnią aktualizację przejazdu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

TripConfig

Konfiguracja przejazdu.

Zapis JSON 
{
  "enableHighFrequencyUpdates": boolean,
  "enablePubsub": boolean,
  "pubsubFieldMask": string,
  "enableRemainingRouteReporting": boolean
}
Pola
enableHighFrequencyUpdates

boolean

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

boolean

Opcjonalnie. Czy włączyć powiadomienia Pub/Sub dotyczące przejazdu.
pubsubFieldMask

string (FieldMask format)

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:

  • androidAppId
  • iosAppId
  • authToken
  • config

UWAGA: to pole jest ignorowane, jeśli wartość enablePubsub to „false”.

Jest to lista w pełni kwalifikowanych nazw pól rozdzielonych przecinkami. Przykład: "user.displayName,photo".
enableRemainingRouteReporting

boolean

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.

AuthToken

Token uwierzytelniania.

Zapis JSON 
{
  "token": string,
  "expireTime": string
}
Pola
token

string

Tylko dane wyjściowe. Token uwierzytelniania, który należy przekazać do aplikacji mobilnej.
expireTime

string (Timestamp format)

Tylko dane wyjściowe. Czas wygaśnięcia tokena uwierzytelniającego.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

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.

TripExecution

Dane dotyczące realizacji przejazdu.

Zapis JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Stop)
  },
  "location": {
    object (Location)
  },
  "remainingRoute": {
    object (Route)
  },
  "traveledDuration": string,
  "remainingDuration": string,
  "traveledDistanceMeters": integer,
  "remainingDistanceMeters": integer,
  "stopAddedInRoute": boolean
}
Pola
origin

object (Location)

Tylko dane wyjściowe. Miejsce rozpoczęcia podróży, które jest zwykle lokalizacją przewoźnika na początku podróży NavConnect.
destination

object (Stop)

Tylko dane wyjściowe. Miejsce docelowe podróży podane przez aplikację mobilną.
location

object (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.
remainingRoute

object (Route)

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

string (Duration format)

Tylko dane wyjściowe. Czas podróży.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
remainingDuration

string (Duration format)

Tylko dane wyjściowe. Szacowany przez Google czas pozostały do końca podróży.

Czas trwania w sekundach z maksymalnie 9 miejscami po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
traveledDistanceMeters

integer

Tylko dane wyjściowe. Odległość pokonana od punktu początkowego w metrach.
remainingDistanceMeters

integer

Tylko dane wyjściowe. Pozostała odległość do miejsca docelowego w metrach.
stopAddedInRoute

boolean

Tylko dane wyjściowe. Wskazuje, czy na trasie dodano przystanek.

Lokalizacja

Lokalizacja zgłoszona przez aplikację mobilną.

Zapis JSON 
{
  "point": {
    object (LatLng)
  },
  "sourceTime": string,
  "serverTime": string
}
Pola
point

object (LatLng)

Tylko dane wyjściowe. Szerokość i długość geograficzna lokalizacji.
sourceTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, w którym lokalizacja została pozyskana, zgodnie z informacjami podanymi przez klienta.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
serverTime

string (Timestamp format)

Tylko dane wyjściowe. Godzina, o której serwer otrzymał tę informację o zmianie lokalizacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest to para liczb zmiennoprzecinkowych podwójnej precyzji, które reprezentują stopnie szerokości i długości geograficznej. O ile nie określono inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych zakresach.

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie od –180,0 do +180,0.

Zatrzymaj

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

Zapis JSON 
{
  "point": {
    object (LatLng)
  }
}
Pola
point

object (LatLng)

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

Trasa

linię łamaną trasy,

Zapis JSON 
{
  "trafficInformation": [
    {
      object (SpeedReadingInterval)
    }
  ],

  // Union field format can be only one of the following:
  "simplePolyline": {
    object (SimplePolyline)
  },
  "encodedPolyline": string,
  "s2Polyline": string,
  "geoJson": {
    object
  }
  // End of list of possible types for union field format.
}
Pola
trafficInformation[]

object (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:
simplePolyline

object (SimplePolyline)

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

string

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

string (bytes format)

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

Ciąg zakodowany w formacie Base64.
geoJson

object (Struct format)

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.

Zapis JSON 
{
  "points": [
    {
      object (LatLng)
    }
  ]
}
Pola
points[]

object (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.

Zapis JSON 
{
  "speed": enum (Speed),
  "startPolylinePointIndex": integer,
  "endPolylinePointIndex": integer
}
Pola
speed

enum (Speed)

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

integer

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

integer

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;

Metody

create

 Tworzy podróż.

get

 Otrzymuje przejazd.