Package maps.fleetengine.v1

इंडेक्स

TripService

यात्रा को मैनेज करने की सेवा.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

फ़्लीट इंजन में यात्रा बनाता है और नई यात्रा को वापस करता है.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

किसी एक यात्रा के बारे में जानकारी पाना.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

यात्रा के बिल के इस्तेमाल की रिपोर्ट दें.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

किसी खास वाहन के लिए सभी यात्राएं पाएं.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

यात्रा का डेटा अपडेट करता है.

VehicleService

वाहन प्रबंधन सेवा.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

मांग पर राइडशेयर या डिलीवरी की सेवा देने वाली कंपनी के नए वाहन का इंस्टैंशिएट करता है. हर Vehicle का वाहन का यूनीक आईडी होना चाहिए.

Vehicle बनाते समय, इन Vehicle फ़ील्ड को भरना ज़रूरी है:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Vehicle बनाते समय, इन Vehicle फ़ील्ड पर ध्यान नहीं दिया जाता:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

बाकी सभी फ़ील्ड ज़रूरी नहीं हैं. उपलब्ध कराए जाने पर उनका इस्तेमाल किया जाता है.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

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

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

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

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

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

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

वाहन का अपडेट किया गया डेटा, Fleet Engine में सेव करता है.

Vehicle को अपडेट करते समय, नीचे दिए गए फ़ील्ड अपडेट नहीं किए जा सकते, क्योंकि इन्हें सर्वर मैनेज करता है:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

name गाड़ी को भी अपडेट नहीं किया जा सकता.

अगर attributes फ़ील्ड को अपडेट किया जाता है, तो वाहन के सभी एट्रिब्यूट को, अनुरोध में दिए गए एट्रिब्यूट से बदल दिया जाता है. अगर आपको सिर्फ़ कुछ एट्रिब्यूट अपडेट करने हैं, तो UpdateVehicleAttributes तरीका देखें. इसी तरह, waypoints फ़ील्ड को भी अपडेट किया जा सकता है. हालांकि, इसमें मौजूदा वे सभी पॉइंट होने चाहिए जो वाहन पर मौजूद हैं. इसके अलावा, कोई अन्य वेपॉइंट नहीं होना चाहिए.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

इससे वाहन की विशेषताओं में कुछ हद तक बदलाव होता है. सिर्फ़ अनुरोध में बताए गए एट्रिब्यूट अपडेट किए जाएंगे. दूसरे एट्रिब्यूट में कोई बदलाव नहीं किया जाएगा. ध्यान दें: UpdateVehicle में यह तरीका अलग है. ऐसे में, जहां पूरे attributes फ़ील्ड को UpdateVehicleRequest में मौजूद फ़ील्ड से बदल दिया जाएगा, उन एट्रिब्यूट को हटा दिया जाएगा जो अनुरोध में शामिल नहीं हैं.

BatteryInfo

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

फ़ील्ड
battery_status

BatteryStatus

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

power_source

PowerSource

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

battery_percentage

float

इस समय बैटरी का प्रतिशत [0-100].

BatteryStatus

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

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

BillingPlatformIdentifier

वैल्यू का एक सेट, जो बताता है कि किस प्लैटफ़ॉर्म पर अनुरोध किया गया था.

Enums
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED डिफ़ॉल्ट. इसका इस्तेमाल ऐसे प्लैटफ़ॉर्म के लिए किया जाता है जिनके बारे में नहीं बताया गया है.
SERVER यह प्लैटफ़ॉर्म एक क्लाइंट सर्वर है.
WEB प्लैटफ़ॉर्म एक वेब ब्राउज़र है.
ANDROID यह प्लैटफ़ॉर्म एक Android मोबाइल डिवाइस है.
IOS यह प्लैटफ़ॉर्म एक iOS मोबाइल डिवाइस है.
OTHERS दूसरे प्लैटफ़ॉर्म जो इस सूची में शामिल नहीं हैं.

ConsumableTrafficPolyline

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

फ़ील्ड
speed_reading_interval[]

SpeedReadingInterval

पिछले वेपॉइंट से मौजूदा वेपॉइंट तक के पथ पर ट्रैफ़िक की गति.

encoded_path_to_waypoint

string

वह पाथ जिसे ड्राइवर पिछले वेपॉइंट से मौजूदा वेपॉइंट ले जाता है. इस पाथ में लैंडमार्क हैं, ताकि क्लाइंट पाथ पर ट्रैफ़िक मार्कर दिखा सकें (speed_reading_interval देखें). फ़िलहाल, डिकोड करने की सुविधा उपलब्ध नहीं है.

CreateTripRequest

CreateTrip के अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

parent

string

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

trip_id

string

ज़रूरी है. यूनीक यात्रा आईडी. यह नीचे दी गई पाबंदियों पर निर्भर करता है:

  • यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें 64 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया.
  • इनमें से कोई भी ASCII वर्ण नहीं हो सकते: '/', ':', '?', ',' या '#'.
trip

Trip

ज़रूरी है. यात्रा की इकाई बनाना.

कोई यात्रा बनाते समय, इन फ़ील्ड की ज़रूरत होती है:

  • trip_type
  • pickup_point

अगर आपने फ़ील्ड में जानकारी दी है, तो उनका इस्तेमाल किया जाता है:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

अन्य सभी यात्रा फ़ील्ड को अनदेखा कर दिया जाता है. उदाहरण के लिए, सभी यात्राओं की शुरुआत NEW के trip_status से होती है, भले ही आपने यात्रा बनाने के अनुरोध में CANCELED में से trip_status पास किए हों.

सिर्फ़ EXCLUSIVE यात्राओं के लिए intermediate_destinations का इस्तेमाल किया जा सकता है.

जब vehicle_id को किसी शेयर की गई यात्रा के लिए सेट किया जाता है, तो आपको Trip.vehicle_waypoints की सूची देनी होगी, ताकि वाहन के बाकी वेपॉइंट का क्रम तय किया जा सके. ऐसा न करने पर, वेपॉइंट का क्रम तय नहीं किया जाएगा.

जब आप Trip.vehicle_waypoints के बारे में बताते हैं, तो सूची में वाहन की यात्राओं के बाकी वेपॉइंट शामिल होने चाहिए. इसमें कोई अतिरिक्त वेपॉइंट नहीं होना चाहिए. आपको इन वेपॉइंट को इस तरह ऑर्डर करना चाहिए कि किसी यात्रा के लिए, पिकअप पॉइंट इंटरमीडिएट डेस्टिनेशन से पहले का हो और सभी इंटरमीडिएट डेस्टिनेशन, ड्रॉप-ऑफ़ पॉइंट से पहले आते हों. EXCLUSIVE यात्रा के वेपॉइंट किसी दूसरी यात्रा के साथ इंटरलीव नहीं होने चाहिए.

trip_id, waypoint_type, और location फ़ील्ड का इस्तेमाल किया जाता है. साथ ही, vehicle_waypoints में मौजूद अन्य सभी TripWaypoint फ़ील्ड को अनदेखा कर दिया जाता है.

CreateVehicleRequest

CreateVehicle के अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

parent

string

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

vehicle_id

string

ज़रूरी है. यूनीक वाहन का आईडी. यह नीचे दी गई पाबंदियों पर निर्भर करता है:

  • यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें 64 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया.
  • इनमें से कोई भी ASCII वर्ण नहीं हो सकते: '/', ':', '?', ',' या '#'.
vehicle

Vehicle

ज़रूरी है. वाहन की वह इकाई जिसे बनाया जाना है. वाहन बनाते समय, इन फ़ील्ड को भरना ज़रूरी है:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

वाहन बनाते समय, इन फ़ील्ड को अनदेखा किया जाता है:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

बाकी सभी फ़ील्ड ज़रूरी नहीं हैं. उपलब्ध कराए जाने पर उनका इस्तेमाल किया जाता है.

DeviceSettings

मोबाइल डिवाइस पर मौजूद अलग-अलग सेटिंग के बारे में जानकारी.

फ़ील्ड
location_power_save_mode

LocationPowerSaveMode

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

is_power_save_mode

bool

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

is_interactive

bool

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

battery_info

BatteryInfo

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

GetTripRequest

GetTrip अनुरोध मैसेज.

