Fleet Engine Entities

Interfejs listy zadań

google.maps.journeySharing.Taskinterfejs

Szczegóły zadania zwróconego przez mechanizm floty.
attributes
Typ:  Object<string, *>
Atrybuty przypisane do zadania.
name
Typ:  string
Nazwa zadania w formacie „providers/{provider_id}/tasks/{task_id}”. Parametr task_id musi być unikalnym identyfikatorem, a nie identyfikatorem śledzenia. Aby zapisać identyfikator śledzenia przesyłki, użyj pola tracking_id. Ten sam identyfikator śledzenia może występować w przypadku wielu zadań.
remainingVehicleJourneySegments
Informacje o segmentach, które trzeba jeszcze wypełnić w przypadku tego zadania.
status
Typ:  string
Bieżący stan wykonywania zadania.
type
Typ:  string
Typ zadania, na przykład przerwa lub przesyłka.
estimatedCompletionTime optional
Typ:  Date optional
Sygnatura czasowa szacunkowego zakończenia zadania.
latestVehicleLocationUpdate optional
Typ:  VehicleLocationUpdate optional
Informacje dotyczące ostatniej aktualizacji lokalizacji.
outcome optional
Typ:  string optional
Wynik wykonania zadania.
outcomeLocation optional
Typ:  LatLngLiteral optional
Lokalizacja, w której zadanie zostało ukończone (z usługodawcy).
outcomeLocationSource optional
Typ:  string optional
Ustawianie lokalizacji wyniku zadania („PROVIDER” lub „LAST_VEHICLE_LOCATION”).
outcomeTime optional
Typ:  Date optional
Sygnatura czasowa ustawienia wyniku zadania (od dostawcy).
plannedLocation optional
Typ:  LatLngLiteral optional
Miejsce, w którym ma zostać wykonane zadanie.
targetTimeWindow optional
Typ:  TimeWindow optional
Okno czasowe, w którym należy wykonać zadanie.
trackingId optional
Typ:  string optional
Identyfikator śledzenia przesyłki.
vehicleId optional
Typ:  string optional
Identyfikator pojazdu wykonującego to zadanie.

Interfejs TaskInfo

google.maps.journeySharing.TaskInfointerfejs

Typ TaskInfo używany przez DeliveryVehicleStop.
extraDurationMillis optional
Typ:  number optional
Czas, jaki zajmuje wykonanie zadania, w milisekundach.
id optional
Typ:  string optional
Identyfikator zadania.
targetTimeWindow optional
Typ:  TimeWindow optional
Okno czasowe, w którym należy wykonać zadanie.

Interfejs TaskTrackingInfo

google.maps.journeySharing.TaskTrackingInfointerfejs

Szczegóły obiektu informacji o śledzeniu zadań zwrócone przez Fleet Engine.
attributes
Typ:  Object<string, *>
Atrybuty przypisane do zadania.
name
Typ:  string
Nazwa w formacie „providers/{provider_id}/taskTrackingInfo/{tracking_id}”, gdzie tracking_id to identyfikator śledzenia.
trackingId
Typ:  string
Identyfikator śledzenia zadania.
  • Musi to być prawidłowy ciąg znaków Unicode.
  • Maksymalna długość to 64 znaki.
  • znormalizowany zgodnie z formą normalizacji C standardu Unicode.
  • Nie może zawierać tych znaków ASCII: '/', ':', '?', ',' ani '#'.
