Method: providers.trips.search

Belirli bir aracın tüm seyahatlerini alın.

HTTP isteği

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud projesinin proje kimliği (örneğin, sample-cloud-project) olmalıdır.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
Alanlar
header

object (RequestHeader)

Standart Fleet Engine istek başlığı.
vehicleId

string

İstekteki gezilerle ilişkilendirilen araç. Belirtilmemesi halinde döndürülen geziler şunları içermez:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

Doğru değerine ayarlanırsa yanıt, sürücünün rotasını etkileyen Seyahatleri içerir.
pageSize

integer

Ayarlanmazsa döndürülecek sonuç sayısına sunucu karar verir.
pageToken

string

Önceki sonuçlardan devam etmek için bu değeri SearchTripsResponse içinde daha önce döndürülen bir değere ayarlayın.
minimumStaleness

string (Duration format)

Belirtilen durumda, (current - minimumStaleness) saatinden sonra güncellenmemiş gezileri döndürür.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

Yanıt gövdesi

trip.search yanıt mesajı verir.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
Alanlar
trips[]

object (Trip)

İstenen aracın seyahatlerinin listesi.
nextPageToken

string

Liste sonuçlarını sayfalamak için SearchTripsRequest'te bu jetonu iletin. API her çağrı için bir gezi listesi döndürür ve başka sonuç kalmadığında gezi listesi boş olur.