Package maps.fleetengine.v1

इंडेक्स

TripService

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

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

यह फ़ंक्शन, Fleet Engine में ट्रिप बनाता है और नई ट्रिप दिखाता है.

DeleteTrip

rpc DeleteTrip(DeleteTripRequest) returns (Empty)

यह कुकी, किसी एक यात्रा को मिटाती है.

अगर यात्रा चालू है और उसे किसी वाहन को असाइन किया गया है, तो यह फ़ंक्शन FAILED_PRECONDITION दिखाता है.

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

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

DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

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

अगर वाहन को चालू ट्रिप असाइन की गई हैं, तो FAILED_PRECONDITION दिखाता है.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Fleet Engine से किसी वाहन की जानकारी दिखाता है.

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

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

parent

string

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

trip_id

string

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

  • यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म सी के हिसाब से नॉर्मलाइज़ किया गया हो.
  • इसमें ये 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

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

parent

string

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

vehicle_id

string

ज़रूरी है. वाहन का यूनीक आईडी. इन पाबंदियों के साथ:

  • यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म सी के हिसाब से नॉर्मलाइज़ किया गया हो.
  • इसमें ये 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

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

DeleteTripRequest

DeleteTrip अनुरोध वाला मैसेज.

फ़ील्ड
header

RequestHeader

ज़रूरी नहीं. Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

name

string

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

DeleteVehicleRequest

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

फ़ील्ड
header

RequestHeader

ज़रूरी नहीं. Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

name

string

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

DeviceSettings

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

फ़ील्ड
location_power_save_mode

LocationPowerSaveMode

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

is_power_save_mode

bool

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

is_interactive

bool

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

battery_info

BatteryInfo

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

GetTripRequest

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

फ़ील्ड
header

RequestHeader

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

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
(deprecated)

Timestamp

बंद कर दिया गया: Trip.remaining_waypoints हमेशा वापस पाए जाते हैं. remaining_waypoints_route_version का इस्तेमाल करके यह कंट्रोल करें कि Trip.remaining_waypoints.traffic_to_waypoint और Trip.remaining_waypoints.path_to_waypoint डेटा कब वापस पाया जाए.

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 फ़ील्ड सेट नहीं किया जाता है. अगर कम से कम वैल्यू तय नहीं की जाती है, तो ट्रैफ़िक का डेटा हमेशा वापस पाया जाता है. ध्यान दें कि ट्रैफ़िक की जानकारी सिर्फ़ On-Demand Rides and Deliveries Solution के ग्राहकों के लिए उपलब्ध है.

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

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

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 CD" -> "3"
  • "ABCDEF" -> "-1"

ListVehiclesRequest

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

फ़ील्ड
header

RequestHeader

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

parent

string

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

page_size

int32

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

page_token

string

next_page_token की वैल्यू, ListVehicles को किए गए पिछले कॉल से मिली है. इससे आपको वाहनों के ग्रुप के हिसाब से पेज नंबर बदलने में मदद मिलती है. अगर अनुरोध के फ़िल्टर करने की शर्त, 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
...)

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

required_one_of_attributes[]

string

इस फ़िल्टर से, जवाब में सिर्फ़ ऐसे वाहन दिखते हैं जिनमें हर VehicleAttributeList में कम से कम एक एट्रिब्यूट मौजूद हो. हर सूची में, किसी वाहन के लिए कम से कम एक एट्रिब्यूट का मेल खाना ज़रूरी है. यह फ़ील्ड, हर VehicleAttributeList में एक डिसजंक्शन/OR ऑपरेशन है. साथ ही, VehicleAttributeList के कलेक्शन में एक कंजंक्शन/AND ऑपरेशन है. दोहराई गई हर स्ट्रिंग, "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 में कंजंक्शन/AND ऑपरेशन होता है. साथ ही, 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 Undefined 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 GPS या असिस्टेड GPS.
NETWORK एसिस्टेड जीपीएस, सेल टॉवर आईडी या वाईफ़ाई ऐक्सेस पॉइंट.
PASSIVE मोबाइल टावर आईडी या वाई-फ़ाई ऐक्सेस पॉइंट.
ROAD_SNAPPED_LOCATION_PROVIDER मोबाइल डिवाइस से पता लगाई गई ऐसी जगह जो सड़क पर मौजूद होने की सबसे ज़्यादा संभावना रखती है.
CUSTOMER_SUPPLIED_LOCATION किसी ग्राहक की दी गई जगह की जानकारी, जो किसी स्वतंत्र स्रोत से मिली हो. आम तौर पर, इस वैल्यू का इस्तेमाल उस जगह की जानकारी के लिए किया जाता है जो Driver SDK चलाने वाले मोबाइल डिवाइस के अलावा किसी अन्य सोर्स से मिली हो. अगर ओरिजनल सोर्स को अन्य enum वैल्यू में से किसी एक से दिखाया गया है, तो उस वैल्यू का इस्तेमाल करें. CUSTOMER_SUPPLIED_LOCATION के तौर पर मार्क की गई जगहों की जानकारी आम तौर पर, वाहन के last_location.supplemental_location_sensor के ज़रिए दी जाती है.
FLEET_ENGINE_LOCATION Fleet Engine, उपलब्ध सिग्नल के आधार पर इस जगह का हिसाब लगाता है. सिर्फ़ आउटपुट के लिए. अगर यह वैल्यू किसी अनुरोध में मिलती है, तो इसे अस्वीकार कर दिया जाएगा.
FUSED_LOCATION_PROVIDER Android का Fused Location Provider.
CORE_LOCATION Apple के ऑपरेटिंग सिस्टम पर जगह की जानकारी देने वाली सेवा.

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

