Method: providers.trips.search

किसी खास वाहन से की गई सभी यात्राओं की जानकारी पाएं.

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. providers/{provider} फ़ॉर्मैट में होना चाहिए. कंपनी को उस Google Cloud प्रोजेक्ट का प्रोजेक्ट आईडी (उदाहरण के लिए, sample-cloud-project) होना चाहिए जिसका सेवा खाता सदस्य के तौर पर कॉल कर रहा है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
फ़ील्ड
header

object (RequestHeader)

स्टैंडर्ड फ़्लीट इंजन अनुरोध हेडर.
vehicleId

string

अनुरोध में दी गई यात्राओं से जुड़ा वाहन. अगर जानकारी नहीं दी गई है, तो वापस की जाने वाली यात्राओं में ये चीज़ें शामिल नहीं होंगी:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

अगर वैल्यू को 'सही है' पर सेट किया जाता है, तो जवाब में वे यात्राएं शामिल होंगी जो ड्राइवर के रास्ते पर असर डालती हैं.
pageSize

integer

अगर इस नीति को सेट नहीं किया जाता है, तो सर्वर तय करता है कि कितने नतीजे दिखाने हैं.
pageToken

string

पिछले नतीजों से जारी रखने के लिए, इसे ऐसी वैल्यू पर सेट करें जो SearchTripsResponse में पहले दिखाई गई थी.
minimumStaleness

string (Duration format)

अगर बताया गया है, तो उन यात्राओं की जानकारी देता है जिन्हें (current - minimumStaleness) समय के बाद अपडेट नहीं किया गया है.

सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".

जवाब का मुख्य भाग

traffic.search का जवाब देने वाला मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
trips[]

object (Trip)

उस वाहन के लिए यात्राओं की सूची जिसका अनुरोध किया गया है.
nextPageToken

string

सूची के नतीजों में इस टोकन को SearchTripsRequest में पास करें. एपीआई हर कॉल के लिए यात्रा की सूची दिखाता है. कोई और नतीजा न मिलने पर, यात्रा की सूची खाली रहती है.