Method: providers.vehicles.search

{
  "header": {
    object (RequestHeader)
  },
  "pickupPoint": {
    object (TerminalLocation)
  },
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "tripTypes": [
    enum (TripType)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleType)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeList)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeList)
    }
  ],
  "orderBy": enum (VehicleMatchOrder),
  "includeBackToBack": boolean,
  "tripId": string,
  "currentTripsPresent": enum (CurrentTripsPresent),
  "filter": string
}

object (RequestHeader)

Standardowy nagłówek żądania Fleet Engine.

object (TerminalLocation)

Wymagane. Położony w pobliżu punkt odbioru, który chcesz wyszukać.

object (TerminalLocation)

Zamierzone miejsce docelowe zwrotu klienta. Pole jest wymagane, jeśli tripTypes zawiera TripType.SHARED.

integer

Wymagane. Określa promień wyszukiwania pojazdu wokół punktu odbioru. Zwrócone zostaną tylko pojazdy znajdujące się w określonym promieniu wyszukiwania. Wartość musi mieścić się w przedziale od 400 do 10 000 metrów (włącznie).

integer

Wymagane. Określa maksymalną liczbę pojazdów do zwrócenia. Wartość musi mieścić się w przedziale od 1 do 50 (włącznie).

integer

Wymagane. Określa liczbę pasażerów uwzględnianych podczas podróży. Wartość nie może być mniejsza niż 1. W zakresie pojemności nie brany jest pod uwagę kierowca.

enum (TripType)

Wymagane. Reprezentuje typ proponowanej podróży. Musi zawierać dokładnie 1 typ. UNKNOWN_TRIP_TYPE – to jest niedozwolone. Ogranicza wyszukiwanie tylko do tych pojazdów, które mogą obsłużyć dany typ podróży.

string (Duration format)

Ogranicza wyszukiwanie tylko do tych pojazdów, które w określonym czasie wysłały do Fleet Engine aktualizacje lokalizacji. Nieruchome pojazdy przesyłające swoją lokalizację nie są uznawane za nieaktualne. Jeśli to pole nie jest skonfigurowane, serwer używa wartości domyślnej 5 minut.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

object (VehicleType)

Wymagane. Ogranicza wyszukiwanie do pojazdów jednego z określonych typów. Musisz określić co najmniej jeden typ pojazdu. Typy pojazdów z kategorii UNKNOWN są niedozwolone.

object (VehicleAttribute)

Wywołujący mogą tworzyć złożone operacje logiczne, korzystając z dowolnej kombinacji pól requiredAttributes, requiredOneOfAttributes i requiredOneOfAttributeSets.

requiredAttributes jest listą; requiredOneOfAttributes używa wiadomości, która może być listą list. Łącząc te 2 pola, można utworzyć kompozycję wyrażenia:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

Ogranicza wyszukiwanie tylko do pojazdów o określonych atrybutach. To pole jest łączeniem/ORAZ. Dozwolonych jest maksymalnie 50 atrybutów wymaganych. Ta wartość jest zgodna z maksymalną liczbą atrybutów dozwolonych w pojeździe.

object (VehicleAttributeList)

Ogranicza wyszukiwanie tylko do tych pojazdów, które mają co najmniej jeden z określonych atrybutów w każdym atrybucie VehicleAttributeList. Na każdej liście pojazd musi pasować do co najmniej jednego z atrybutów. To pole zawiera operację rozłączania/LUB w każdym obiekcie VehicleAttributeList oraz operacji łączenia/ORAZ w zbiorze danych VehicleAttributeList.

object (VehicleAttributeList)

requiredOneOfAttributeSets udostępnia dodatkowe funkcje.

Podobnie jak requiredOneOfAttributes, requiredOneOfAttributeSets używa wiadomości, która zezwala na tworzenie listy z wyrażeniami takimi jak ta:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

Ogranicza wyszukiwanie tylko do tych pojazdów ze wszystkimi atrybutami marki VehicleAttributeList. Pojazd musi pasować do wszystkich atrybutów na każdej liście. To pole jest łączoną operacji/ORAZ w każdej funkcji VehicleAttributeList i uwzględniającą operację rozdzielenia/LUB w zbiorze danych VehicleAttributeList.

enum (VehicleMatchOrder)

Wymagane. Określa żądane kryterium kolejności wyników.

boolean

Ta wartość określa, czy pojazdy z 1 aktywną podróżą kwalifikują się do tego wyszukiwania. To pole jest używane tylko wtedy, gdy pole currentTripsPresent jest nieokreślone. Gdy nie określono atrybutu currentTripsPresent, a to pole zawiera wartość false, pojazdy z przypisanymi podróżami są wykluczane z wyników wyszukiwania. Gdy pole currentTripsPresent nie jest określone, a to pole ma wartość true, wyniki wyszukiwania mogą uwzględniać pojazdy z jedną aktywną podróżą ze stanem ENROUTE_TO_DROPOFF. Jeśli pole currentTripsPresent jest określone, nie można ustawić wartości prawda.

Wartością domyślną jest false.

string

Wskazuje podróż powiązaną z obiektem SearchVehicleRequest.

enum (CurrentTripsPresent)

Ta wartość określa, czy pojazdy z aktywnymi podróżami kwalifikują się do tego wyszukiwania. Jeśli zasada tripType zawiera SHARED, ta wartość musi być inna niż CURRENT_TRIPS_PRESENT_UNSPECIFIED.

string

Opcjonalnie. Zapytanie filtra, które ma być stosowane przy wyszukiwaniu pojazdów. Przykłady składni filtra znajdziesz na http://aip.dev/160.

To pole zastępuje pola requiredAttributes, requiredOneOfAttributes i required_one_of_attributes_sets. Jeśli określona jest wartość, która nie jest pusta, te pola muszą być puste: requiredAttributes, requiredOneOfAttributes i required_one_of_attributes_sets.

Ten filtr działa jak klauzula ORAZ z innymi ograniczeniami, takimi jak minimumCapacity lub vehicleTypes.

Pamiętaj, że obsługiwane są tylko zapytania dotyczące atrybutów pojazdu (np. attributes.<key> = <value> lub attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Maksymalna liczba ograniczeń dozwolona w zapytaniu filtra to 50.

Poza tym wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedynymi obsługiwanymi porównaniami z atrybutami są porównania w postaci ciągów znaków. Aby można było porównać wartości z liczbami lub wartościami logicznymi, muszą one być ujęte w cudzysłów, aby były traktowane jako ciągi znaków (np. attributes.<key> = "10" lub attributes.<key> = "true").