फ़ील्ड
header

RequestHeader

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

name

string

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

view

TripView

यात्रा के फ़ील्ड का वह सबसेट जिसे लौटाया जाना चाहिए. साथ ही, उसके बारे में जानकारी भी दी जानी चाहिए.

current_route_segment_version

Timestamp

उस कम से कम टाइमस्टैंप (खास) के बारे में बताता है जिसके लिए Trip.route या Trip.current_route_segment डेटा लिया गया है. अगर इस टाइमस्टैंप के बाद से रूट डेटा में कोई बदलाव नहीं होता है, तो रूट फ़ील्ड को जवाब के तौर पर सेट नहीं किया जाता है. अगर कोई कम से कम वैल्यू तय नहीं की गई है, तो रूट डेटा हमेशा वापस पाया जाता है.

remaining_waypoints_version

Timestamp

उस कम से कम टाइमस्टैंप (खास) के बारे में बताता है जिसके लिए Trip.remaining_waypoints वापस लिए गए हैं. अगर इस टाइमस्टैंप के बाद से इनमें कोई बदलाव नहीं होता है, तो जवाब के तौर पर remaining_waypoints सेट नहीं होता है. अगर इस फ़ील्ड को सेट नहीं किया गया है, तो remaining_waypoints हमेशा वापस आ जाता है.

route_format_type

PolylineFormatType

दिखाया गया मौजूदा रास्ता फ़ॉर्मैट, LAT_LNG_LIST_TYPE (Trip.route में) या ENCODED_POLYLINE_TYPE (Trip.current_route_segment में). डिफ़ॉल्ट LAT_LNG_LIST_TYPE है.

current_route_segment_traffic_version

Timestamp

उस कम से कम टाइमस्टैंप (खास) के बारे में बताता है जिसके लिए Trip.current_route_segment_traffic वापस पाया गया है. अगर इस टाइमस्टैंप के बाद से, ट्रैफ़िक के डेटा में कोई बदलाव नहीं होता है, तो current_route_segment_traffic फ़ील्ड को रिस्पॉन्स में सेट नहीं किया जाता है. अगर कम से कम वैल्यू की जानकारी नहीं दी गई है, तो ट्रैफ़िक का डेटा हमेशा वापस लाया जाता है. ध्यान दें कि ट्रैफ़िक सिर्फ़ मांग पर राइड और डिलीवरी समाधान वाले ग्राहकों के लिए उपलब्ध है.

remaining_waypoints_route_version

Timestamp

उस कम से कम टाइमस्टैंप (खास टाइमस्टैंप) के बारे में बताता है जिसके लिए Trip.remaining_waypoints.traffic_to_waypoint और Trip.remaining_waypoints.path_to_waypoint डेटा लिया गया है. अगर इस टाइमस्टैंप के बाद से डेटा में कोई बदलाव नहीं होता है, तो ऊपर दिए गए फ़ील्ड जवाब के तौर पर सेट नहीं होते हैं. अगर remaining_waypoints_route_version की वैल्यू नहीं दी गई है, तो ट्रैफ़िक और पाथ की जानकारी हमेशा वापस मिल जाती है.

GetVehicleRequest

GetVehicle के अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

name

string

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

current_route_segment_version

Timestamp

उस कम से कम टाइमस्टैंप (खास) के बारे में बताता है जिसके लिए Vehicle.current_route_segment वापस पाया गया है. अगर इस टाइमस्टैंप के बाद से रूट में कोई बदलाव नहीं होता है, तो current_route_segment फ़ील्ड को रिस्पॉन्स में सेट नहीं किया जाता है. अगर कम से कम वैल्यू की जानकारी नहीं दी गई है, तो current_route_segment हमेशा वापस पाया जाता है.

waypoints_version

Timestamp

उस कम से कम टाइमस्टैंप (खास टाइमस्टैंप) के बारे में बताता है जिसके लिए Vehicle.waypoints डेटा हासिल किया गया है. अगर इस टाइमस्टैंप के बाद से, वेपॉइंट में कोई बदलाव नहीं होता है, तो रिस्पॉन्स के तौर पर vehicle.waypoints डेटा सेट नहीं होता है. अगर इस फ़ील्ड को सेट नहीं किया गया है, तो vehicle.waypoints हमेशा वापस आ जाता है.

LicensePlate

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

फ़ील्ड
country_code

string

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

last_character

string

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

  • "ABC 1234" -> "4"
  • "AB 123 सीडी" -> "3"
  • "ABCDEF" -> "-1"

ListVehiclesRequest

ListVehicles के अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

parent

string

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

page_size

int32

लौटाए जाने वाले वाहनों की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट वैल्यू: 100.

page_token

string

ListVehicles को किए गए पिछले कॉल से मिली next_page_token की वैल्यू, ताकि आप वाहनों के ग्रुप को अलग-अलग पेजों पर बांट सकें. अगर अनुरोध और ListVehicles को किए गए पिछले कॉल की फ़िल्टर करने की शर्तों में अंतर है, तो वैल्यू के बारे में कोई जानकारी नहीं दी गई है.

minimum_capacity

Int32Value

इससे पता चलता है कि वाहन की कम से कम कपैसिटी कम से कम कितनी होनी चाहिए. लौटाए गए सभी वाहनों का maximum_capacity, इस वैल्यू से ज़्यादा या इसके बराबर होगा. अगर यह सेट है, तो वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए.

trip_types[]

TripType

इस वजह से, उन वाहनों पर पाबंदी लगाई जाती है जो कम से कम किसी एक यात्रा के साथ काम करते हैं.

maximum_staleness

Duration

यह नीति, उन वाहनों के लिए, तय समय के दौरान जगह की जानकारी से जुड़े अपडेट भेजे जाने पर पाबंदी लगाती है जिन्होंने Fleet Engine को जगह की जानकारी के अपडेट भेजे हैं. एक जगह से दूसरी जगह पर पहुंचने वाले स्टेशनरी वाहनों को पुराना नहीं माना जाता. अगर यह मौजूद है, तो एक मान्य पॉज़िटिव अवधि होनी चाहिए.

vehicle_type_categories[]

Category

ज़रूरी है. इस नीति की मदद से, किसी खास टाइप की कैटगरी वाले वाहनों के लिए रिस्पॉन्स को रोका जा सकता है. UNKNOWN की अनुमति नहीं है.

required_attributes[]

string

कॉल करने वाले लोग, required_attributes, required_one_of_attributes, और required_one_of_attribute_sets फ़ील्ड के किसी भी कॉम्बिनेशन का इस्तेमाल करके, मुश्किल लॉजिकल ऑपरेशन बना सकते हैं.

required_attributes एक सूची है; required_one_of_attributes मैसेज का इस्तेमाल करता है, जो सूचियों की सूची बनाने की अनुमति देता है. संयोजन में, दो फ़ील्ड इस एक्सप्रेशन की संरचना की अनुमति देते हैं:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

इससे, तय किए गए एट्रिब्यूट वाले वाहनों के लिए रिस्पॉन्स को रोका जा सकता है. यह फ़ील्ड एक संयोजन/और कार्रवाई है. ज़्यादा से ज़्यादा 50 ज़रूरी_एट्रिब्यूट इस्तेमाल किए जा सकते हैं. यह संख्या, वाहन के लिए इस्तेमाल किए जा सकने वाले एट्रिब्यूट की ज़्यादा से ज़्यादा संख्या से मेल खाती है. दोहराई गई हर स्ट्रिंग "key:value" फ़ॉर्मैट में होनी चाहिए.

required_one_of_attributes[]

string

इस नीति के तहत, हर VehicleAttributeList में बताए गए कम से कम एक एट्रिब्यूट वाले वाहनों के लिए रिस्पॉन्स को रोका जा सकता है. हर सूची में, वाहन को कम से कम एक एट्रिब्यूट से मेल खाना चाहिए. यह फ़ील्ड, हर VehicleAttributeList में शामिल डिसजंक्शन/OR ऑपरेशन होता है. साथ ही, यह VehicleAttributeList के पूरे कलेक्शन में जोड़ने वाली/और कार्रवाई को भी शामिल करता है. दोहराई गई हर स्ट्रिंग "key1:value1|key2:value2|key3:value3" फ़ॉर्मैट में होनी चाहिए.

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets से ज़्यादा सुविधाएं मिलती हैं.

