उन सभी DeliveryVehicle
को हासिल करता है जो फ़िल्टर करने की, तय की गई शर्तों को पूरा करते हैं.
एचटीटीपी अनुरोध
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
header |
ज़रूरी नहीं. स्टैंडर्ड डिलीवरी एपीआई अनुरोध का हेडर. |
pageSize |
ज़रूरी नहीं. लौटाए जाने वाले वाहन की ज़्यादा से ज़्यादा संख्या. सेवा इस संख्या से कम लौटाएगी. अगर आप यह संख्या नहीं देते हैं, तो सर्वर यह तय करता है कि कितने नतीजे वापस करने हैं. |
pageToken |
ज़रूरी नहीं. पिछले पेजों पर नंबर डालते समय, |
filter |
ज़रूरी नहीं. डिलीवरी करने वाले वाहनों की सूची बनाते समय लागू करने के लिए फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरणों के लिए, http://aip.dev/160 देखें. अगर आपने वैल्यू की जानकारी नहीं दी है या फ़िल्टर के लिए खाली स्ट्रिंग डाली है, तो डिलीवरी वाले सभी वाहन लौटाए जाते हैं. ध्यान दें कि किसी फ़िल्टर क्वेरी में ज़्यादा से ज़्यादा 50 पाबंदियां लगाई जा सकती हैं. पाबंदी, |
viewport |
ज़रूरी नहीं. इस फ़िल्टर की मदद से, सिर्फ़ वे वाहन दिखाए जा सकते हैं जिनकी आखिरी बार जगह, व्यूपोर्ट में बताए गए आयताकार इलाके में मौजूद थी. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
deliveryVehicles.list
रिस्पॉन्स मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"deliveryVehicles": [
{
object ( |
फ़ील्ड | |
---|---|
deliveryVehicles[] |
डिलीवरी करने वाले वाहनों का वह सेट जो अनुरोध किए गए फ़िल्टर करने की शर्तों को पूरा करता है. अगर कोई फ़िल्टर नहीं चुना गया है, तो अनुरोध, डिलीवरी वाले सभी वाहनों को दिखाता है. कामयाब जवाब वाला फ़ील्ड भी खाली हो सकता है. खाली जवाब से पता चलता है कि डिलीवरी करने वाला कोई भी वाहन अनुरोध किए गए फ़िल्टर की शर्तों को पूरा नहीं करता. |
nextPageToken |
नतीजों की सूची बनाते रहने के लिए, इस टोकन को |
totalSize |
सभी पेजों पर, अनुरोध की शर्तों को पूरा करने वाले डिलीवरी वाहनों की कुल संख्या. |
व्यूपोर्ट
अक्षांश-देशांतर व्यूपोर्ट, जिसे low
और high
पॉइंट के दो तिरछे तरीके से दिखाया गया है. व्यूपोर्ट को एक बंद क्षेत्र माना जाता है, यानी कि इसमें इसकी सीमा शामिल होती है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच और देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए. कई मामलों में ये शामिल हैं:
अगर
low
=high
है, तो व्यूपोर्ट में वह सिंगल पॉइंट होता है.अगर
low.longitude
>high.longitude
में, देशांतर की रेंज उलटी हो जाती है (व्यूपोर्ट में 180 डिग्री देशांतर लाइन है).अगर
low.longitude
= -180 डिग्री औरhigh.longitude
= 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं.अगर
low.longitude
= 180 डिग्री औरhigh.longitude
= -180 डिग्री है, तो देशांतर रेंज खाली होती है.अगर
low.latitude
>high.latitude
, अक्षांश की रेंज खाली है.
low
और high
, दोनों में जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स खाली नहीं होना चाहिए (जैसा कि ऊपर दी गई परिभाषाओं में बताया गया है). व्यूपोर्ट को खाली छोड़ने पर गड़बड़ी हो सकती है.
उदाहरण के लिए, यह व्यूपोर्ट न्यूयॉर्क शहर को पूरी तरह से घेरता है:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON के काेड में दिखाना |
---|
{ "low": { object ( |
फ़ील्ड | |
---|---|
low |
ज़रूरी है. व्यूपोर्ट का निचला पॉइंट. |
high |
ज़रूरी है. व्यूपोर्ट का सबसे ऊपरी पॉइंट. |