REST Resource: providers.vehicles

संसाधन: वाहन

वाहन का मेटाडेटा.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. इस वाहन का खास नाम. फ़ॉर्मैट providers/{provider}/vehicles/{vehicle} है.
vehicleState

enum (VehicleState)

वाहन की स्थिति.
supportedTripTypes[]

enum (TripType)

इस वाहन से की जाने वाली यात्रा के टाइप.
currentTrips[]

string

सिर्फ़ आउटपुट के लिए. फ़िलहाल, इस वाहन को असाइन की गई यात्राओं के लिए tripId की सूची.
lastLocation

object (VehicleLocation)

वाहन को आखिरी बार जगह की जानकारी के तौर पर रिपोर्ट किया गया.
maximumCapacity

integer

इस वाहन में कुल कितने यात्रियों को ले जाया जा सकता है. इस वैल्यू में ड्राइवर को शामिल नहीं किया गया है. यह वैल्यू, इससे ज़्यादा या इसके बराबर होनी चाहिए.
attributes[]

object (VehicleAttribute)

वाहन की विशेषताओं की सूची. किसी वाहन में ज़्यादा से ज़्यादा 100 एट्रिब्यूट हो सकते हैं और हर एट्रिब्यूट की एक खास कुंजी होनी चाहिए.
vehicleType

object (VehicleType)

ज़रूरी है. यह वाहन किस तरह का है. vehicles.search नतीजों में, वाहनों को फ़िल्टर करने के लिए इस्तेमाल किया जा सकता है. ETA और रास्ते की गणना भी करता है.
licensePlate

object (LicensePlate)

वाहन के लिए लाइसेंस प्लेट की जानकारी.
route[]
(deprecated)

object (TerminalLocation)

अब सेवा में नहीं है: इसके बजाय Vehicle.waypoints का इस्तेमाल करें.
currentRouteSegment

string

ड्राइवर ऐप्लिकेशन को अगले वेपॉइंट पर जाने के लिए जिस रास्ते पर जाना है उसके बारे में बताने वाली पॉलीलाइन. यह सूची, Trip.current_route_segment में उन सभी चालू यात्राओं के लिए भी दिखाई जाती है जो वाहन के लिए असाइन किए गए हैं.

ध्यान दें: यह फ़ील्ड सिर्फ़ ड्राइवर SDK टूल के इस्तेमाल के लिए है. डिकोड करने की सुविधा फ़िलहाल उपलब्ध नहीं है.
currentRouteSegmentTraffic

object (TrafficPolylineData)

सिर्फ़ इनपुट. Fleet Engine, यात्रा के डेटा को शेयर करने की सुविधा को बेहतर बनाने के लिए, इस जानकारी का इस्तेमाल करता है. ध्यान दें: यह फ़ील्ड सिर्फ़ ड्राइवर SDK टूल के इस्तेमाल के लिए है.
currentRouteSegmentVersion

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब currentRouteSegment को सेट किया गया था. इसे क्लाइंट सेव कर सकता है और आने वाले समय के vehicles.get अनुरोधों में पास कर सकता है. इससे उन रूट को रोका जा सकेगा जिन्हें बदला नहीं गया है.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
currentRouteSegmentEndPoint

object (TripWaypoint)

वह पॉइंट जहां से currentRouteSegment खत्म होता है. ड्राइवर vehicles.update कॉल पर यह जानकारी दे सकते हैं, जैसे कि यात्रा की पूरी जगह, वेपॉइंट LatLng या फिर currentRouteSegment के आखिरी LatLng के तौर पर. इसके बाद, अगर फ़्लीट इंजन पूरी तरह से तय नहीं किया गया है, तो वह असल वेपॉइंट का अनुमान लगाने की पूरी कोशिश करेगा. अगर currentRouteSegment भी तय नहीं किया गया है, तो vehicles.update कॉल में इस फ़ील्ड को अनदेखा कर दिया जाता है.
remainingDistanceMeters

integer

currentRouteSegment के लिए शेष ड्राइविंग दूरी. यह वैल्यू, वाहन को असाइन की गई सभी चालू यात्राओं के लिए Trip.remaining_distance_meters में भी दिखाई जाती है. अगर currentRouteSegment फ़ील्ड खाली है, तो वैल्यू की जानकारी नहीं दी जाती.
etaToFirstWaypoint

string (Timestamp format)

waypoints फ़ील्ड में पहली एंट्री का ETA. अगर waypoints फ़ील्ड खाली है या Vehicle.current_route_segment फ़ील्ड खाली है, तो वैल्यू की जानकारी नहीं दी गई है.

