Method: providers.vehicles.searchFuzzed

{
  "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)

Wymagany. Punkt odbioru, który chcesz wyszukać.

object (TerminalLocation)

Zamierzone miejsce docelowe zwrotu kosztów przez klienta. To pole jest wymagane, jeśli tripTypes zawiera wartość TripType.SHARED.

integer

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

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

integer

Wymagany. Określa liczbę pasażerów uwzględnianych podczas podróży. Wartość nie może być mniejsza niż 1. Kierowca nie jest brany pod uwagę przy określaniu pojemności.

enum (TripType)

Wymagany. Określa typ proponowanej podróży. Kwalifikujące się pojazdy to takie, które mogą obsłużyć co najmniej 1 z określonych typów podróży.

EXCLUSIVE i SHARED mogą nie zostać uwzględnione razem. Pole SHARED nie jest obsługiwane, gdy currentTripsPresent ma wartość CURRENT_TRIPS_PRESENT_UNSPECIFIED. Element UNKNOWN_TRIP_TYPE jest niedozwolony.

string (Duration format)

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

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

object (VehicleType)

Wymagany. Ogranicza wyszukiwanie do pojazdów określonego typu. Musisz określić co najmniej jeden typ pojazdu. Obiekty VehicleType z kategorii UNKNOWN są niedozwolone.

object (VehicleAttribute)

Wywołujący mogą wykonywać złożone operacje logiczne przy użyciu dowolnej kombinacji pól requiredAttributes, requiredOneOfAttributes i requiredOneOfAttributeSets.

requiredAttributes jest listą, a requiredOneOfAttributes używa wiadomości, która umożliwia użycie listy. W połączeniu te 2 pola umożliwiają tworzenie tego 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 tych pojazdów o określonych atrybutach. To pole jest połączeniem/ORAZ. Dozwolonych jest maksymalnie 50 atrybutów wymaganych. Ta wartość odpowiada maksymalnej liczbie atrybutów dozwolonych w pojeździe.

object (VehicleAttributeList)

Ogranicza wyszukiwanie tylko do pojazdów, które mają co najmniej 1 z określonych atrybutów w każdym atrybucie VehicleAttributeList. Pojazd musi pasować do co najmniej jednego z atrybutów na każdej liście. To pole jest uwzględnioną operacją łączenia/LUB w każdym z tych elementów: VehicleAttributeList i operacją spójną/ORAZ w zbiorze pola VehicleAttributeList.

object (VehicleAttributeList)

requiredOneOfAttributeSets oferuje dodatkowe funkcje.

Podobnie jak w przypadku requiredOneOfAttributes, requiredOneOfAttributeSets używa komunikatu, który zezwala na listę list i zezwala na wyrażenia takie 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 pojazdów ze wszystkimi atrybutami w grupie VehicleAttributeList. Pojazd z każdej listy musi pasować do wszystkich atrybutów. To pole jest operacją spójną/ORAZ w każdym elemencie VehicleAttributeList i uwzględniającą operację oddzielenia/LUB w zbiorze danych VehicleAttributeList.

enum (VehicleMatchOrder)

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

boolean

Wskazuje, czy pojazd z jedną aktywną podróżą kwalifikuje się do kolejnego dopasowania. Jeśli ustawiona jest wartość false, pojazdy z przypisanymi podróżami są wykluczone z wyników wyszukiwania. Jeśli ustawiona jest wartość true, wyniki wyszukiwania obejmują pojazdy z TripStatus o wartości ENROUTE_TO_DROPOFF.

To pole jest uwzględniane tylko wtedy, gdy określono pojedynczy element tripType z EXCLUSIVE.

Wartością domyślną jest false.

string

Wskazuje podróż powiązaną z tym obiektem (SearchVehicleRequest).

enum (CurrentTripsPresent)

Ogranicza wyświetlanie pojazdów w wynikach wyszukiwania na podstawie ich bieżących tras.

Gdy obecna jest wartość NONE lub ANY, tripTypes może mieć wartość EXCLUSIVE lub SHARED, ale nie obie jednocześnie.

string

Opcjonalnie. Zapytanie filtra, które ma być stosowane podczas wyszukiwania 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 podana jest wartość, która nie jest pusta, pola requiredAttributes, requiredOneOfAttributes i required_one_of_attributes_sets muszą być puste.

Ten filtr działa jako klauzula AND 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ń dozwolonych w zapytaniu filtra to 50.

Poza tym wszystkie atrybuty są przechowywane jako ciągi znaków, więc jedynymi obsługiwanymi porównaniami atrybutów są porównania ciągów znaków. Aby możliwe było porównanie z wartościami liczbowymi lub logicznymi, wartości muszą być wyraźnie ujęte w cudzysłów (np. attributes.<key> = "10" lub attributes.<key> = "true").