Fleet Engine Entities

Interfejs zadań

google.maps.journeySharing.Taskinterfejs

Szczegóły zadania zwrócone przez Fleet Engine.
attributes
Typ:  Object<string, *>
Atrybuty przypisane do zadania.
name
Typ:  string
Nazwa zadania w formacie „providers/{provider_id}/tasks/{task_id}”. Identyfikator zadania musi być niepowtarzalny i nie może być identyfikatorem śledzenia. Aby zapisać identyfikator śledzenia dostawy, użyj pola tracking_id. Wiele zadań może mieć ten sam identyfikator śledzenia.
remainingVehicleJourneySegments
Informacje o segmentach, które pozostały do ukończenia w ramach tego zadania.
status
Typ:  string
Bieżący stan wykonania zadania.
type
Typ:  string
Typ zadania, np. przerwa lub dostawa.
estimatedCompletionTime optional
Typ:  Date optional
Sygnatura czasowa szacowanego czasu ukończenia zadania.
latestVehicleLocationUpdate optional
Typ:  VehicleLocationUpdate optional
Informacje dotyczące ostatniej aktualizacji lokalizacji.
outcome optional
Typ:  string optional
Wynik zadania.
outcomeLocation optional
Typ:  LatLngLiteral optional
Lokalizacja, w której wykonano zadanie (podana przez wykonawcę).
outcomeLocationSource optional
Typ:  string optional
Ustawiający lokalizację wyniku zadania („PROVIDER” lub „LAST_VEHICLE_LOCATION”).
outcomeTime optional
Typ:  Date optional
Sygnatura czasowa ustawienia wyniku zadania (przez dostawcę).
plannedLocation optional
Typ:  LatLngLiteral optional
Lokalizacja, w której ma zostać wykonane zadanie.
targetTimeWindow optional
Typ:  TimeWindow optional
Przedział czasu, w którym należy wykonać zadanie.
trackingId optional
Typ:  string optional
Identyfikator śledzenia dostawy.
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
Dodatkowy czas potrzebny na wykonanie zadania w milisekundach.
id optional
Typ:  string optional
Identyfikator zadania.
targetTimeWindow optional
Typ:  TimeWindow optional
Przedział czasu, w którym należy wykonać zadanie.

Interfejs TaskTrackingInfo

google.maps.journeySharing.TaskTrackingInfointerfejs

Szczegóły obiektu informacji o śledzeniu zadania 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.
  • Znormalizowane zgodnie z formą normalizacji Unicode C.
  • Nie może zawierać żadnego z tych znaków ASCII: „/”, „:”, „?”, „,” ani „#”.
estimatedArrivalTime optional
Typ:  Date optional
Szacowany czas dotarcia do miejsca przystanku.
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
Lokalizacja, w której zostanie wykonane zadanie.
remainingDrivingDistanceMeters optional
Typ:  number optional
Całkowita pozostała odległość w metrach do VehicleStop.
remainingStopCount optional
Typ:  number optional
Wskazuje liczbę przystanków pozostałych do osiągnięcia przystanku zadania, w tym przystanku zadania. Jeśli na przykład następnym przystankiem pojazdu jest przystanek zadania, wartość będzie wynosić 1.
routePolylinePoints optional
Typ:  Array<LatLng> optional
Lista punktów, które po połączeniu tworzą linię łamaną przedstawiającą oczekiwaną trasę pojazdu do miejsca wykonania tego zadania.
state optional
Typ:  string optional
Bieżący stan wykonania zadania.
targetTimeWindow optional
Typ:  TimeWindow optional
Przedział czasu, 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 dostawca ustawił wynik zadania.

Interfejs podróży

google.maps.journeySharing.Tripinterfejs

Szczegóły podróży zwrócone przez Fleet Engine.
name
Typ:  string
W formacie „providers/{provider_id}/trips/{trip_id}”. Identyfikator trip_id musi być unikalny.
passengerCount
Typ:  number
Liczba pasażerów w tej podróży (nie obejmuje kierowcy).
remainingWaypoints
Tablica punktów pośrednich wskazujących trasę od bieżącej lokalizacji do miejsca 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
Rodzaj podróży. Możliwe wartości to UNKNOWN_TRIP_TYPE, SHARED lub EXCLUSIVE.
vehicleId
Typ:  string
Identyfikator pojazdu odbywającego tę podróż.
actualDropOffLocation optional
Typ:  LatLngLiteral optional
Miejsce, w którym klient wysiadł.
actualPickupLocation optional
Typ:  LatLngLiteral optional
Miejsce, w którym klient został odebrany.
dropOffTime optional
Typ:  Date optional
Szacowana przyszła godzina, o której pasażerowie zostaną wysadzeni, lub faktyczna godzina, o której zostali wysadzeni.
latestVehicleLocationUpdate optional
Typ:  VehicleLocationUpdate optional
Informacje dotyczące ostatniej aktualizacji lokalizacji.
pickupTime optional
Typ:  Date optional
Szacowana przyszła godzina odbioru pasażerów lub faktyczna godzina odbioru.
plannedDropOffLocation optional
Typ:  LatLngLiteral optional
Lokalizacja, w której klient chce wysiąść.
plannedPickupLocation optional
Typ:  LatLngLiteral optional
Lokalizacja, w której klient wskazuje, że chce zostać odebrany.