required_one_of_attributes की तरह ही, required_one_of_attribute_sets एक मैसेज का इस्तेमाल करता है, जो सूचियों की सूची बनाने की अनुमति देता है और इस तरह के एक्सप्रेशन को अनुमति देता है:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

इस नीति से, उन वाहनों के लिए रिस्पॉन्स को रोका जाता है जो VehicleAttributeList में मौजूद सभी एट्रिब्यूट से मेल खाते हैं. हर सूची में, वाहन सभी एट्रिब्यूट से मेल खाना चाहिए. यह फ़ील्ड, हर VehicleAttributeList में मौजूद कॉम्बिनेशन/और ऐक्शन है. साथ ही, VehicleAttributeList को इकट्ठा करने के दौरान, इसमें डिसजंक्शन/OR ऑपरेशन भी शामिल होता है. दोहराई गई हर स्ट्रिंग "key1:value1|key2:value2|key3:value3" फ़ॉर्मैट में होनी चाहिए.

vehicle_state

VehicleState

इस वजह से, ऐसे वाहनों के लिए रिस्पॉन्स नहीं मिल सकता जिनमें यह वाहन चालू है.

on_trip_only

bool

सिर्फ़ मौजूदा यात्रा के लिए वाहन दिखाएं.

filter

string

ज़रूरी नहीं. वाहनों की लिस्टिंग करते समय लागू करने के लिए, फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरण देखने के लिए, http://aip.dev/160 पर जाएं.

इस फ़ील्ड को required_attributes, required_one_of_attributes, और required_one_of_attributes_sets फ़ील्ड को बदलने के लिए डिज़ाइन किया गया है. अगर यहां ऐसी वैल्यू दी गई है जो खाली नहीं है, तो ये फ़ील्ड खाली होने चाहिए: required_attributes, required_one_of_attributes, और required_one_of_attributes_sets.

यह फ़िल्टर, vehicle_state या on_trip_only जैसी अन्य कंस्ट्रेंट के साथ एक AND क्लॉज़ के रूप में काम करता है.

ध्यान दें कि क्वेरी के लिए सिर्फ़ वाहन के एट्रिब्यूट (जैसे, attributes.<key> = <value> या attributes.<key1> = <value1> AND attributes.<key2> = <value2>) का इस्तेमाल किया जा सकता है. किसी फ़िल्टर क्वेरी में ज़्यादा से ज़्यादा 50 पाबंदियां हो सकती हैं.

साथ ही, सभी एट्रिब्यूट, स्ट्रिंग के तौर पर सेव किए जाते हैं. इसलिए, एट्रिब्यूट के लिए सिर्फ़ स्ट्रिंग तुलनाएं की जा सकती हैं. संख्या या बूलियन वैल्यू से तुलना करने के लिए, वैल्यू को स्ट्रिंग (उदाहरण के लिए, attributes.<key> = "10" या attributes.<key> = "true") के तौर पर माना जाना चाहिए. इसके लिए, वैल्यू को साफ़ तौर पर कोट किया जाना चाहिए.

viewport

Viewport

ज़रूरी नहीं. यह फ़िल्टर उन वाहनों को सीमित करता है जिनकी आखिरी जगह, व्यूपोर्ट के तय किए गए आयताकार इलाके में थी.

ListVehiclesResponse

ListVehicles जवाब वाला मैसेज.

फ़ील्ड
vehicles[]

Vehicle

ऐसे वाहन जो अनुरोध में बताई गई शर्तों के मुताबिक हों. अनुरोध में मौजूद page_size फ़ील्ड से, यह तय किया जाता है कि ज़्यादा से ज़्यादा कितने वाहन लौटाए जा सकते हैं.

next_page_token

string

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

total_size

int64

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

LocationPowerSaveMode

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

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE तय नहीं किया गया LocationPowerSaveMode
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 जगह की जानकारी देने वाली सुविधा बंद नहीं होगी. हालांकि, डिवाइस के नॉन-इंटरैक्टिव होने पर, LocationManager उन अनुरोधों को कम कर देगा जो आपको सेवा देने वाली कंपनियों के ज़रिए भेजे गए हैं.

LocationSensor

जगह का पता लगाने के लिए इस्तेमाल किया जाने वाला सेंसर या तरीका.

Enums
UNKNOWN_SENSOR सेंसर के बारे में जानकारी नहीं है या इसकी जानकारी नहीं है.
GPS जीपीएस या असिस्टेड जीपीएस.
NETWORK जीपीएस की सुविधा वाला जीपीएस, सेल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
PASSIVE सेल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
ROAD_SNAPPED_LOCATION_PROVIDER सड़क की सबसे संभावित स्थिति के रूप में मोबाइल डिवाइस से तय की गई जगह.
CUSTOMER_SUPPLIED_LOCATION किसी स्वतंत्र स्रोत से ग्राहक की ओर से दी जाने वाली जगह. आम तौर पर, इस वैल्यू का इस्तेमाल जगह की जानकारी के लिए किया जाता है. यह जगह, ड्राइवर SDK टूल चलाने वाले मोबाइल डिवाइस के अलावा, अन्य सोर्स से मिलती है. अगर ओरिजनल सोर्स की जानकारी किसी दूसरी ईनम वैल्यू से दी गई है, तो उस वैल्यू का इस्तेमाल करें. CUSTOMER_SUPPLIED_LOCATION के तौर पर मार्क की गई जगहों की जानकारी आम तौर पर वाहन के last_location.supplemental_location_sensor से दी जाती है.
FLEET_ENGINE_LOCATION उपलब्ध सिग्नल के आधार पर, Fleet Engine की मदद से जगह का हिसाब लगाया जाता है. सिर्फ़ आउटपुट के लिए. अगर अनुरोध में यह वैल्यू मिलती है, तो उसे अस्वीकार कर दिया जाएगा.
FUSED_LOCATION_PROVIDER Android की कई तरह की सुविधाओं वाली जगह की जानकारी देने वाली सेवा.
CORE_LOCATION Apple के ऑपरेटिंग सिस्टम पर जगह की जानकारी देने वाली कंपनी.

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

Enums
UNKNOWN_NAVIGATION_STATUS नेविगेशन की स्थिति की जानकारी नहीं है.
NO_GUIDANCE ड्राइवर ऐप्लिकेशन का नेविगेशन FREE_NAV मोड में है.
ENROUTE_TO_DESTINATION मोड़-दर-मोड़ नेविगेशन की सुविधा उपलब्ध है और ड्राइवर ऐप्लिकेशन नेविगेशन अब GUIDED_NAV मोड में है.
OFF_ROUTE वाहन सुझाए गए रास्ते से हट गया है.
ARRIVED_AT_DESTINATION वाहन, मंज़िल से करीब 50 मीटर के दायरे में है.

PolylineFormatType

पॉलीलाइन फ़ॉर्मैट का टाइप.

Enums
UNKNOWN_FORMAT_TYPE फ़ॉर्मैट की जानकारी नहीं है या इसकी जानकारी नहीं है.
LAT_LNG_LIST_TYPE google.type.LatLng की सूची.
ENCODED_POLYLINE_TYPE पॉलीलाइन कंप्रेस करने के एल्गोरिदम से एन्कोड की गई पॉलीलाइन. फ़िलहाल, डिकोड करने की सुविधा उपलब्ध नहीं है.

PowerSource

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

Enums
UNKNOWN_POWER_SOURCE पावर सोर्स की जानकारी नहीं है.
POWER_SOURCE_AC पावर सोर्स एक एसी चार्जर है.
POWER_SOURCE_USB पावर सोर्स एक यूएसबी पोर्ट है.
POWER_SOURCE_WIRELESS पावर सोर्स वायरलेस है.
POWER_SOURCE_UNPLUGGED बैटरी पावर सॉकेट से कनेक्ट नहीं है.

ReportBillableTripRequest

ReportBillableTrip के अनुरोध का मैसेज.

फ़ील्ड
name

string

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

country_code

string

ज़रूरी है. यात्रा से जुड़े देश का दो अक्षरों वाला देश कोड. कीमत, देश के कोड के हिसाब से तय होती है.

platform