वाहन की जानकारी अपडेट करते समय, remainingTimeSeconds को उसी अनुरोध में etaToFirstWaypoint से ज़्यादा प्राथमिकता दी जाती है.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
remainingTimeSeconds

integer

सिर्फ़ इनपुट. currentRouteSegment के लिए ड्राइविंग में लगने वाला बाकी समय. अगर waypoints फ़ील्ड खाली है या Vehicle.current_route_segment फ़ील्ड खाली है, तो वैल्यू की जानकारी नहीं दी गई है. अगर सभी पक्ष एक ही घड़ी का इस्तेमाल कर रहे हैं, तो यह वैल्यू etaToFirstWaypoint - current_time से मेल खानी चाहिए.

वाहन की जानकारी अपडेट करते समय, remainingTimeSeconds को उसी अनुरोध में etaToFirstWaypoint से ज़्यादा प्राथमिकता दी जाती है.
waypoints[]

object (TripWaypoint)

इस वाहन को असाइन किए गए बाकी वेपॉइंट.
waypointsVersion

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पिछली बार waypoints फ़ील्ड को अपडेट किए जाने का समय. क्लाइंट को यह वैल्यू कैश मेमोरी में सेव करनी चाहिए और इसे GetVehicleRequest में पास करना चाहिए, ताकि यह पक्का किया जा सके कि waypoints फ़ील्ड को अपडेट करने पर ही इसे लौटाया जाए.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
backToBackEnabled

boolean

यह बताता है कि ड्राइवर एक-दूसरे के साथ जाने की सुविधा देता है या नहीं. true, vehicles.search में वाहन शामिल हो सकता है, भले ही उसे यात्रा के लिए असाइन किया गया हो. डिफ़ॉल्ट वैल्यू false है.
navigationStatus

enum (NavigationStatus)

वाहन की नेविगेशन स्थिति.
deviceSettings

object (DeviceSettings)

सिर्फ़ इनपुट. ड्राइवर के इस्तेमाल किए जा रहे मोबाइल डिवाइस की सेटिंग के बारे में जानकारी.

VehicleState

Vehicle की स्थिति.

Enums
UNKNOWN_VEHICLE_STATE डिफ़ॉल्ट, इसका इस्तेमाल उन स्थितियों के लिए किया जाता है जिनके बारे में जानकारी नहीं है या जिनकी पहचान नहीं की जा सकी.
OFFLINE वाहन नई यात्राओं को स्वीकार नहीं कर रहा है. ध्यान दें: असाइन की गई यात्रा पूरी होने के दौरान, वाहन इसी स्थिति में काम करता रहेगा.
ONLINE वाहन नई यात्राओं को स्वीकार कर रहा है.

VehicleAttribute

यह वाहन एट्रिब्यूट को की-वैल्यू पेयर के तौर पर बताता है. "key:value" स्ट्रिंग में 256 से ज़्यादा वर्ण नहीं हो सकते.

जेएसओएन के काेड में दिखाना 
{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}
फ़ील्ड
key

string

विशेषता की कुंजी. कुंजियों में कोलन वर्ण (:) नहीं हो सकता.
value

string

एट्रिब्यूट की वैल्यू.
यूनियन फ़ील्ड vehicle_attribute_value. विशेषता का मान स्ट्रिंग, बूल या डबल टाइप में हो सकता है. vehicle_attribute_value इनमें से सिर्फ़ एक हो सकता है:
stringValue

string

स्ट्रिंग के टाइप किए गए एट्रिब्यूट की वैल्यू.

ध्यान दें: यह value फ़ील्ड के जैसा है, जिसे आने वाले समय में बंद कर दिया जाएगा. बनाने या अपडेट करने के तरीकों के लिए, किसी भी फ़ील्ड का इस्तेमाल किया जा सकता है. हालांकि, हमारा सुझाव है कि आप stringValue का इस्तेमाल करें. अगर stringValue और value, दोनों सेट हैं, तो दोनों एक जैसे होने चाहिए. ऐसा न करने पर, आपको गड़बड़ी का मैसेज दिखेगा. दोनों फ़ील्ड में डेटा अपने-आप भर जाता है.
boolValue

boolean

बूलियन टाइप की गई विशेषता का मान.
numberValue

number

दो बार टाइप की गई विशेषता मान.

VehicleType

वाहन किस तरह का है.

जेएसओएन के काेड में दिखाना 
{
  "category": enum (Category)
}
फ़ील्ड
category

enum (Category)