DeliveryVehicle interfejs

google.maps.journeySharing.DeliveryVehicleinterfejs

Szczegóły pojazdu dostawczego zwrócone przez Fleet Engine.
attributes
Typ:  Object<string, string optional>
atrybuty niestandardowego pojazdu dostawczego,
name
Typ:  string
W formacie „providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}”. Identyfikator delivery_vehicle_id musi być unikalny.
navigationStatus
Typ:  string
Bieżący stan nawigacji pojazdu.
remainingDistanceMeters
Typ:  number
Pozostała odległość do przejechania w bieżącym segmencie trasy w metrach.
remainingVehicleJourneySegments
Odcinki podróży przypisane do tego pojazdu dostawczego, począwszy od ostatnio zgłoszonej lokalizacji pojazdu. To pole jest wypełniane tylko wtedy, gdy obiekt danych DeliveryVehicle jest dostarczany za pomocą FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Typ:  LatLngLiteral optional
Miejsce, w którym kończy się bieżący odcinek 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).

DeliveryVehicleStop interfejs

google.maps.journeySharing.DeliveryVehicleStopinterfejs

Typ DeliveryVehicleStop
tasks
Typ:  Array<TaskInfo>
Lista zadań do wykonania na tym przystanku.
  • id: identyfikator zadania.
  • extraDurationMillis: dodatkowy czas potrzebny na wykonanie 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 pod numer const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
ARRIVED Dotarcie na przystanek. Zakłada, że gdy pojazd jedzie do następnego przystanku, wszystkie poprzednie przystanki zostały już obsłużone.
ENROUTE Przypisane i aktywnie kierowane.
NEW Utworzono, ale nie przekierowuje aktywnie.
UNSPECIFIED Nieznany.

VehicleJourneySegment interfejs

google.maps.journeySharing.VehicleJourneySegmentinterfejs

Typ VehicleJourneySegment
drivingDistanceMeters optional
Typ:  number optional
Odległość podróży od poprzedniego przystanku do tego przystanku w metrach.
drivingDurationMillis optional
Typ:  number optional
Czas podróży 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 pierwszym na liście przystanków) do tego przystanku.
stop optional
Typ:  DeliveryVehicleStop optional
Informacje o przystanku.

VehicleLocationUpdate interface

google.maps.journeySharing.VehicleLocationUpdateinterfejs

Typ VehicleLocationUpdate
heading optional
Typ:  number optional
Nagłówek aktualizacji. 0 oznacza północ, a 180 – południe.
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.

VehicleWaypoint interfejs

google.maps.journeySharing.VehicleWaypointinterfejs

Typ VehicleWaypoint.
distanceMeters optional
Typ:  number optional
Odległość na ścieżce od poprzedniego punktu pośredniego (lub bieżącej lokalizacji pojazdu, jeśli ten punkt pośredni jest pierwszym na liście punktów pośrednich) do tego punktu pośredniego w metrach.
durationMillis optional
Typ:  number optional
Czas podróży od poprzedniego punktu trasy (lub od aktualnej lokalizacji pojazdu, jeśli ten punkt trasy jest pierwszym na liście punktów trasy) do tego punktu trasy w milisekundach.
location optional
Typ:  LatLngLiteral optional
Lokalizacja punktu pośredniego.
path optional
Typ:  Array<LatLngLiteral> optional
Ścieżka od poprzedniego punktu trasy (lub bieżącej lokalizacji pojazdu, jeśli ten punkt trasy jest pierwszym na liście) do tego punktu trasy.
speedReadingIntervals optional
Typ:  Array<SpeedReadingInterval> optional
Lista prędkości ruchu na trasie od poprzedniego punktu pośredniego (lub lokalizacji pojazdu) do bieżącego punktu pośredniego. Każdy przedział na liście opisuje ruch na ciągłym odcinku ścieżki. Przedział określa punkty początkowe i końcowe odcinka za pomocą indeksów. Więcej informacji znajdziesz w definicji SpeedReadingInterval.

Interfejs pojazdu

google.maps.journeySharing.Vehicleinterfejs

Szczegóły pojazdu zwrócone przez Fleet Engine.
attributes
Typ:  Object<string, *>
niestandardowe atrybuty pojazdu,
name
Typ:  string
W formacie „providers/{provider_id}/vehicles/{vehicle_id}”. Identyfikator pojazdu musi być unikalny.
navigationStatus
Bieżący stan nawigacji pojazdu.
remainingDistanceMeters
Typ:  number
Pozostała odległość do przejechania w bieżącym segmencie trasy w metrach.
vehicleState
Stan pojazdu.
vehicleType
Typ pojazdu.
currentRouteSegmentEndPoint optional
Typ:  TripWaypoint optional
Punkt pośredni, w którym kończy się bieżący segment trasy.
currentRouteSegmentVersion optional
Typ:  Date optional
Czas, w którym ustawiono bieżący segment trasy.
currentTrips optional
Typ:  Array<string> optional
Lista identyfikatorów podróży przypisanych obecnie do tego pojazdu.
etaToFirstWaypoint optional
Typ:  Date optional
Szacowany czas dotarcia do pierwszego wpisu w polu punktów pośrednich.
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źć ten pojazd. Kierowca nie jest uwzględniany w tej wartości.
supportedTripTypes optional
Typ:  Array<TripType> optional
Typy przejazdów obsługiwane przez ten pojazd.
waypoints optional
Typ:  Array<TripWaypoint> optional
Pozostałe punkty trasy przypisane do tego pojazdu.
waypointsVersion optional
Typ:  Date optional
Ostatnia aktualizacja pola punktów pośrednich.