BillingPlatformIdentifier

वह प्लैटफ़ॉर्म जिस पर अनुरोध किया गया था.

related_ids[]

string

ऐसे आइडेंटिफ़ायर जो सीधे तौर पर रिपोर्ट की जा रही यात्रा से जुड़े हैं. आम तौर पर, ये प्री-बुकिंग कार्रवाइयों के आईडी (उदाहरण के लिए, सेशन आईडी) होते हैं, जो यात्रा आईडी उपलब्ध होने से पहले किए जाते हैं. related_ids की संख्या 50 तक सीमित है.

solution_type

SolutionType

रिपोर्ट की गई यात्रा के लिए इस्तेमाल किए गए GMP प्रॉडक्ट समाधान का टाइप (जैसे, ON_DEMAND_RIDESHARING_AND_DELIVERIES).

SolutionType

रिपोर्ट की गई यात्रा के लिए, अलग-अलग तरह के समाधान के लिए सिलेक्टर.

Enums
SOLUTION_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. पुराने सिस्टम के साथ काम करने की क्षमता के लिए, एपीआई डिफ़ॉल्ट रूप से ON_DEMAND_RIDESHARING_AND_DELIVERIES का इस्तेमाल करेगा. यह पहला समाधान टाइप है, जिसका इस्तेमाल किया जा सकता है.
ON_DEMAND_RIDESHARING_AND_DELIVERIES यह सुविधा, मांग पर राइडशेयर करने और डिलीवरी की सुविधा देती है.

RequestHeader

अनुरोध हेडर में ऐसे फ़ील्ड होते हैं जो फ़्लीट इंजन के सभी आरपीसी अनुरोधों के लिए होते हैं.

फ़ील्ड
language_code

string

BCP-47 भाषा कोड, जैसे कि en-US या sr-Latn. ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier देखें. अगर कोई तय नहीं किया गया है, तो जवाब किसी भी भाषा में हो सकता है. साथ ही, अगर नाम मौजूद हो, तो अंग्रेज़ी को प्राथमिकता दी जा सकती है. फ़ील्ड की वैल्यू का उदाहरण: en-US.

region_code

string

ज़रूरी है. अनुरोध किए जाने वाले इलाके का CLDR इलाके का कोड. फ़ील्ड की वैल्यू का उदाहरण: US.

sdk_version

string

कॉल करने के लिए इस्तेमाल किए जाने वाले SDK टूल का वर्शन, अगर लागू हो. वर्शन का फ़ॉर्मैट "major.minor.patch" है, जैसे: 1.1.2.

os_version

string

उस ऑपरेटिंग सिस्टम का वर्शन जिस पर कॉल करने के लिए इस्तेमाल किया जाने वाला SDK टूल चल रहा है. फ़ील्ड वैल्यू के उदाहरण: 4.4.1, 12.1.

device_model

string

उस डिवाइस का मॉडल जिस पर SDK टूल चल रहा है. फ़ील्ड वैल्यू के उदाहरण: iPhone12,1, SM-G920F.

sdk_type

SdkType

अनुरोध भेजने वाले SDK टूल का टाइप.

maps_sdk_version

string

लागू होने पर, MapSDK का वह वर्शन जिस पर कॉल करने वाले SDK टूल का इस्तेमाल किया जाता है. वर्शन का फ़ॉर्मैट "major.minor.patch" है, जैसे: 5.2.1.

nav_sdk_version

string

अगर लागू हो, तो NavSDK का वह वर्शन जिस पर कॉल करने के SDK टूल का इस्तेमाल किया जाता है. वर्शन का फ़ॉर्मैट "major.minor.patch" है, जैसे: 2.1.0.

platform

Platform

कॉल करने वाले SDK टूल का प्लैटफ़ॉर्म.

manufacturer

string

कॉलिंग SDK टूल से Android डिवाइस बनाने वाली कंपनी, जो सिर्फ़ Android SDK टूल पर लागू होती है. फ़ील्ड की वैल्यू का उदाहरण: Samsung.

android_api_level

int32

कॉल करने के लिए इस्तेमाल किए जाने वाले SDK टूल का Android एपीआई लेवल, जो सिर्फ़ Android SDK टूल पर लागू होता है. फ़ील्ड की वैल्यू का उदाहरण: 23.

trace_id

string

वैकल्पिक आईडी, जो अनुरोध की पहचान करने के लिए डेटा लॉग करने के लिए दिया जा सकता है.

प्लैटफ़ॉर्म

कॉल करने वाले SDK टूल का प्लैटफ़ॉर्म.

Enums
PLATFORM_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इस वैल्यू का इस्तेमाल तब किया जाता है, जब प्लैटफ़ॉर्म को शामिल नहीं किया जाता.
ANDROID यह अनुरोध Android की ओर से किया जा रहा है.
IOS यह अनुरोध iOS से किया गया है.
WEB यह अनुरोध वेब की ओर से किया जा रहा है.

SdkType

SDK टूल के संभावित टाइप.

Enums
SDK_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इस वैल्यू का इस्तेमाल तब किया जाता है, जब sdk_type को शामिल नहीं किया जाता है.
CONSUMER कॉल करने के लिए इस्तेमाल किया जाने वाला SDK टूल, Consumer है.
DRIVER SDK टूल ड्राइवर को कॉल किया जा रहा है.
JAVASCRIPT SDK टूल का नाम JavaScript है.

SearchTripsRequest

SearchTrips के लिए अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

parent

string

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

vehicle_id

string

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

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

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

page_size

int32

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

page_token

string

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

minimum_staleness

Duration

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

SearchTripsResponse

SearchTrips का रिस्पॉन्स मैसेज.

फ़ील्ड
trips[]

Trip

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

next_page_token

string

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

SearchVehiclesRequest

SearchVehicles के अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

parent

string

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

pickup_point

TerminalLocation

ज़रूरी है. आस-पास मौजूद पिकअप की जगह.

dropoff_point

TerminalLocation

ग्राहक जिस जगह से सामान छोड़ना चाहता है. अगर trip_types में TripType.SHARED है, तो फ़ील्ड को भरना ज़रूरी है.

pickup_radius_meters

int32

ज़रूरी है. पिकअप पॉइंट के आस-पास वाहन की खोज के दायरे के बारे में बताता है. सिर्फ़ खोज के दायरे में आने वाले वाहन दिखाए जाएंगे. वैल्यू, 400 से 10,000 मीटर (दोनों शामिल) के बीच होनी चाहिए.

count

int32

ज़रूरी है. इससे यह पता चलता है कि ज़्यादा से ज़्यादा कितने वाहन लौटाए जा सकते हैं. वैल्यू, 1 से 50 के बीच होनी चाहिए.

minimum_capacity

int32

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

trip_types[]

TripType

ज़रूरी है. सुझाई गई यात्रा के टाइप के बारे में जानकारी. सटीक रूप से एक प्रकार शामिल होना चाहिए. UNKNOWN_TRIP_TYPE की अनुमति नहीं है. खोज को सिर्फ़ उन वाहनों तक सीमित करता है जो उस यात्रा के टाइप के साथ काम कर सकते हैं.

maximum_staleness

Duration

इस नीति के तहत, खोज को सिर्फ़ उन वाहनों के लिए सीमित किया जाता है जिन्होंने तय अवधि के दौरान, Fleet Engine को जगह की जानकारी से जुड़े अपडेट भेजे हों. एक जगह से दूसरी जगह पर पहुंचने वाले स्टेशनरी वाहनों को पुराना नहीं माना जाता. अगर यह फ़ील्ड सेट नहीं है, तो सर्वर डिफ़ॉल्ट वैल्यू के तौर पर पांच मिनट इस्तेमाल करता है.

vehicle_types[]

VehicleType

ज़रूरी है. किसी खास टाइप के वाहनों की खोज को सीमित करता है. कम से कम एक वाहन का टाइप बताना ज़रूरी है. UNKNOWN कैटगरी वाले वाहन टाइप की अनुमति नहीं है.

required_attributes[]

VehicleAttribute

कॉल करने वाले लोग, required_attributes, required_one_of_attributes, और required_one_of_attribute_sets फ़ील्ड के किसी भी कॉम्बिनेशन का इस्तेमाल करके, मुश्किल लॉजिकल ऑपरेशन बना सकते हैं.