वाहन किस तरह का है

कैटगरी

वाहन के टाइप की कैटगरी

Enums
UNKNOWN डिफ़ॉल्ट विकल्प का इस्तेमाल, वाहन की ऐसी कैटगरी के लिए किया जाता है जिनके बारे में जानकारी नहीं है या जिनकी पहचान नहीं हुई है.
AUTO एक ऑटोमोबाइल.
TAXI कोई भी ऐसा वाहन जो टैक्सी के तौर पर काम करता है (आम तौर पर, लाइसेंस मिला है या कानूनी नियंत्रण में है).
TRUCK आम तौर पर, ऐसा वाहन जिसके डिवाइस का स्टोरेज ज़्यादा होता है.
TWO_WHEELER मोटरसाइकल, मोपेड या दोपहिया वाहन
BICYCLE इंसानों से चलने वाला परिवहन.
PEDESTRIAN पैदल चलने वाले रास्तों पर चलते हुए या दौड़ता हुआ मानव ट्रांसपोर्टर.

LicensePlate

वाहन की लाइसेंस प्लेट की जानकारी. व्यक्तिगत पहचान से जुड़ी जानकारी को सेव करने से बचने के लिए, लाइसेंस प्लेट के बारे में सिर्फ़ कम से कम जानकारी को इकाई के हिस्से के रूप में सेव किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "countryCode": string,
  "lastCharacter": string
}
फ़ील्ड
countryCode

string

ज़रूरी है. CLDR देश/क्षेत्र का कोड. उदाहरण के लिए, अमेरिका के लिए US या भारत के लिए IN.
lastCharacter

string

लाइसेंस प्लेट का आखिरी अंक या "-1" होता है, जो यह बताता है कि लाइसेंस प्लेट में कोई न्यूमेरिक वैल्यू नहीं है.

  • "ABC 1234" -> "4"
  • "AB 123 CD" -> "3"
  • "ABCDEF" -> "-1"

TrafficPolylineData

वाहन के रास्ते में ट्रैफ़िक का हाल.

जेएसओएन के काेड में दिखाना 
{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}
फ़ील्ड
trafficRendering

object (VisualTrafficReportPolylineRendering)

एक पॉलीलाइन रेंडरिंग, जो दिखाती है कि ग्राहक राइड के किसी एक हिस्से में सभी इलाकों के लिए ट्रैफ़िक कितना तेज़ है.

VisualTrafficReportPolylineRendering

यह बताता है कि क्लाइंट को रास्ते में पड़ने वाली पॉलीलाइन के एक हिस्से को किस तरह रंगना चाहिए.

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

object (RoadStretch)

ज़रूरी नहीं. सड़क का वह हिस्सा जो पॉलीलाइन के साथ दिखना चाहिए. इस बात की गारंटी है कि खिंचाव यानी हिस्से ओवरलैप नहीं होंगे और यह ज़रूरी नहीं है कि वे पूरे रूट में फैले.

स्टाइल के लिए कोई सड़क विस्तार न होने पर, क्लाइंट को रूट के लिए डिफ़ॉल्ट लागू करना चाहिए.

RoadStretch

एक सड़क फैलाव जिसे रेंडर किया जाना चाहिए.

जेएसओएन के काेड में दिखाना 
{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}
फ़ील्ड
style

enum (Style)

ज़रूरी है. लागू की जाने वाली स्टाइल.
offsetMeters

integer

ज़रूरी है. शैली [offsetMeters, offsetMeters + lengthMeters) के बीच लागू होनी चाहिए.
lengthMeters

integer

ज़रूरी है. उस पाथ की लंबाई जहां शैली लागू करनी है.

स्टाइल

ट्रैफ़िक की स्टाइल, जिससे ट्रैफ़िक की स्पीड दिखती है.

Enums
STYLE_UNSPECIFIED कोई स्टाइल नहीं चुनी गई.
SLOWER_TRAFFIC ट्रैफ़िक कम हो रहा है.
TRAFFIC_JAM ट्रैफ़िक जाम है.

DeviceSettings

मोबाइल डिवाइस पर कई सेटिंग के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}
फ़ील्ड
locationPowerSaveMode

enum (LocationPowerSaveMode)

बैटरी सेवर के चालू होने पर जगह की जानकारी से जुड़ी सुविधाएं, डिवाइस पर किस तरह से काम करती हैं.
isPowerSaveMode

boolean

डिवाइस फ़िलहाल पावर सेव मोड में है या नहीं.
isInteractive

boolean

डिवाइस इंटरैक्टिव स्थिति में है या नहीं.
batteryInfo