Enums
UNKNOWN_NAVIGATION_STATUS नेविगेशन की स्थिति के बारे में कोई जानकारी नहीं है.
NO_GUIDANCE ड्राइवर ऐप्लिकेशन का नेविगेशन FREE_NAV मोड में है.
ENROUTE_TO_DESTINATION मोड़-दर-मोड़ नेविगेशन उपलब्ध है और Driver ऐप्लिकेशन का नेविगेशन 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

RequestHeader में ऐसे फ़ील्ड होते हैं जो Fleet Engine के सभी आरपीसी अनुरोधों में शामिल होते हैं.

फ़ील्ड
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

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

device_model

string

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

sdk_type

SdkType

अनुरोध भेजने वाला एसडीके किस तरह का है.

maps_sdk_version

string

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

nav_sdk_version

string

NavSDK का वह वर्शन जिस पर कॉलिंग SDK टूल निर्भर करता है. यह जानकारी तब दिखती है, जब लागू हो. वर्शन का फ़ॉर्मैट "major.minor.patch" होता है. उदाहरण: 2.1.0.

platform

Platform

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

manufacturer

string

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

android_api_level

int32

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

trace_id

string

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

प्लैटफ़ॉर्म

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

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

SdkType

एसडीके के संभावित टाइप.

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

SearchTripsRequest

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

फ़ील्ड
header

RequestHeader

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

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

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

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 कैटगरी वाले VehicleTypes की अनुमति नहीं है.

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

इससे खोज के नतीजे सिर्फ़ उन वाहनों तक सीमित हो जाते हैं जिनमें बताए गए एट्रिब्यूट मौजूद होते हैं. यह फ़ील्ड, कंजंक्शन/AND ऑपरेशन है. ज़्यादा से ज़्यादा 50 required_attributes इस्तेमाल किए जा सकते हैं. यह किसी वाहन के लिए अनुमति वाले एट्रिब्यूट की ज़्यादा से ज़्यादा संख्या से मेल खाता है.

required_one_of_attributes[]

VehicleAttributeList

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

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 में कंजंक्शन/AND ऑपरेशन होता है. साथ ही, 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

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

place

string

उस जगह का संसाधन नाम जो इस जगह को दिखाता है. फ़ॉर्मैट places/{place_id} है. इनपुट के तौर पर point या place में से किसी एक की जानकारी देना ज़रूरी है. अगर दोनों दिए गए हैं, तो रूटिंग के लिए point और मेटाडेटा के लिए place का इस्तेमाल किया जाएगा. place को सिर्फ़ तब आउटपुट में शामिल किया जाता है, जब इसे इनपुट में शामिल किया गया हो. इसका मतलब है कि LatLng से place लुकअप नहीं किया जाता है.

इस सुविधा को प्रयोग के तौर पर दिया जा रहा है.

point_location_source

PointSource

सिर्फ़ आउटपुट के लिए. point फ़ील्ड का सोर्स.

terminal_point_id
(deprecated)

TerminalPointId

बंद कर दिया गया: इसके बजाय, place फ़ील्ड की वैल्यू डालें.

access_point_id
(deprecated)

string

बंद कर दिया गया: इसके बजाय, place फ़ील्ड की वैल्यू डालें.

trip_id
(deprecated)

string

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

terminal_location_type
(deprecated)

WaypointType

बंद कर दिया गया: Vehicle.waypoint में यह डेटा होगा.

PointSource

इससे LatLng के सोर्स के बारे में पता चलता है.