required_attributes एक सूची है; required_one_of_attributes मैसेज का इस्तेमाल करता है, जो सूचियों की सूची बनाने की अनुमति देता है. संयोजन में, दो फ़ील्ड इस एक्सप्रेशन की संरचना की अनुमति देते हैं:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

खोज को सिर्फ़ उन वाहनों तक सीमित करता है जिनमें बताए गए एट्रिब्यूट मौजूद हों. यह फ़ील्ड एक संयोजन/और कार्रवाई है. ज़्यादा से ज़्यादा 50 ज़रूरी_एट्रिब्यूट इस्तेमाल किए जा सकते हैं. यह संख्या, वाहन के लिए इस्तेमाल किए जा सकने वाले एट्रिब्यूट की ज़्यादा से ज़्यादा संख्या से मेल खाती है.

required_one_of_attributes[]

VehicleAttributeList

खोज को सिर्फ़ उन वाहनों तक सीमित करता है जिनमें हर VehicleAttributeList में, बताए गए एट्रिब्यूट में से कम से कम एक एट्रिब्यूट मौजूद हो. हर सूची में, वाहन को कम से कम एक एट्रिब्यूट से मेल खाना चाहिए. यह फ़ील्ड, हर VehicleAttributeList में शामिल डिसजंक्शन/OR ऑपरेशन होता है. साथ ही, यह VehicleAttributeList के पूरे कलेक्शन में जोड़ने वाली/और कार्रवाई को भी शामिल करता है.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets से ज़्यादा सुविधाएं मिलती हैं.

required_one_of_attributes की तरह ही, required_one_of_attribute_sets एक मैसेज का इस्तेमाल करता है, जो सूचियों की सूची बनाने की अनुमति देता है और इस तरह के एक्सप्रेशन को अनुमति देता है:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

खोज को सिर्फ़ उन वाहनों तक सीमित करता है जिनमें VehicleAttributeList में सभी एट्रिब्यूट मौजूद हैं. हर सूची में, वाहन सभी एट्रिब्यूट से मेल खाना चाहिए. यह फ़ील्ड, हर VehicleAttributeList में मौजूद कॉम्बिनेशन/और ऐक्शन है. साथ ही, VehicleAttributeList को इकट्ठा करने के दौरान, इसमें डिसजंक्शन/OR ऑपरेशन भी शामिल होता है.

order_by

VehicleMatchOrder

ज़रूरी है. नतीजों को क्रम से लगाने की ज़रूरी शर्तें बताता है.

include_back_to_back

bool

इससे पता चलता है कि एक ही यात्रा से जुड़े वाहन इस खोज के लिए इस्तेमाल किए जा सकते हैं या नहीं. इस फ़ील्ड का इस्तेमाल सिर्फ़ तब किया जाता है, जब current_trips_present के बारे में जानकारी न दी गई हो. अगर current_trips_present की वैल्यू सेट नहीं की गई है और इस फ़ील्ड में false है, तो असाइन की गई यात्रा वाले वाहनों को खोज के नतीजों में शामिल नहीं किया जाता. अगर current_trips_present के बारे में नहीं बताया गया है और इस फ़ील्ड में true है, तो खोज के नतीजों में एक चालू यात्रा वाले वे वाहन शामिल हो सकते हैं जिनका स्टेटस ENROUTE_TO_DROPOFF है. current_trips_present के बारे में बताने पर, इस फ़ील्ड को 'सही' पर सेट नहीं किया जा सकता.

डिफ़ॉल्ट वैल्यूfalse है

trip_id

string

इस SearchVehicleRequest से जुड़ी यात्रा की जानकारी देता है.

current_trips_present

CurrentTripsPresent

इससे पता चलता है कि चालू यात्रा वाले वाहन इस खोज के लिए इस्तेमाल किए जा सकते हैं या नहीं. अगर trip_type में SHARED शामिल है, तो इसे CURRENT_TRIPS_PRESENT_UNSPECIFIED के बजाय किसी अन्य पर सेट करना चाहिए.

filter

string

ज़रूरी नहीं. वाहनों की खोज करते समय लागू की जाने वाली फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरण देखने के लिए, http://aip.dev/160 पर जाएं.

इस फ़ील्ड को required_attributes, required_one_of_attributes, और required_one_of_attributes_sets फ़ील्ड को बदलने के लिए डिज़ाइन किया गया है. अगर यहां ऐसी वैल्यू दी गई है जो खाली नहीं है, तो ये फ़ील्ड खाली होने चाहिए: required_attributes, required_one_of_attributes, और required_one_of_attributes_sets.

यह फ़िल्टर, minimum_capacity या vehicle_types जैसी अन्य कंस्ट्रेंट के साथ एक AND क्लॉज़ के रूप में काम करता है.

ध्यान दें कि क्वेरी के लिए सिर्फ़ वाहन के एट्रिब्यूट (जैसे, attributes.<key> = <value> या attributes.<key1> = <value1> AND attributes.<key2> = <value2>) का इस्तेमाल किया जा सकता है. किसी फ़िल्टर क्वेरी में ज़्यादा से ज़्यादा 50 पाबंदियां हो सकती हैं.

साथ ही, सभी एट्रिब्यूट, स्ट्रिंग के तौर पर सेव किए जाते हैं. इसलिए, एट्रिब्यूट के लिए सिर्फ़ स्ट्रिंग तुलनाएं की जा सकती हैं. संख्या या बूलियन वैल्यू से तुलना करने के लिए, वैल्यू को स्ट्रिंग (उदाहरण के लिए, attributes.<key> = "10" या attributes.<key> = "true") के तौर पर माना जाना चाहिए. इसके लिए, वैल्यू को साफ़ तौर पर कोट किया जाना चाहिए.

CurrentTripsPresent

इससे, वाहन की मौजूदा यात्राओं पर लगने वाली पाबंदियों के बारे में पता चलता है.

Enums
CURRENT_TRIPS_PRESENT_UNSPECIFIED यात्रा वाले वाहनों की उपलब्धता, include_back_to_back फ़ील्ड से कंट्रोल होती है.
NONE बिना यात्रा वाले वाहन खोज के नतीजों में दिख सकते हैं. जब इस वैल्यू का इस्तेमाल किया जाता है, तो include_back_to_back, true नहीं हो सकता.
ANY खोज के नतीजों में ऐसी गाड़ियों को शामिल किया जाता है जिनमें ज़्यादा से ज़्यादा पांच मौजूदा यात्राएं और 10 वेपॉइंट हो सकते हैं. जब इस वैल्यू का इस्तेमाल किया जाता है, तो include_back_to_back, true नहीं हो सकता.

VehicleMatchOrder

जवाब में वाहन से मेल खाने वाले शब्दों का क्रम बताता है.

Enums
UNKNOWN_VEHICLE_MATCH_ORDER डिफ़ॉल्ट, इसका इस्तेमाल वाहन के मिलान से जुड़े ऐसे ऑर्डर के लिए किया जाता है जिसके बारे में जानकारी नहीं दी गई है या जिसकी पहचान नहीं की जा सकी है.
PICKUP_POINT_ETA वाहन के ज़रिए पिकअप पॉइंट तक पहुंचने में लगने वाले समय के हिसाब से बढ़ते क्रम में.
PICKUP_POINT_DISTANCE वाहन से पिकअप पॉइंट तक की दूरी के हिसाब से बढ़ते क्रम में.
DROPOFF_POINT_ETA वाहन से उतरने की जगह तक वाहन से जाने में लगने वाले समय के हिसाब से बढ़ते क्रम में. इस ऑर्डर का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब अनुरोध में ड्रॉप-ऑफ़ पॉइंट के बारे में बताया गया हो.
PICKUP_POINT_STRAIGHT_DISTANCE वाहन को जिस जगह पिछली बार बताया गया था, उससे पिकअप पॉइंट तक सीधी लाइन की दूरी के हिसाब से बढ़ते क्रम में.
COST कॉन्फ़िगर की गई मैच लागत के हिसाब से बढ़ते क्रम में. मैच कॉस्ट को सीधी लाइन की दूरी और ईटीए के बीच के वेटेज (महत्व) के हिसाब से कैलकुलेट किया जाता है. वेट डिफ़ॉल्ट वैल्यू पर सेट होते हैं और हर ग्राहक के हिसाब से उनमें बदलाव किया जा सकता है. अगर आपके प्रोजेक्ट के लिए इन मोटाई में बदलाव करने की ज़रूरत है, तो कृपया Google सहायता से संपर्क करें.