estimatedArrivalTime optional
Typ:  Date optional
Szacowany czas dotarcia do miejsca postoju.
estimatedTaskCompletionTime optional
Typ:  Date optional
Szacowany czas ukończenia zadania.
latestVehicleLocationUpdate optional
Typ:  VehicleLocationUpdate optional
Informacje dotyczące ostatniej aktualizacji lokalizacji.
plannedLocation optional
Typ:  LatLng optional
Miejsce, w którym zostanie ukończone zadanie.
remainingDrivingDistanceMeters optional
Typ:  number optional
Łączna pozostała odległość w metrach do VehicleStop docelowego.
remainingStopCount optional
Typ:  number optional
Wskazuje liczbę przystanków, które pojazd ma jeszcze do wykonania, zanim dotrze do przystanku zadania, w tym przystanek zadania. Jeśli na przykład następny przystanek pojazdu to przystanek związany z wykonywaniem zadania, wartość będzie wynosić 1.
routePolylinePoints optional
Typ:  Array<LatLng> optional
Lista punktów, które po połączeniu tworzą linię wielokąta oczekiwanej trasy pojazdu do lokalizacji tego zadania.
state optional
Typ:  string optional
Bieżący stan wykonywania zadania.
targetTimeWindow optional
Typ:  TimeWindow optional
Okno czasowe, w którym należy wykonać zadanie.
taskOutcome optional
Typ:  string optional
Wynik próby wykonania zadania.
taskOutcomeTime optional
Typ:  Date optional
Czas, w którym usługodawca ustawił wynik zadania.

Interfejs Podróży

google.maps.journeySharing.Tripinterfejs

Szczegóły przejazdu zwrócone przez silnik floty.
name
Typ:  string
W formacie „providers/{provider_id}/trips/{trip_id}”. Parametr trip_id musi być unikalnym identyfikatorem.
passengerCount
Typ:  number
Liczba pasażerów w tej podróży (bez kierowcy).
remainingWaypoints
Tablica punktów pośrednich wskazująca ścieżkę od bieżącej lokalizacji do punktu docelowego.
status
Typ:  string
Bieżący stan podróży. Możliwe wartości to UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE lub CANCELED.
type
Typ:  string
Typ podróży. Możliwe wartości to UNKNOWN_TRIP_TYPE, SHARED lub EXCLUSIVE.
vehicleId
Typ:  string
Identyfikator pojazdu, który odbywa podróż.
actualDropOffLocation optional
Typ:  LatLngLiteral optional
Miejsce, w którym klient został wysaniony.
actualPickupLocation optional
Typ:  LatLngLiteral optional
Miejsce, w którym klient został odebrany.
dropOffTime optional
Typ:  Date optional
Przewidywana godzina wysadzenia pasażerów lub godzina, o której pasażerowie zostali już wysadzeni.
latestVehicleLocationUpdate optional
Typ:  VehicleLocationUpdate optional
Informacje dotyczące ostatniej aktualizacji lokalizacji.
pickupTime optional
Typ:  Date optional
Przewidywany przyszły czas odbioru pasażerów lub faktyczny czas odbioru.
plannedDropOffLocation optional
Typ:  LatLngLiteral optional
Miejsce, w którym klient chce zostać odebrany.
plannedPickupLocation optional
Typ:  LatLngLiteral optional
Miejsce, w którym klient wskazuje, że chce odebrać przesyłkę.

Interfejs DeliveryVehicle

google.maps.journeySharing.DeliveryVehicleinterfejs

Szczegóły pojazdu dostawczego zwróconego przez Fleet Engine.
attributes
Typ:  Object<string, string optional>
niestandardowe atrybuty pojazdu dostawczego,
name
Typ:  string
W formacie „providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}”. Wartość delivery_vehicle_id musi być unikalnym identyfikatorem.
navigationStatus
Typ:  string
Bieżący stan nawigacji pojazdu.
remainingDistanceMeters
Typ:  number
Pozostała odległość do przejechania na bieżącym odcinku trasy w metrach.
remainingVehicleJourneySegments
Odcinki trasy przypisane do tego pojazdu dostawczego, zaczynając od ostatnio zgłoszonej lokalizacji pojazdu. Jest ono wypełniane tylko wtedy, gdy obiekt danych DeliveryVehicle jest przekazywany za pomocą elementu FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Typ:  LatLngLiteral optional
Miejsce, w którym kończy się bieżący segment trasy.
latestVehicleLocationUpdate optional
Typ:  VehicleLocationUpdate optional
Ostatnia zgłoszona lokalizacja pojazdu dostawczego.
remainingDurationMillis optional
Typ:  number optional
Pozostały czas jazdy w bieżącym segmencie trasy (w milisekundach).

