इस दस्तावेज़ में डिलीवरी करने वाले वाहनों की लिस्टिंग बनाने का तरीका बताया गया है.
एनवायरमेंट और सीमाएं
सर्वर या ब्राउज़र एनवायरमेंट से डिलीवरी वाहनों को लिस्ट किया जा सकता है. द ड्राइवर SDK टूल, डिलीवरी करने वाले वाहनों की लिस्टिंग बनाने की सुविधा नहीं देता.
डिलीवरी वाहनों की लिस्टिंग करने के लिए, डिलीवरी वाहनों का ऐक्सेस मांगा जाता है. यह ऐक्सेस सिर्फ़ भरोसेमंद लोगों को दिया जाता है. डिलीवरी फ़्लीट रीडर या फ़्लीट इंजन का इस्तेमाल करें लिस्ट की डिलीवरी करने वाले वाहनों के लिए, सूची बनाने के अनुरोध करते समय, डिलीवरी एडमिन टोकन.
लिस्ट किए गए डिलीवरी वाहनों के असर की वजह से, इन फ़ील्ड को छिपाने के लिए बदलाव किया जाता है रिस्पॉन्स के साइज़ के हिसाब से:
CurrentRouteSegment
RemainingVehicleJourneySegments
इस्तेमाल
एट्रिब्यूट के फ़िल्टर और व्यूपोर्ट की सीमाओं के हिसाब से, वाहनों को लिस्ट किया जा सकता है. अगर आपने कोई फ़िल्टर या व्यूपोर्ट नहीं बताया है, तो जवाब में डिलीवरी के सभी वाहन शामिल होंगे.
एट्रिब्यूट के फ़िल्टर वाली सूची
डिलीवरी करने वाले वाहनों को फ़िल्टर करके, उनकी attributes
प्रॉपर्टी का इस्तेमाल करके उनकी सूची बनाई जा सकती है. इसके लिए
उदाहरण के लिए, my_key
और वैल्यू my_value
वाली किसी एट्रिब्यूट से क्वेरी करने के लिए,
attributes.my_key = my_value
. एक से ज़्यादा एट्रिब्यूट से जुड़ी क्वेरी करने के लिए, क्वेरी को जोड़ें
attributes.key1 = value1 AND
attributes.key2 = value2
जैसे लॉजिकल AND
और OR
ऑपरेटर का इस्तेमाल करके. पूरी जानकारी के लिए, AIP-160 पर जाएं
फ़िल्टर क्वेरी सिंटैक्स का. अगर फ़िल्टर को व्यूपोर्ट बाउंड के साथ जोड़ा जाता है, तो फ़िल्टर
व्यूपोर्ट बाउंड के लिए AND
ऑपरेटर के रूप में काम करता है. ज़्यादा जानकारी के लिए, वाहन के एट्रिब्यूट फ़िल्टर करने वाली क्वेरी देखें.
व्यूपोर्ट की सीमाओं के साथ सूची
viewport
अनुरोध का इस्तेमाल करके, सूची में दिए गए डिलीवरी वाहनों को जगह के हिसाब से फ़िल्टर किया जा सकता है
पैरामीटर. viewport
अनुरोध पैरामीटर, दो बाउंडिंग का इस्तेमाल करके व्यूपोर्ट को तय करता है
निर्देशांक: एक high
(उत्तर-पूर्व) और low
(दक्षिण-पश्चिम) अक्षांश और देशांतर
निर्देशांकों की जोड़ी होती है. अनुरोध तब अस्वीकार किए जाते हैं, जब उनका अक्षांश ज़्यादा होता है
जो भौगोलिक दृष्टि से कम अक्षांश से नीचे है.
जवाबों की सूची बनाएं
डिलीवरी करने वाले वाहनों की सूचियां, डिफ़ॉल्ट रूप से पेजों पर व्यवस्थित की जाती हैं. इसके लिए, पेज का साइज़ सही होता है. अगर आपने तो पेज का साइज़ तय करने पर, अनुरोध सिर्फ़ वाहनों की संख्या दिखाता है सीमा या कम से तय होता है. अगर अनुरोध किया गया पेज साइज़, इंटरनल ज़्यादा से ज़्यादा वैल्यू से ज़्यादा है, तो इंटरनल ज़्यादा से ज़्यादा वैल्यू का इस्तेमाल किया जाता है. डिफ़ॉल्ट और सबसे ज़्यादा दिखने वाला पेज दोनों साइज़ 100 वाहन हैं.
डिलीवरी करने वाले वाहनों की सूची में, टोकन शामिल किया जा सकता है, ताकि इसका अगला पेज पढ़ा जा सके नतीजे. पेज टोकन, रिस्पॉन्स में सिर्फ़ तब मौजूद होता है, जब डिलीवरी के लिए ज़्यादा पेज मौजूद होते हैं वाहन वापस पाने के लिए उपलब्ध हैं. टास्क का अगला पेज फिर से पाने के लिए, इसका इस्तेमाल करें पिछले अनुरोध वाले पेज टोकन के जैसा अनुरोध.
वाहनों के उदाहरणों की सूची बनाएं
Java gRPC लाइब्रेरी या REST का इस्तेमाल करके डिलीवरी वाहनों को किसी एट्रिब्यूट वाले इलाके की खोज करें. सही जवाब अब भी खाली. अगर ऐसा होता है, तो इसका मतलब है कि इस एट्रिब्यूट वाले किसी भी वाहन पर तय व्यूपोर्ट में मौजूद है.
Java
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Tasks request
String parent = "providers/" + PROJECT_ID;
ListDeliveryVehiclesRequest listDeliveryVehiclesRequest =
ListDeliveryVehiclesRequest.newBuilder() // No need for the header
.setParent(parent)
.setViewport(
Viewport.newBuilder()
.setHigh(LatLng.newBuilder()
.setLatitude(37.45)
.setLongitude(-122.06)
.build())
.setLow(LatLng.newBuilder()
.setLatitude(37.41)
.setLongitude(-122.11)
.build())
.setFilter("attributes.my_key = my_value")
.build();
try {
ListDeliveryVehiclesResponse listDeliveryVehiclesResponse =
deliveryService.listDeliveryVehicles(listDeliveryVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
आराम
# HTTP request
html GET https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles
# Request with a filter
# Request sets JWT, PROJECT_ID, and VEHICLE_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?filter=attributes.my_key%20%3D%20my_value%20&viewport.high.latitude=37.45&viewport.high.longitude=-122.06&viewport.low.latitude=37.41&viewport.low.longitude=-122.11"
अगर लुकअप पूरा हो जाता है, तो रिस्पॉन्स बॉडी में नीचे दिए गए स्ट्रक्चर वाला डेटा शामिल होता है:
// JSON representation
{
"deliveryVehicles": [
{
object (DeliveryVehicle)
}
],
"nextPageToken": string,
"totalSize": integer
}