मांग पर यात्रा की सुविधा के तहत, आपको आस-पास की गाड़ियां ढूंढने को मिलेंगी
SearchVehicles
तरीके का इस्तेमाल करके.
SearchVehicles
तरीके का इस्तेमाल करके, अपने आस-पास मौजूद वाहन खोजे जा सकते हैं
किसी खास राइड या डिलीवरी के लिए सबसे सही उपभोक्ता वाला मोबाइल ऐप्लिकेशन
अनुरोध. SearchVehicles
एपीआई, उन वाहनों की रैंक की गई सूची दिखाता है जिनके एट्रिब्यूट, अनुरोध की गई यात्रा के एट्रिब्यूट से मेल खाते हैं. रैंकिंग आपके हिसाब से क्रम में लगाई गई है
पिकअप पॉइंट से पहुंचने का अनुमानित समय, दूरी या सीधी लाइन की दूरी.
Search Network में दिखने वाले प्रॉडक्ट के लिए एट्रिब्यूट | वाहन की विशेषताएं |
---|---|
|
|
SearchVehicles
तरीके का इस्तेमाल करें
SearchVehicles
का इस्तेमाल करने के लिए, यह सामान्य तरीका अपनाएं:
- असाइन की जाने वाली यात्रा के आधार पर,
SearchVehiclesRequest
बनाएं. SearchVehicles
एपीआई (vehicleService.searchVehicles
) को इस तरीके से कॉल करें: बनाया गया अनुरोध.- एपीआई से लौटाए गए
SearchVehicleResponse
को प्रोसेस करें.
SearchVehiclesRequest फ़ील्ड
SearchVehiclesRequest
बनाने के लिए, यहां दिए गए ज़रूरी एट्रिब्यूट फ़ील्ड का इस्तेमाल करें:
फ़ील्ड | ब्यौरा |
---|---|
अभिभावक | ज़रूरी है. प्रोवाइडर/{provider} में होना चाहिए. सेवा देने वाली कंपनी, उस Google Cloud प्रोजेक्ट का प्रोजेक्ट आईडी होनी चाहिए जिसका यह कॉल करने वाला सेवा खाता सदस्य है. |
vehicle_types | ज़रूरी है. वाहनों के टाइप, जैसे कि AUTO, TWO_WHEELER, TAXI, TRUCK, BICYCLE या PEDESTRIAN. |
trip_types | ज़रूरी है. एक्सक्लूज़िव (हर ड्राइवर के लिए एक बार में एक चालू यात्रा) या शेयर किया गया (हर ड्राइवर के लिए एक बार में एक या उससे ज़्यादा यात्राएं). |
minimum_capacity | ज़रूरी है. नई यात्रा के लिए, वाहन में बचे हुए यात्रियों या डिलीवरी के लिए जगह की कम से कम संख्या. |
pickup_point | ज़रूरी है. अक्षांश/देशांतर निर्देशांक में यात्रा से जुड़ी पिकअप की जगह. |
dropoff_point | ज़रूरी नहीं. अक्षांश/देशांतर निर्देशांक में यात्रा के ड्रॉप-ऑफ़ की जगह. अगर trip_types में TripType.SHARED शामिल है, तो इस फ़ील्ड की वैल्यू देना ज़रूरी है. |
pickup_radius_meters | ज़रूरी है. पिकअप पॉइंट से, वाहन खोजने के इलाके का दायरा मीटर में. |
order_by | ज़रूरी है. वाहनों को इनमें से किसी एक के हिसाब से क्रम में लगाएं:
|
सोलर पैनलों की संख्या | ज़रूरी है. ज़्यादा से ज़्यादा 50 वाहनों की जानकारी दिखाने के लिए. |
फ़िल्टर | Optional. वाहनों की खोज करते समय लागू करने के लिए फ़िल्टर क्वेरी. |
का पूरा सेट देखने के लिए संदर्भ दस्तावेज़ देखें SearchVehicleRequest फ़ील्ड.
SearchVehiclesRequest की स्थितियां
इस सेक्शन में, SearchVehiclesRequest
बनाने का तरीका बताया गया है.
उदाहरण के लिए, मान लें कि कोई ग्राहक RestaurantX से पिक अप करना चाहता है, और आपके पास चार वाहन हैं:
- पहला वाहन: RestaurantX से 3,500 मीटर की दूरी पर है.
- वाहन 2: ऐक्टिव ट्रिप और पिकअप की सुविधा वाले रेस्टोरेंटX से 100 मीटर की दूरी पर और जगह A और B पर छोड़ दें.
- तीसरा वाहन: RestaurantX से 200 मीटर दूर है. इसमें एक व्यक्ति को बहुत दूर छोड़ना है.
- वाहन 4: RestaurantX से 1,000 मीटर की दूरी पर है.
इस इमेज में, वाहन के लौटाने के लिए अलग-अलग अनुरोध दिखाए गए हैं.
रिटर्न वाहन 4
Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA
वाहन 3 और 4 को लौटाता है
Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, is_back_to_back enabled
वाहन 2, 3, और 4 वापस करता है
Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, current_trips_present = ALL
SearchVehiclesResponse फ़ील्ड
SearchVehiclesResponse
में VehicleMatch
इकाइयों की सूची होती है, जिन्हें रैंक दी जाती है
SearchVehiclesRequest
में दिए गए order_by एट्रिब्यूट के हिसाब से. हर
VehicleMatch
इकाई में ये फ़ील्ड हैं:
फ़ील्ड | ब्यौरा |
---|---|
गाड़ी | Vehicle ऑब्जेक्ट, जिसमें vehicle_id और Vehicle एट्रिब्यूट शामिल हैं. |
vehicle_pickup_eta | नई यात्रा के पिकअप पॉइंट पर, वाहन के पहुंचने का अनुमानित समय. यह ड्राइविंग के लिए, पहुंचने का अनुमानित समय है. |
vehicle_pickup_distance_meter | वाहन और नई यात्रा की पिकअप जगह के बीच की दूरी, मीटर में. |
vehicle_pickup_straight_line_distance_meter | नई यात्रा के लिए, गाड़ी और पिकअप की जगह के बीच की सीधी लाइन की दूरी. मीटर में. |
vehicle_dropoff_eta | टाइमस्टैंप नई यात्रा के पिकअप स्थान पर वाहन के ETA का. ध्यान दें कि ETA ड्राइविंग ETA है. |
vehicle_trips_waypoints | वाहन को असाइन की गई मौजूदा यात्राओं के लिए, बाकी बचे वे पॉइंट जिन पर वाहन को भेजना है. इनमें पिकअप और ड्रॉप-ऑफ़ पॉइंट भी शामिल हैं. |
vehicle_match_type | वाहन की यात्रा का टाइप, EXCLUSIVE, BACK_TO_BACK, CARPOOL या CARPOOL_BACK_TO_BACK. |
VehicleMatch
फ़ील्ड की पूरी सूची के लिए, यहां देखें:
VehicleMatch message
(जीआरपीसी)VehicleMatch resource
(REST)
फ़िल्टर क्वेरी का इस्तेमाल करना
SearchVehicles
और ListVehicles
में, वाहन के एट्रिब्यूट को फ़िल्टर किया जा सकता है
इसके लिए, फ़िल्टर क्वेरी का इस्तेमाल करें.
फ़िल्टर क्वेरी का इस्तेमाल करके, सिर्फ़ वाहनों के कस्टम एट्रिब्यूट को फ़िल्टर किया जा सकता है और
इसे दूसरे फ़ील्ड के लिए इस्तेमाल नहीं किया जा सकता. जब ऐसी खोज में इस्तेमाल किया जाता है जिसमें अन्य फ़ील्ड शामिल हों
फ़िल्टर क्वेरी, जैसे कि minimum_capacity
या vehicle_types
AND
क्लॉज़ के तौर पर काम करता है.
उदाहरण के लिए, अगर आपने कम से कम छह लोगों के लिए वाहन खोजा है और पालतू जानवरों के साथ यात्रा करने की सुविधा वाले attributes
को फ़िल्टर किया है, तो आपको सिर्फ़ ऐसे वाहन दिखेंगे जिनमें पालतू जानवरों के साथ यात्रा की जा सकती है और जिनमें कम से कम छह लोग बैठ सकते हैं.
फ़िल्टर क्वेरी सिंटैक्स के लिए AIP-160 देखें देखें. वाहन के एट्रिब्यूट बनाने के बारे में जानकारी के लिए, वाहन के फ़ील्ड अपडेट करें गाइड में वाहन के एट्रिब्यूट फ़ील्ड देखें.
SearchVehicles का उदाहरण
नीचे दिए गए उदाहरण में, Java gRPC लाइब्रेरी का इस्तेमाल करके, SearchVehicles
API का इस्तेमाल करने का तरीका बताया गया है.
static final String PROJECT_ID = "project-id";
VehicleServiceBlockingStub vehicleService =
VehicleService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
SearchVehiclesRequest searchVehiclesRequest = SearchVehiclesRequest.newBuilder()
.setParent(parent)
.setPickupPoint( // Grand Indonesia East Mall
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setDropoffPoint( // Balai Sidang Jkt Convention Center
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.213796).setLongitude(106.807195)))
.setPickupRadiusMeters(2000)
.setCount(10)
.setMinimumCapacity(2)
.addTripTypes(TripType.EXCLUSIVE)
.addVehicleTypes(VehicleType.newBuilder().setCategory(Category.AUTO).build())
.setCurrentTripsPresent(CurrentTripsPresent.ANY)
.setFilter("attributes.on_trip=\"false\"")
.setOrderBy(VehicleMatchOrder.PICKUP_POINT_ETA)
.build();
try {
SearchVehiclesResponse searchVehiclesResponse =
vehicleService.searchVehicles(searchVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
List<VehicleMatch> vehicleMatches =
searchVehicleResponse.getMatchesList();
// Each VehicleMatch contains a Vehicle entity and information about the
// distance and ETA to the pickup point and drop-off point.