Interfejs DeliveryVehicleStop

google.maps.journeySharing.DeliveryVehicleStopinterfejs

Typ DeliveryVehicleStop
tasks
Typ:  Array<TaskInfo>
Lista zadań do wykonania na tym przystanku.
  • id: identyfikator zadania.
  • extraDurationMillis: dodatkowy czas potrzebny do wykonania zadania w milisekundach.
plannedLocation optional
Typ:  LatLngLiteral optional
Lokalizacja przystanku.
state optional
Typ:  DeliveryVehicleStopState optional
Stan przystanku.

Stałe DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState stałe

Bieżący stan DeliveryVehicleStop.

Dostęp przez połączenie telefoniczne const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
ARRIVED Przybycie na przystanek. Zakłada się, że gdy pojazd jedzie do następnego przystanku, wszystkie poprzednie przystanki zostały już zrealizowane.
ENROUTE Przypisany i aktywnie kierujący ruchem.
NEW Utworzone, ale nie aktywnie kierujące ruchem.
UNSPECIFIED Nieznany.

Interfejs VehicleJourneySegment

google.maps.journeySharing.VehicleJourneySegmentinterfejs

Typ VehicleJourneySegment
drivingDistanceMeters optional
Typ:  number optional
Odległość od poprzedniego przystanku do tego przystanku w metrach.
drivingDurationMillis optional
Typ:  number optional
Czas przejazdu od poprzedniego przystanku do tego przystanku (w milisekundach).
path optional
Typ:  Array<LatLngLiteral> optional
Ścieżka od poprzedniego przystanku (lub bieżącej lokalizacji pojazdu, jeśli ten przystanek jest pierwszy na liście przystanków) do tego przystanku.
stop optional
Typ:  DeliveryVehicleStop optional
Informacje o przystanku.

Interfejs VehicleLocationUpdate

google.maps.journeySharing.VehicleLocationUpdateinterfejs

Typ VehicleLocationUpdate
heading optional
Typ:  number optional
Nagłówek aktualizacji. 0 odpowiada północy, a 180 – południu.
location optional
Typ:  LatLngLiteral|LatLng optional
Lokalizacja aktualizacji.
speedKilometersPerHour optional
Typ:  number optional
Prędkość w kilometrach na godzinę.
time optional
Typ:  Date optional
Czas otrzymania tej aktualizacji z pojazdu.

Interfejs VehicleWaypoint

google.maps.journeySharing.VehicleWaypointinterfejs

Typ waypointu pojazdu.
distanceMeters optional
Typ:  number optional
Odległość na ścieżce między poprzednim punktem drogi (lub bieżącą lokalizacją pojazdu, jeśli ten punkt drogi jest pierwszy na liście punktów drogi) a tym punktem drogi w metrach.
durationMillis optional
Typ:  number optional
Czas przejazdu między poprzednim punktem drogi (lub bieżącą lokalizacją pojazdu, jeśli ten punkt drogi jest pierwszy na liście punktów drogi) a tym punktem drogi w milisekundach.
location optional
Typ:  LatLngLiteral optional
Lokalizacja punktu orientacyjnego.
path optional
Typ:  Array<LatLngLiteral> optional
Ścieżka od poprzedniego punktu drogowego (lub bieżącej lokalizacji pojazdu, jeśli ten punkt drogowy jest pierwszy na liście punktów drogowych) do tego punktu drogowego.
speedReadingIntervals optional
Typ:  Array<SpeedReadingInterval> optional
Lista prędkości ruchu na trasie od poprzedniego punktu kontrolnego (lub lokalizacji pojazdu) do bieżącego punktu kontrolnego. Każdy przedział na liście opisuje ruch na ciągłym odcinku ścieżki; przedział definiuje punkty początkowy i końcowy segmentu za pomocą ich indeksów. Aby dowiedzieć się więcej, zapoznaj się z definicją SpeedReadingInterval.