SearchVehiclesResponse

SearchVehicles जवाब वाला मैसेज.

फ़ील्ड
matches[]

VehicleMatch

SearchVehiclesRequest की शर्तों को पूरा करने वाले वाहनों की सूची. इन्हें SearchVehiclesRequest.order_by फ़ील्ड के हिसाब से क्रम में लगाया गया है.

SpeedReadingInterval

पाथ के सटे हुए सेगमेंट पर ट्रैफ़िक सघनता का इंडिकेटर. P_0, P_1, ... , P_N (शून्य पर आधारित इंडेक्स) पॉइंट वाला पाथ दिए जाने पर, SpeedReadingInterval किसी इंटरवल को तय करता है और इसके ट्रैफ़िक की जानकारी देने के लिए इन कैटगरी का इस्तेमाल करता है.

फ़ील्ड
start_polyline_point_index

int32

पाथ में इस इंटरवल का शुरुआती इंडेक्स. JSON में, इंडेक्स की वैल्यू 0 होने पर, फ़ील्ड में अपने-आप जानकारी भरी हुई नहीं दिखेगी.

end_polyline_point_index

int32

पाथ में इस इंटरवल का आखिरी इंडेक्स. JSON में, इंडेक्स की वैल्यू 0 होने पर, फ़ील्ड में अपने-आप जानकारी भरी हुई नहीं दिखेगी.

speed

Speed

इस इंटरवल में ट्रैफ़िक की स्पीड.

स्पीड

ट्रैफ़िक डेटा के आधार पर पॉलीलाइन गति का वर्गीकरण.

Enums
SPEED_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
NORMAL सामान्य गति, धीमे ट्रैफ़िक का पता नहीं चला.
SLOW धीमे ट्रैफ़िक का पता चला है, लेकिन ट्रैफ़िक जाम नहीं लगा.
TRAFFIC_JAM ट्रैफ़िक जाम का पता चला.

StopLocation

वह जगह जहां से स्टॉप (पिकअप/ड्रॉपऑफ़) हुआ था.

फ़ील्ड
point

LatLng

ज़रूरी है. असल जगह को दिखाता है.

timestamp

Timestamp

बताता है कि स्टॉप कब हुआ.

stop_time
(deprecated)

Timestamp

सिर्फ़ इनपुट. समर्थन नहीं होना या रुकना. टाइमस्टैंप फ़ील्ड का इस्तेमाल करें.

TerminalLocation

किसी वेपॉइंट की जगह के बारे में बताता है.

फ़ील्ड
point

LatLng

ज़रूरी है. किसी यात्रा वेपॉइंट की जगह को दिखाता है.

terminal_point_id
(deprecated)

TerminalPointId

अब काम नहीं करता: इसके बजाय, point फ़ील्ड डालें.

access_point_id
(deprecated)

string

अब काम नहीं करता: इसके बजाय, point फ़ील्ड डालें.

trip_id
(deprecated)

string

समर्थन नहीं होना या रुकना.

terminal_location_type
(deprecated)

WaypointType

अब काम नहीं करता: Vehicle.waypoint में यह डेटा होगा.

TerminalPointId

अब काम नहीं करता: Fleet Engine में TerminalPoints काम नहीं करते. इसके बजाय, TerminalLocation.point का इस्तेमाल करें.

फ़ील्ड
value
(deprecated)

string

समर्थन नहीं होना या रुकना.

यूनियन फ़ील्ड Id. समर्थन नहीं होना या रुकना. Id इनमें से सिर्फ़ एक हो सकती है:
place_id
(deprecated)

string

समर्थन नहीं होना या रुकना.

generated_id
(deprecated)

string

समर्थन नहीं होना या रुकना.

TrafficPolylineData

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

फ़ील्ड
traffic_rendering

VisualTrafficReportPolylineRendering

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

भ्रमण

यात्रा का मेटाडेटा.

फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. "providers/{provider}/Trips/{trip}" फ़ॉर्मैट में

vehicle_id

string

इस यात्रा के लिए वाहन का आईडी.

trip_status

TripStatus

यात्रा की मौजूदा स्थिति.

trip_type

TripType

यात्रा किस तरह की है.

pickup_point

TerminalLocation

वह जगह जहां ग्राहक ने बताया है कि उसे पिक अप किया जाएगा.

actual_pickup_point

StopLocation

सिर्फ़ इनपुट. वह जगह जहां से ग्राहक को पिक अप किया गया था और जहां से उसे पिक अप किया गया था. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है. वह पिक अप की असल जानकारी के बारे में सुझाव, शिकायत या राय दे सकता है.

actual_pickup_arrival_point

StopLocation

सिर्फ़ इनपुट. पिकअप पॉइंट पर ड्राइवर के पहुंचने का असल समय और जगह. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है. वह पिक अप पॉइंट पर पहुंचने के समय की असल जानकारी के बारे में सुझाव या राय दे सकता है.

pickup_time

Timestamp

सिर्फ़ आउटपुट के लिए. राइडर के पिक अप होने का अनुमानित समय या राइड पिक अप करने का असल समय.

intermediate_destinations[]

TerminalLocation

यात्रा के अनुरोध के हिसाब से बीच के स्टॉप (पिकअप और ड्रॉप-ऑफ़ के अलावा). शुरुआत में, शेयर की गई यात्राओं के लिए यह सुविधा उपलब्ध नहीं होगी.

intermediate_destinations_version

Timestamp

इससे पता चलता है कि intermediate_destinations में पिछली बार कब बदलाव किया गया था. आपके सर्वर को इस वैल्यू को कैश मेमोरी में सेव करना चाहिए. साथ ही, intermediate_destination_index को अपडेट करते समय, इसे UpdateTripRequest में पास करना चाहिए, ताकि intermediate_destinations में कोई बदलाव न हो.

intermediate_destination_index

int32

TripStatus के ENROUTE_TO_INTERMEDIATE_DESTINATION होने पर, [0..N-1] के बीच की संख्या होती है. इससे पता चलता है कि वाहन आगे किस बीच को पार करेगा. TripStatus के ARRIVED_AT_INTERMEDIATE_DESTINATION होने पर, [0..N-1] के बीच की एक संख्या होती है, जो बताती है कि वाहन किस बीच की जगह पर है. सेवा देने वाली कंपनी, इस वैल्यू को सेट करती है. अगर कोई intermediate_destinations नहीं है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है.

actual_intermediate_destination_arrival_points[]

StopLocation

सिर्फ़ इनपुट. किसी इंटरमीडिएट मंज़िल पर ड्राइवर के पहुंचने का असल समय और जगह. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है. वह बीच के डेस्टिनेशन पर पहुंचने पर, सफ़र की असल जानकारी के बारे में सुझाव या राय दे सकता है.

actual_intermediate_destinations[]

StopLocation

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

dropoff_point

TerminalLocation

वह जगह जहां ग्राहक यह बताता है कि उसे सेवा से हटा दिया जाएगा.

actual_dropoff_point

StopLocation

सिर्फ़ इनपुट. वह समय और जगह जहां ग्राहक को सेवा से हटाया गया था. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वह ड्रॉप-ऑफ़ की असल जानकारी के बारे में सुझाव दे सके.

dropoff_time

Timestamp

सिर्फ़ आउटपुट के लिए. यात्री को आखिरी मंज़िल तक पहुंचने के समय का अनुमानित समय या उस समय का, जब वे फ़्लाइट बीच में छोड़ दिए गए थे.

remaining_waypoints[]

TripWaypoint

सिर्फ़ आउटपुट के लिए. मौजूदा जगह से ड्रॉप-ऑफ़ पॉइंट तक का पूरा पाथ. इसमें शामिल है. इस रास्ते में दूसरी यात्राओं के वेपॉइंट शामिल हो सकते हैं.

vehicle_waypoints[]

TripWaypoint