Enums
POINT_SOURCE_UNSPECIFIED पॉइंट सोर्स की जानकारी नहीं दी गई है.
POINT_SOURCE_DEVELOPER_PROVIDED LatLng को डेवलपर ने साफ़ तौर पर उपलब्ध कराया था.
POINT_SOURCE_CALCULATED_FROM_PLACE LatLng को दी गई जगह के हिसाब से कैलकुलेट किया गया था.

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_destinations में बदलाव न हो, इसके लिए intermediate_destination_index अपडेट करते समय इसे UpdateTripRequest में पास करना चाहिए.

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

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

route[]

LatLng

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

current_route_segment

string

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

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

current_route_segment_version

Timestamp

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

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है.

current_route_segment_traffic

ConsumableTrafficPolyline

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

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है.

current_route_segment_traffic_version

Timestamp

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

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है.

current_route_segment_end_point

TripWaypoint

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

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट (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 को current_route_segment पर स्नैप किया जा सकता है या नहीं. अगर last_location या current_route_segment मौजूद नहीं है, तो यह वैल्यू 'गलत है' पर सेट होती है. इसका हिसाब Fleet Engine लगाता है. क्लाइंट से मिले किसी भी अपडेट को अनदेखा कर दिया जाएगा.

view

TripView

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

attributes[]

TripAttribute

यात्रा के कस्टम एट्रिब्यूट की सूची. हर एट्रिब्यूट की एक यूनीक कुंजी होनी चाहिए.

TripAttribute

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

फ़ील्ड
key

string

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

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

string

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

bool_value

bool

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

number_value

double

डबल टाइप की गई एट्रिब्यूट वैल्यू.

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 के बजाय TripView को चुनें. इससे उन्हें बेहतर सहायता मिलेगी और वे आसानी से काम कर पाएंगे.
SDK इसमें ऐसे फ़ील्ड शामिल हैं जिन्हें सार्वजनिक तौर पर उपलब्ध लाइब्रेरी का इस्तेमाल करके समझा या इस्तेमाल नहीं किया जा सकता.
JOURNEY_SHARING_V1S यात्रा की जानकारी देने वाले फ़ील्ड, यात्रा की जानकारी शेयर करने के इस्तेमाल के उदाहरण के लिए भरे जाते हैं. यह व्यू, एक सर्वर से दूसरे सर्वर के साथ कम्यूनिकेशन के लिए है.

TripWaypoint

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

फ़ील्ड
location

TerminalLocation

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

trip_id

string

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

waypoint_type

WaypointType

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

path_to_waypoint[]

LatLng

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

encoded_path_to_waypoint

string

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

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

traffic_to_waypoint

ConsumableTrafficPolyline

इस वेपॉइंट तक पहुंचने के रास्ते पर ट्रैफ़िक की स्थिति. ध्यान दें कि ट्रैफ़िक की जानकारी सिर्फ़ Google Maps Platform Rides and Deliveries Solution के ग्राहकों के लिए उपलब्ध है.

distance_meters

Int32Value

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

eta

Timestamp

इस वेपॉइंट पर पहुंचने का अनुमानित समय.

duration

Duration

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

UpdateTripRequest

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

फ़ील्ड
header

RequestHeader

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

name

string

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

trip

Trip

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

इन फ़ील्ड को Fleet Engine मैनेज करता है. 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

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

name

string

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

attributes[]

VehicleAttribute

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

UpdateVehicleAttributesResponse

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

फ़ील्ड
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

`UpdateVehicle request message.

फ़ील्ड
header

RequestHeader

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.

name

string

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

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

वाहन की पिछली बार रिपोर्ट की गई जगह की जानकारी.

past_locations[]

VehicleLocation

सिर्फ़ इनपुट के लिए. वे जगहें जहां यह वाहन पहले था, लेकिन उनकी जानकारी अब तक Fleet Engine को नहीं दी गई है. इसका इस्तेमाल UpdateVehicleRequest में उन जगहों की जानकारी रिकॉर्ड करने के लिए किया जाता है जिन्हें पहले सर्वर पर नहीं भेजा जा सका था. आम तौर पर, ऐसा तब होता है, जब कार में इंटरनेट कनेक्शन न हो.

maximum_capacity

int32

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

attributes[]

VehicleAttribute

वाहन के एट्रिब्यूट की सूची. किसी वाहन के लिए ज़्यादा से ज़्यादा 100 एट्रिब्यूट हो सकते हैं. साथ ही, हर एट्रिब्यूट के लिए एक यूनीक कुंजी होनी चाहिए.

vehicle_type

VehicleType

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

license_plate

LicensePlate

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

route[]
(deprecated)

TerminalLocation

इस्तेमाल बंद कर दिया गया है: इसके बजाय, Vehicle.waypoints का इस्तेमाल करें.

current_route_segment

string

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

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

current_route_segment_traffic

TrafficPolylineData

सिर्फ़ इनपुट के लिए. Fleet Engine इस जानकारी का इस्तेमाल, यात्रा की जानकारी शेयर करने की सुविधा को बेहतर बनाने के लिए करता है. ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver 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 हो सकता है. इसके बाद, Fleet Engine पूरी कोशिश करेगा कि अगर वेपॉइंट की जानकारी पूरी तरह से नहीं दी गई है, तो उसे इंटरपोलेट करके असली वेपॉइंट में बदल दिया जाए. अगर current_route_segment की वैल्यू भी दी गई है, तो UpdateVehicle कॉल में इस फ़ील्ड को नज़रअंदाज़ नहीं किया जाता.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

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

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

remaining_time_seconds

Int32Value

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

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

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

इस्तेमाल बंद कर दिया गया है: इसके बजाय, latlng_accuracy का इस्तेमाल करें.

latlng_accuracy

DoubleValue

रेडियस के तौर पर, location मीटर की सटीक जानकारी.

heading

Int32Value

वाहन किस दिशा में जा रहा है, यह डिग्री में बताया जाता है. 0 का मतलब उत्तर है. मान्य रेंज [0,360) है.

bearing_accuracy
(deprecated)

DoubleValue

इस्तेमाल बंद कर दिया गया है: इसके बजाय, heading_accuracy का इस्तेमाल करें.

heading_accuracy

DoubleValue

डिग्री में heading की सटीक वैल्यू.

altitude

DoubleValue

WGS84 से ऊपर की ऊंचाई, मीटर में.

vertical_accuracy
(deprecated)

DoubleValue

इस्तेमाल बंद कर दिया गया है: इसके बजाय, altitude_accuracy का इस्तेमाल करें.

altitude_accuracy

DoubleValue

मीटर में altitude की सटीक जानकारी.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

वाहन की रफ़्तार, मीटर/सेकंड में

speed_accuracy

DoubleValue

मीटर/सेकंड में speed की सटीक जानकारी.

update_time

Timestamp

सेंसर की घड़ी के हिसाब से, सेंसर ने location का पता कब लगाया.

server_time

Timestamp

सिर्फ़ आउटपुट के लिए. वह समय जब सर्वर को जगह की जानकारी मिली.

location_sensor

LocationSensor

लोकेशन का डेटा उपलब्ध कराने वाली कंपनी (उदाहरण के लिए, GPS).

is_road_snapped

BoolValue

क्या location को किसी सड़क पर स्नैप किया गया है.

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

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

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

वाहन की जगह की कच्ची जानकारी (रोड-स्नैपर से प्रोसेस नहीं की गई).

raw_location_time

Timestamp

जगह की जानकारी के रॉ डेटा से जुड़ा टाइमस्टैंप.

raw_location_sensor

LocationSensor

जगह की प्रोसेस न की गई जानकारी का सोर्स. डिफ़ॉल्ट रूप से, यह GPS पर सेट होती है.

raw_location_accuracy

DoubleValue

मीटर में, raw_location की सटीक जानकारी.

flp_location

LatLng

Android के Fused Location Provider से मिली जगह की जानकारी.

flp_update_time

Timestamp

flp_location के अपडेट का टाइमस्टैंप

flp_latlng_accuracy_meters

DoubleValue

रेडियस के तौर पर, flp_location मीटर की सटीक जानकारी.

flp_heading_degrees

Int32Value

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

supplemental_location

LatLng

इंटिग्रेट किए गए ऐप्लिकेशन से मिली अतिरिक्त जगह की जानकारी.

supplemental_location_time

Timestamp

पूरक जगह की जानकारी से जुड़ा टाइमस्टैंप.

supplemental_location_sensor

LocationSensor

पूरक जगह की जानकारी का सोर्स. डिफ़ॉल्ट रूप से, यह CUSTOMER_SUPPLIED_LOCATION पर सेट होती है.

supplemental_location_accuracy

DoubleValue

मीटर में, supplemental_location की सटीक जानकारी.

road_snapped
(deprecated)

bool

इस्तेमाल बंद कर दिया गया है: इसके बजाय, is_road_snapped का इस्तेमाल करें.

VehicleMatch

इसमें वाहन और उससे जुड़े अनुमान शामिल होते हैं. ये अनुमान, वाहन SearchVehiclesRequest की चालू यात्राओं के पॉइंट से मेल खाते हैं.

फ़ील्ड
vehicle

Vehicle

ज़रूरी है. अनुरोध से मेल खाने वाला वाहन.

vehicle_pickup_eta

Timestamp

अनुरोध में बताए गए पिकअप पॉइंट तक पहुंचने में वाहन को लगने वाला समय. खाली वैल्यू से पता चलता है कि वाहन के लिए ईटीए का हिसाब नहीं लगाया जा सका. अगर SearchVehiclesRequest.include_back_to_back true था और इस वाहन से कोई यात्रा चालू है, तो vehicle_pickup_eta में मौजूदा यात्रा को पूरा करने में लगने वाला समय शामिल होता है.

vehicle_pickup_distance_meters

Int32Value

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

vehicle_pickup_straight_line_distance_meters

Int32Value

ज़रूरी है. वाहन और अनुरोध में बताई गई पिकअप जगह के बीच सीधी दूरी.

vehicle_dropoff_eta

Timestamp

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

vehicle_pickup_to_dropoff_distance_meters

Int32Value

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

trip_type

TripType

ज़रूरी है. यह उस यात्रा का टाइप है जिसका इस्तेमाल, पिकअप पॉइंट तक पहुंचने का अनुमानित समय (ईटीए) कैलकुलेट करने के लिए किया गया था.

vehicle_trips_waypoints[]

Waypoint

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

vehicle_match_type

VehicleMatchType

वाहन के मैच का टाइप.

requested_ordered_by

VehicleMatchOrder

वाहन के मिलान को क्रम से लगाने के लिए अनुरोध किया गया क्रम. ordered_by के बराबर.

ordered_by

VehicleMatchOrder

वाहन के मिलान को क्रम से लगाने के लिए अनुरोध किया गया क्रम. requested_ordered_by के बराबर.

VehicleMatchType

वाहन के मिलान का टाइप.

Enums
UNKNOWN वाहन के मैच टाइप की जानकारी नहीं है
EXCLUSIVE फ़िलहाल, वाहन को कोई यात्रा असाइन नहीं की गई है और वह पिकअप पॉइंट पर जा सकता है.
BACK_TO_BACK फ़िलहाल, वाहन को किसी यात्रा के लिए असाइन किया गया है. हालांकि, यात्रा पूरी होने के बाद, वह पिकअप पॉइंट पर जा सकता है. ईटीए और दूरी की कैलकुलेशन में, मौजूदा यात्रा को ध्यान में रखा जाता है.
CARPOOL गाड़ी में शेयर की गई राइड के लिए काफ़ी जगह हो.
CARPOOL_BACK_TO_BACK वाहन, पिकअप पॉइंट पर पहुंचने से पहले अपनी मौजूदा यात्रा पूरी करेगा. ईटीए और दूरी की कैलकुलेशन में, मौजूदा यात्रा को ध्यान में रखा जाता है.

VehicleState

Vehicle की स्थिति.

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

VisualTrafficReportPolylineRendering

इससे पता चलता है कि क्लाइंट को रास्ते के साथ-साथ पॉलीलाइन के एक हिस्से को कैसे रंगना चाहिए.

फ़ील्ड
road_stretch[]

RoadStretch

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

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

RoadStretch

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

फ़ील्ड
style

Style

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

offset_meters

int32

ज़रूरी है. स्टाइल, [offset_meters, offset_meters + length_meters) के बीच लागू होना चाहिए.

length_meters

int32

ज़रूरी है. स्टाइल को लागू करने के लिए पाथ की लंबाई.

शैली

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

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

वेपॉइंट

SearchVehiclesResponse में मौजूद VehicleMatch के लिए, रूट पर मौजूद इंटरमीडिएट पॉइंट के बारे में बताता है. इस कॉन्सेप्ट को अन्य सभी एंडपॉइंट में TripWaypoint के तौर पर दिखाया गया है.

फ़ील्ड
lat_lng

LatLng

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

eta

Timestamp

इस वेपॉइंट पर वाहन के पहुंचने का अनुमानित समय.

WaypointType

वेपॉइंट किस तरह का है.

Enums
UNKNOWN_WAYPOINT_TYPE वेपॉइंट के टाइप की जानकारी नहीं है या उसके बारे में बताया नहीं गया है.
PICKUP_WAYPOINT_TYPE राइडर या आइटम को पिक अप करने के लिए वेपॉइंट.
DROP_OFF_WAYPOINT_TYPE यात्रियों या सामान को ड्रॉप-ऑफ़ करने के लिए वेपॉइंट.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE एक से ज़्यादा मंज़िलों वाली यात्रा में, बीच के गंतव्यों के लिए वेपॉइंट.