Interfejs Pojazd

google.maps.journeySharing.Vehicleinterfejs

Szczegóły pojazdu zwrócone przez silnik floty.
attributes
Typ:  Object<string, *>
niestandardowe atrybuty pojazdu,
name
Typ:  string
W formacie „dostawcy/{identyfikator_dostawcy}/pojazdy/{identyfikator_pojazdu” Wartość vehicle_id musi być unikalnym identyfikatorem.
navigationStatus
Bieżący stan nawigacji pojazdu.
remainingDistanceMeters
Typ:  number
Pozostała odległość do przejechania na bieżącym odcinku trasy w metrach.
vehicleState
stan pojazdu;
vehicleType
Typ pojazdu.
currentRouteSegmentEndPoint optional
Typ:  TripWaypoint optional
Punkt drogowy, w którym kończy się bieżący segment trasy.
currentRouteSegmentVersion optional
Typ:  Date optional
Czas ustawienia bieżącego segmentu trasy.
currentTrips optional
Typ:  Array<string> optional
Lista identyfikatorów podróży przypisanych do tego pojazdu.
etaToFirstWaypoint optional
Typ:  Date optional
Przewidywany czas dojazdu do pierwszego wpisu w polu Waypoints.
latestLocation optional
Typ:  VehicleLocationUpdate optional
Ostatnia zgłoszona lokalizacja pojazdu.
maximumCapacity optional
Typ:  number optional
Łączna liczba pasażerów, których może przewieźć pojazd. W tej wartości nie uwzględnia się kierowcy.
supportedTripTypes optional
Typ:  Array<TripType> optional
Typy podróży obsługiwane przez ten pojazd.
waypoints optional
Typ:  Array<TripWaypoint> optional
Pozostałe punkty drogi przypisane do tego pojazdu.
waypointsVersion optional
Typ:  Date optional
Data ostatniej aktualizacji pola punktów orientacyjnych.

stałe VehicleNavigationStatus.

google.maps.journeySharing.VehicleNavigationStatus stałe

Bieżący stan nawigacji Vehicle.

Dostęp przez połączenie telefoniczne const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
ARRIVED_AT_DESTINATION Pojazd znajduje się w odległości około 50 m od miejsca docelowego.
ENROUTE_TO_DESTINATION Dostępna jest nawigacja zakręt po zakręcie, a nawigacja w aplikacji Kierowca przeszła w tryb GUIDED_NAV.
NO_GUIDANCE Nawigacja w aplikacji Kierowca jest w trybie FREE_NAV.
OFF_ROUTE Pojazd zjechał z zalecanej trasy.
UNKNOWN_NAVIGATION_STATUS Nieokreślony stan nawigacji.

VehicleState stałe

google.maps.journeySharing.VehicleState stałe

Bieżący stan Vehicle.

Dostęp przez połączenie telefoniczne const {VehicleState} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
OFFLINE Pojazd nie przyjmuje nowych rezerwacji.
ONLINE Pojazd przyjmuje nowe rezerwacje.
UNKNOWN_VEHICLE_STATE Nieznany stan pojazdu.

VehicleType stałe

google.maps.journeySharing.VehicleType stałe

Typ elementu Vehicle.

Dostęp przez połączenie telefoniczne const {VehicleType} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
AUTO Samochód.
TAXI Każdy pojazd, który pełni funkcję taksówki (zazwyczaj jest licencjonowany lub regulowany).
TRUCK Pojazd o dużej pojemności.
TWO_WHEELER motocykl, skuter lub inny dwukołowy pojazd;
UNKNOWN Nieznany typ pojazdu.

stałe TripType

google.maps.journeySharing.TripType stałe

Typy podróży obsługiwane przez Vehicle.

Dostęp przez połączenie telefoniczne const {TripType} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
EXCLUSIVE Podróż jest związana z jednym pojazdem.
SHARED Podróż może być realizowana tym samym pojazdem co inne.
UNKNOWN_TRIP_TYPE Nieznany typ podróży.

Interfejs TripWaypoint

google.maps.journeySharing.TripWaypointinterfejs

Typ przystanku podróży.
distanceMeters optional
Typ:  number optional
Odległość na ścieżce między poprzednim punktem drogi (lub bieżącą lokalizacją pojazdu, jeśli ten punkt drogi jest pierwszy na liście punktów drogi) a tym punktem drogi w metrach.
durationMillis optional
Typ:  number optional
Czas przejazdu między poprzednim punktem drogi (lub bieżącą lokalizacją pojazdu, jeśli ten punkt drogi jest pierwszy na liście punktów drogi) a tym punktem drogi w milisekundach.
location optional
Typ:  LatLng optional
Lokalizacja punktu orientacyjnego.
path optional
Typ:  Array<LatLng> optional
Ścieżka od poprzedniego przystanku (lub bieżącej lokalizacji pojazdu, jeśli ten przystanek jest pierwszy na liście przystanków) do tego przystanku.
speedReadingIntervals optional
Typ:  Array<SpeedReadingInterval> optional
Lista prędkości ruchu na trasie od poprzedniego punktu kontrolnego (lub lokalizacji pojazdu) do bieżącego punktu kontrolnego. Każdy przedział na liście opisuje ruch na ciągłym odcinku ścieżki; przedział definiuje punkty początkowy i końcowy segmentu za pomocą ich indeksów. Aby dowiedzieć się więcej, zapoznaj się z definicją SpeedReadingInterval.
tripId optional
Typ:  string optional
Podróż powiązana z tym punktem orientacyjnym.
waypointType optional
Typ:  WaypointType optional
Rola, jaką ten punkt kontrolny odgrywa w ramach danej podróży, np. odbiór lub odwóz.

stałe WaypointType

google.maps.journeySharing.WaypointType stałe

Typy punktów na trasie obsługiwane przez Vehicle.

Dostęp przez połączenie telefoniczne const {WaypointType} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
DROP_OFF_WAYPOINT_TYPE Punkty pośrednie dla miejsc wysadzenia pasażerów.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Punkty pośrednie na trasie z wieloma miejscami docelowymi.
PICKUP_WAYPOINT_TYPE Punkty pośrednie do odbierania pasażerów.
UNKNOWN_WAYPOINT_TYPE Nieznany typ punktu orientacyjnego.

Interfejs TimeWindow

google.maps.journeySharing.TimeWindowinterfejs

Zakres czasowy.
endTime
Typ:  Date
Godzina zakończenia przedziału czasowego (włącznie).
startTime
Typ:  Date
Czas rozpoczęcia przedziału czasu (włącznie).

Szybkość stałe

google.maps.journeySharing.Speed stałe

Klasyfikacja szybkości ścieżki na podstawie danych o ruchu.

Dostęp przez połączenie telefoniczne const {Speed} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
NORMAL Normalna prędkość, nie wykryto spowolnienia.
SLOW Wykryto spowolnienie, ale nie utworzyła się korka.
TRAFFIC_JAM Wykryto korek uliczny.

Interfejs SpeedReadingInterval

google.maps.journeySharing.SpeedReadingIntervalinterfejs

Wskaźnik gęstości ruchu na ciągłym fragmencie ścieżki. Interval określa punkty początkowy i końcowy segmentu za pomocą ich indeksów.
endPolylinePointIndex
Typ:  number
Indeks (liczony od 0) punktu końcowego przedziału na ścieżce.
speed
Typ:  Speed
Prędkość ruchu w tym przedziale czasu.
startPolylinePointIndex
Typ:  number
Indeks początkowy punktu początkowego przedziału na ścieżce (liczony od 0).