यह फ़ील्ड यात्रा के लिए वेपॉइंट के मैन्युअल क्रम का समर्थन करता है. इसमें असाइन किए गए वाहन के लिए बाकी सभी वेपॉइंट होते हैं, साथ ही इस यात्रा के लिए पिकअप और ड्रॉप-ऑफ़ वेपॉइंट भी होते हैं. अगर यात्रा किसी वाहन को असाइन नहीं की गई है, तो फ़्लीट इंजन इस फ़ील्ड को अनदेखा कर देता है. निजता की वजह से, इस फ़ील्ड में सर्वर की ओर से सिर्फ़ UpdateTrip और CreateTrip कॉल के लिए जानकारी अपने-आप भर जाती है, GetTrip कॉल के लिए नहीं.

route[]

LatLng

सिर्फ़ आउटपुट के लिए. शेष_वेपॉइंट में पहली प्रवेश तक इस यात्रा के लिए अनुमानित रास्ता. ध्यान दें कि पहला वेपॉइंट किसी दूसरी यात्रा से जुड़ा हो सकता है.

current_route_segment

string

सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट के लिए कोड में बदला गया पाथ.

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

current_route_segment_version

Timestamp

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि रास्ते में पिछली बार कब बदलाव किया गया था.

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

current_route_segment_traffic

ConsumableTrafficPolyline

सिर्फ़ आउटपुट के लिए. current_route_segment के उपलब्ध होने पर, उसके साथ-साथ ट्रैफ़िक की स्थिति के बारे में बताता है.

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

current_route_segment_traffic_version

Timestamp

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि current_route_segment_traffic में पिछली बार कब बदलाव किया गया था.

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

current_route_segment_end_point

TripWaypoint

सिर्फ़ आउटपुट के लिए. वह वेपॉइंट जहां current_route_segment खत्म होता है.

remaining_distance_meters

Int32Value

सिर्फ़ आउटपुट के लिए. current_route_segment फ़ील्ड में शेष ड्राइविंग दूरी. अगर यात्रा किसी वाहन के लिए असाइन नहीं की गई है, या यात्रा पूरी हो गई है या रद्द हो गई है, तो वैल्यू के बारे में नहीं बताया गया है.

eta_to_first_waypoint

Timestamp

सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट के लिए ETA (remaining_waypoints फ़ील्ड में पहली एंट्री). अगर यात्रा किसी वाहन के लिए असाइन नहीं की गई है या यात्रा बंद है (पूरी या रद्द हो गई है), तो वैल्यू के बारे में नहीं बताया गया है.

remaining_time_to_first_waypoint

Duration

सिर्फ़ आउटपुट के लिए. यात्रा का डेटा मिलने से लेकर, Trip.eta_to_first_waypoint में दिखाए जाने वाले समय तक की अवधि. अगर यात्रा किसी वाहन के लिए असाइन नहीं की गई है या यात्रा बंद है (पूरी या रद्द हो गई है), तो वैल्यू के बारे में नहीं बताया गया है.

remaining_waypoints_version

Timestamp

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पिछली बार remaining_waypoints को कब बदला गया था (वेपॉइंट जोड़ा गया था, हटाया गया था या बदला गया था).

remaining_waypoints_route_version

Timestamp

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि remaining_waypoints.path_to_waypoint और remaining_waypoints.traffic_to_waypoint में पिछली बार कब बदलाव किया गया था. आपके क्लाइंट ऐप्लिकेशन को इस वैल्यू को कैश मेमोरी में सेव करना चाहिए और इसे GetTripRequest में पास करना चाहिए, ताकि यह पक्का किया जा सके कि remaining_waypoints के पाथ और ट्रैफ़िक को सिर्फ़ अपडेट करने पर ही दिखाया जाए.

number_of_passengers

int32

इम्यूटेबल. इस यात्रा में यात्रियों की संख्या दिखाता है और इसमें ड्राइवर शामिल नहीं है. SearchVehicles के रिस्पॉन्स में वाहन लौटाने की सुविधा उपलब्ध होनी चाहिए.

last_location

VehicleLocation

सिर्फ़ आउटपुट के लिए. रास्ते में वाहन जिस जगह पर मौजूद था उसकी जानकारी देता है.

last_location_snappable

bool

सिर्फ़ आउटपुट के लिए. यह बताता है कि वाहन के last_location को मौजूदा_route_segment में स्नैप किया जा सकता है या नहीं. last_location या current_route_segment मौजूद न होने पर गलत होता है. इसकी गणना Fleet Engine से की जाती है. क्लाइंट के किसी भी अपडेट को अनदेखा कर दिया जाएगा.

view

TripView

यात्रा फ़ील्ड का वह सबसेट जो भरा गया है और उसे कैसे समझा जाना चाहिए.

TripStatus

किसी यात्रा की स्थिति, जिससे पता चलता है कि यात्रा आगे बढ़ रही है.

Enums
UNKNOWN_TRIP_STATUS डिफ़ॉल्ट, इसका इस्तेमाल यात्रा की ऐसी स्थिति के लिए किया जाता है जिसके बारे में जानकारी नहीं है या जिसकी पहचान नहीं की जा सकी है.
NEW नई यात्रा की योजना.
ENROUTE_TO_PICKUP ड्राइवर पिकअप पॉइंट पर रास्ते में है.
ARRIVED_AT_PICKUP ड्राइवर पिक अप पॉइंट पर पहुंच गया है.
ARRIVED_AT_INTERMEDIATE_DESTINATION ड्राइवर किसी इंटरमीडिएट जगह पर पहुंच गया है और यात्री का इंतज़ार कर रहा है.
ENROUTE_TO_INTERMEDIATE_DESTINATION ड्राइवर किसी इंटरमीडिएट मंज़िल (ड्रॉपऑफ़ पॉइंट पर नहीं) पर जा रहा है.
ENROUTE_TO_DROPOFF ड्राइवर ने यात्री को पकड़ लिया है और वह अगली मंज़िल पर पहुंचने के लिए रास्ते में है.
COMPLETE यात्री को छोड़ दिया गया है और यात्रा पूरी हो गई है.
CANCELED ड्राइवर, राइडर या राइडशेयरिंग की सुविधा देने वाली कंपनी के पिकअप से पहले ही यात्रा को रद्द कर दिया गया था.

TripType

यात्रा किस तरह की है.

Enums
UNKNOWN_TRIP_TYPE डिफ़ॉल्ट, इसका इस्तेमाल उन यात्रा टाइप के लिए किया जाता है जिनके बारे में जानकारी नहीं है या जिनकी पहचान नहीं हो पाई है.
SHARED यात्रा के लिए वाहन को दूसरी यात्राओं के साथ शेयर किया जा सकता है.
EXCLUSIVE यह यात्रा खास तौर पर वाहन के लिए है.

TripView

GetTrip जवाब में, यात्रा फ़ील्ड के अलग-अलग सेट के लिए सिलेक्टर. ज़्यादा जानकारी के लिए, AIP-157 देखें. इसमें और व्यू जोड़े जा सकते हैं.

Enums
TRIP_VIEW_UNSPECIFIED डिफ़ॉल्ट वैल्यू. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई डिफ़ॉल्ट रूप से SDK टूल व्यू पर सेट होगा. यह पक्का करने के लिए कि स्थिरता और सहायता मिलती रहे, ग्राहकों को SDK के अलावा, कोई TripView चुनने की सलाह दी जाती है.
SDK इसमें वे फ़ील्ड शामिल होते हैं जिन्हें सार्वजनिक तौर पर उपलब्ध लाइब्रेरी का इस्तेमाल करके, न तो समझा जा सकता है और न ही उनके साथ काम किया जा सकता है.
JOURNEY_SHARING_V1S यात्रा के फ़ील्ड में, गतिविधि के डेटा को शेयर करने की सुविधा के इस्तेमाल के उदाहरण की जानकारी अपने-आप भर जाती है. यह व्यू, सर्वर-टू-सर्वर कम्यूनिकेशन के लिए है.

TripWaypoint

यह वाहन के रास्ते के रुकने की जगह या वाहन की यात्रा के आखिरी पॉइंट के बारे में बताता है.

फ़ील्ड
location

TerminalLocation

इस वेपॉइंट की जगह.

trip_id

string

इस वेपॉइंट से जुड़ी यात्रा.