VehicleNavigationStatus stałe

google.maps.journeySharing.VehicleNavigationStatus stałe

Bieżący stan nawigacji Vehicle.

Dostęp przez połączenie pod numer 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 Nawigacja zakręt po zakręcie jest dostępna, a nawigacja w aplikacji dla kierowców weszła w tryb GUIDED_NAV.
NO_GUIDANCE Nawigacja w aplikacji kierowcy jest w trybie FREE_NAV.
OFF_ROUTE Pojazd zjechał z sugerowanej 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 pod numer const {VehicleState} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
OFFLINE Pojazd nie przyjmuje nowych przejazdów.
ONLINE Pojazd przyjmuje nowe przejazdy.
UNKNOWN_VEHICLE_STATE Nieznany stan pojazdu.

VehicleType stałe

google.maps.journeySharing.VehicleType stałe

Typ elementu Vehicle.

Dostęp przez połączenie pod numer const {VehicleType} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
AUTO samochód,
TAXI Pojazdy pełniące funkcję taksówki (zwykle licencjonowane lub regulowane).
TRUCK Pojazd o dużej pojemności.
TWO_WHEELER motocykl, skuter lub inny pojazd dwukołowy;
UNKNOWN Nieznany typ pojazdu.

Stałe TripType

google.maps.journeySharing.TripType stałe

Rodzaje przejazdów obsługiwane przez Vehicle.

Dostęp przez połączenie pod numer const {TripType} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
EXCLUSIVE Podróż jest przeznaczona tylko dla pojazdu.
SHARED Podczas przejazdu może się zdarzyć, że będziesz przewożony(-a) z innymi osobami.
UNKNOWN_TRIP_TYPE Nieznany typ przejazdu.

TripWaypoint interfejs

google.maps.journeySharing.TripWaypointinterfejs

Typ TripWaypoint.
distanceMeters optional
Typ:  number optional
Odległość na ścieżce od poprzedniego punktu pośredniego (lub bieżącej lokalizacji pojazdu, jeśli ten punkt pośredni jest pierwszym na liście punktów pośrednich) do tego punktu pośredniego w metrach.
durationMillis optional
Typ:  number optional
Czas podróży od poprzedniego punktu trasy (lub od aktualnej lokalizacji pojazdu, jeśli ten punkt trasy jest pierwszym na liście punktów trasy) do tego punktu trasy w milisekundach.
location optional
Typ:  LatLng optional
Lokalizacja punktu pośredniego.
path optional
Typ:  Array<LatLng> optional
Ścieżka od poprzedniego przystanku (lub bieżącej lokalizacji pojazdu, jeśli ten przystanek jest pierwszym na liście przystanków) do tego przystanku.
speedReadingIntervals optional
Typ:  Array<SpeedReadingInterval> optional
Lista prędkości ruchu na trasie od poprzedniego punktu pośredniego (lub lokalizacji pojazdu) do bieżącego punktu pośredniego. Każdy przedział na liście opisuje ruch na ciągłym odcinku ścieżki. Przedział określa punkty początkowe i końcowe odcinka za pomocą indeksów. Więcej informacji znajdziesz w definicji SpeedReadingInterval.
tripId optional
Typ:  string optional
Podróż powiązana z tym punktem trasy.
waypointType optional
Typ:  WaypointType optional
Rola tego punktu na trasie, np. odbiór lub wysadzenie.

WaypointType stałe

google.maps.journeySharing.WaypointType stałe

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

Dostęp przez połączenie pod numer const {WaypointType} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
DROP_OFF_WAYPOINT_TYPE punkty pośrednie do wysadzania pasażerów;
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Punkty pośrednie w podróży do wielu miejsc docelowych.
PICKUP_WAYPOINT_TYPE Punkty odbioru pasażerów.
UNKNOWN_WAYPOINT_TYPE Nieznany typ punktu pośredniego.

Interfejs TimeWindow

google.maps.journeySharing.TimeWindowinterfejs

zakres czasu.
endTime
Typ:  Date
Godzina zakończenia przedziału czasu (włącznie z wartościami granicznymi).
startTime
Typ:  Date
Godzina rozpoczęcia przedziału czasu (włącznie).

Stałe szybkości

google.maps.journeySharing.Speed stałe

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

Dostęp przez połączenie pod numer 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ł się korek.
TRAFFIC_JAM Wykryto korek.

SpeedReadingInterval interfejs

google.maps.journeySharing.SpeedReadingIntervalinterfejs

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