object (BatteryInfo)

बैटरी की स्थिति के बारे में जानकारी.

LocationPowerSaveMode

"बैटरी सेवर" सुविधा चालू होने पर, मोबाइल डिवाइस पर जगह की जानकारी की सुविधाओं को किस तरह कॉन्फ़िगर किया जाता है. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE जगह के बारे में जानकारी नहीं हैPowerSaveMode
LOCATION_MODE_NO_CHANGE जगह की जानकारी देने वाली कंपनियों पर बैटरी सेवर की सुविधा का असर नहीं होना चाहिए या बैटरी सेवर की सुविधा बंद है.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF बैटरी सेवर चालू होने और डिवाइस के नॉन-इंटरैक्टिव होने पर, जीपीएस पर आधारित जगह की जानकारी देने वाली सेवा बंद होनी चाहिए.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF बैटरी सेवर चालू होने और डिवाइस के नॉन-इंटरैक्टिव होने पर, जगह की जानकारी देने वाली सभी कंपनियों को बंद कर दिया जाएगा.
LOCATION_MODE_FOREGROUND_ONLY जगह की जानकारी देने वाली सभी कंपनियों को उपलब्ध रखा जाएगा. हालांकि, जगह की जानकारी को ठीक करने की सुविधा सिर्फ़ फ़ोरग्राउंड ऐप्लिकेशन के लिए दी जानी चाहिए.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF डिवाइस के नॉन-इंटरैक्टिव होने पर, जगह की जानकारी की सुविधा बंद नहीं होगी. हालांकि, लोकेशन मैनेजर उन सभी अनुरोधों को कम कर देगा जो सेवा देने वाली कंपनियों को भेजे जाते हैं.

BatteryInfo

डिवाइस की बैटरी के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}
फ़ील्ड
batteryStatus

enum (BatteryStatus)

बैटरी की स्थिति, क्या वह पूरी तरह से चार्ज है या चार्ज हो रही है वगैरह.
powerSource

enum (PowerSource)

बैटरी पावर स्रोत की स्थिति.
batteryPercentage

number

बैटरी का मौजूदा प्रतिशत [0-100].

BatteryStatus

बैटरी की स्थिति, क्या वह पूरी तरह से चार्ज है या चार्ज हो रही है वगैरह.

Enums
UNKNOWN_BATTERY_STATUS बैटरी की स्थिति की जानकारी नहीं है.
BATTERY_STATUS_CHARGING बैटरी चार्ज हो रही है.
BATTERY_STATUS_DISCHARGING बैटरी चार्ज हो रही है.
BATTERY_STATUS_FULL बैटरी भरी हुई है.
BATTERY_STATUS_NOT_CHARGING बैटरी चार्ज नहीं हो रही है.
BATTERY_STATUS_POWER_LOW बैटरी कम चार्ज है.

PowerSource

बैटरी चार्ज करने के लिए इस्तेमाल किए जा रहे चार्जर का प्रकार.

Enums
UNKNOWN_POWER_SOURCE पावर सोर्स के बारे में जानकारी मौजूद नहीं है.
POWER_SOURCE_AC पावर सोर्स एक AC चार्जर है.
POWER_SOURCE_USB पावर सोर्स एक यूएसबी पोर्ट है.
POWER_SOURCE_WIRELESS पावर सोर्स वायरलेस है.
POWER_SOURCE_UNPLUGGED बैटरी अनप्लग कर दी गई है.

तरीके

create

 मांग पर राइडशेयर या डिलीवरी की सेवा देने वाली कंपनी से जुड़े नए वाहन को इंस्टैंशिएट करता है.

get

 फ़्लीट इंजन से कोई वाहन दिखाता है.

list

 सेवा देने वाली कंपनी से जुड़े वाहनों की पेज नंबर वाली सूची दिखाता है, जो अनुरोध के विकल्पों से मेल खाती है.
यह विकल्प, अनुरोध के विकल्पों से मेल खाने वाले वाहनों की सूची दिखाता है.

searchFuzzed
(deprecated)

 अब सेवा में नहीं है: इसके बजाय SearchVehicles का इस्तेमाल करें.

update

 वाहन की अपडेट की गई जानकारी को फ़्लीट इंजन में लिखता है.

updateAttributes

 इससे वाहन के एट्रिब्यूट कुछ हद तक अपडेट होते हैं.

updateLocation
(deprecated)

 अब काम नहीं करता: इसके बजाय, UpdateVehicle वाले तरीके का इस्तेमाल करें.