waypoint_type

WaypointType

इस यात्रा में वेपॉइंट की भूमिका होती है, जैसे कि पिकअप या ड्रॉपऑफ़.

path_to_waypoint[]

LatLng

पिछले वेपॉइंट से मौजूदा वेपॉइंट तक का पाथ. सूची के पहले वेपॉइंट के लिए तय नहीं किया गया है. यह फ़ील्ड सिर्फ़ अनुरोध किए जाने पर ही भरा जाता है.

encoded_path_to_waypoint

string

पिछले वेपॉइंट से मौजूदा वेपॉइंट तक का कोड में बदला गया पाथ.

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

traffic_to_waypoint

ConsumableTrafficPolyline

इस वेपॉइंट के रास्ते पर लागू ट्रैफ़िक की स्थिति. ध्यान दें कि ट्रैफ़िक सिर्फ़ Google Maps Platform के राइड और डिलीवरी सलूशन के ग्राहकों के लिए उपलब्ध है.

distance_meters

Int32Value

पिछले वेपॉइंट से मौजूदा वेपॉइंट तक के पथ की दूरी. सूची के पहले वेपॉइंट के लिए तय नहीं किया गया है.

eta

Timestamp

इस वेपॉइंट पर पहुंचने का अनुमानित समय. सूची के पहले वेपॉइंट के लिए तय नहीं किया गया है.

duration

Duration

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

UpdateTripRequest

UpdateTrip अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

name

string

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

trip

Trip

ज़रूरी है. अपडेट से जुड़ी यात्रा.

इन फ़ील्ड का रखरखाव फ़्लीट इंजन करता है. Trip.update का इस्तेमाल करके इन्हें अपडेट न करें.

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

शेयर की गई यात्रा के लिए Trip.vehicle_id अपडेट करते समय, आपको बाकी बचे वेपॉइंट का क्रम तय करने के लिए Trip.vehicle_waypoints की सूची देनी होगी. ऐसा न करने पर, ऑर्डर तय नहीं होगा.

जब आप Trip.vehicle_waypoints के बारे में बताते हैं, तो सूची में वाहन की यात्राओं के बाकी वेपॉइंट शामिल होने चाहिए. इसमें कोई अतिरिक्त वेपॉइंट नहीं होना चाहिए. आपको इन वेपॉइंट को इस तरह ऑर्डर करना चाहिए कि किसी यात्रा के लिए, पिकअप पॉइंट इंटरमीडिएट डेस्टिनेशन से पहले का हो और सभी इंटरमीडिएट डेस्टिनेशन, ड्रॉप-ऑफ़ पॉइंट से पहले आते हों. EXCLUSIVE यात्रा के वेपॉइंट किसी दूसरी यात्रा के साथ इंटरलीव नहीं होने चाहिए. trip_id, waypoint_type, और location फ़ील्ड का इस्तेमाल किया जाता है. साथ ही, vehicle_waypoints में मौजूद अन्य सभी TripWaypoint फ़ील्ड को अनदेखा कर दिया जाता है.

एक से ज़्यादा मंज़िलों वाली यात्राओं के लिए रेस की स्थिति से बचने के लिए, यात्रा की स्थिति को ENROUTE_TO_INTERMEDIATE_DESTINATION पर अपडेट करते समय आपको Trip.intermediate_destinations_version देना चाहिए. पास किया गया Trip.intermediate_destinations_version, Fleet Engine के वर्शन के मुताबिक होना चाहिए. अगर ऐसा नहीं है, तो अनुरोध पूरा नहीं होगा.

update_mask

FieldMask

ज़रूरी है. फ़ील्ड मास्क से पता चलता है कि 'ट्रिप' में किन फ़ील्ड को अपडेट करना है. update_mask में कम से कम एक फ़ील्ड होना चाहिए.

UpdateVehicleAttributesRequest

UpdateVehicleAttributes के अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

name

string

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

attributes[]

VehicleAttribute

ज़रूरी है. अपडेट किए जाने वाले वाहन के एट्रिब्यूट. जिन एट्रिब्यूट का ज़िक्र नहीं किया गया है उनमें न तो कोई बदलाव किया जाता है और न ही उन्हें हटाया जाता है.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes जवाब वाला मैसेज.

फ़ील्ड
attributes[]

VehicleAttribute

ज़रूरी है. वाहन के एट्रिब्यूट की अपडेट की गई पूरी सूची. इनमें नए, बदले गए, और बिना बदलाव वाले एट्रिब्यूट शामिल हैं.

UpdateVehicleRequest

`UpdateVehicle के अनुरोध का मैसेज.

फ़ील्ड
header

RequestHeader

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

name

string

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

vehicle

Vehicle

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

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

अगर attributes फ़ील्ड को अपडेट किया जाता है, तो वाहन के सभी एट्रिब्यूट को, अनुरोध में दिए गए एट्रिब्यूट से बदल दिया जाता है. अगर आपको सिर्फ़ कुछ एट्रिब्यूट अपडेट करने हैं, तो UpdateVehicleAttributes तरीका देखें.

इसी तरह, waypoints फ़ील्ड को भी अपडेट किया जा सकता है. हालांकि, इसमें मौजूदा वे सभी पॉइंट होने चाहिए जो वाहन पर मौजूद हैं. इसके अलावा, कोई अन्य वेपॉइंट नहीं होना चाहिए.

update_mask

FieldMask

ज़रूरी है. एक फ़ील्ड मास्क, जो बताता है कि Vehicle के किन फ़ील्ड को अपडेट करना है. कम से कम एक फ़ील्ड का नाम देना ज़रूरी है.

वाहन

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

फ़ील्ड
name

string

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

vehicle_state

VehicleState

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

supported_trip_types[]

TripType

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

current_trips[]

string

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

last_location

VehicleLocation

गाड़ी की आखिरी बार जगह की जानकारी रिपोर्ट की गई.

maximum_capacity

int32

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

attributes[]

VehicleAttribute

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

vehicle_type

VehicleType

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

license_plate

LicensePlate

वाहन की लाइसेंस प्लेट की जानकारी.

route[]
(deprecated)

TerminalLocation

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

current_route_segment

string

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

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

current_route_segment_traffic

TrafficPolylineData

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

current_route_segment_version

Timestamp

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

current_route_segment_end_point

TripWaypoint

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

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

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

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

remaining_time_seconds

Int32Value

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

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

waypoints[]

TripWaypoint

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

waypoints_version

Timestamp

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

back_to_back_enabled

bool

यह बताता है कि ड्राइवर पीछे की ओर जाने की मंज़ूरी देता है या नहीं. अगर true, SearchVehicles है, तो वाहन को शामिल किया जा सकता है, भले ही उसे अभी यात्रा के लिए असाइन किया गया हो. डिफ़ॉल्ट वैल्यू false है.

navigation_status

NavigationStatus

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

device_settings

DeviceSettings

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

VehicleType

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

फ़ील्ड
category

Category

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

कैटगरी

वाहन किस तरह का है इसकी कैटगरी

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

VehicleAttribute

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

फ़ील्ड
key

string

एट्रिब्यूट की कुंजी. कुंजियों में कोलन वर्ण (:) नहीं होना चाहिए.

value

string

एट्रिब्यूट की वैल्यू.

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

string

स्ट्रिंग टाइप की गई विशेषता मान.

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

bool_value

bool

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

number_value

double

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

VehicleAttributeList

वाहन की विशेषताओं के लिए, सूचियों की सूची वाला डेटा टाइप.

फ़ील्ड
attributes[]

VehicleAttribute

इस कलेक्शन में मौजूद एट्रिब्यूट की सूची.

VehicleLocation

किसी समय पर वाहन की जगह, स्पीड, और हेडिंग.

फ़ील्ड
location

LatLng

वाहन की जगह. जब वाहन को Fleet Engine को भेजा जाता है, तब उसकी जगह की जानकारी जीपीएस से मिलती है. जवाब के जवाब में, वाहन की जगह की जानकारी, जीपीएस से मिली जगह की जानकारी, पूरक जगह या कोई दूसरी अनुमानित जगह हो सकती है. सोर्स की जानकारी location_sensor में दी गई है.

horizontal_accuracy
(deprecated)

DoubleValue

अब काम नहीं करता: