फ़िल्टर करने के लिए तय की गई शर्तों को पूरा करने वाले सभी DeliveryVehicle
दिखाता है.
एचटीटीपी अनुरोध
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
header |
ज़रूरी नहीं. Delivery API के अनुरोध का स्टैंडर्ड हेडर. |
page |
ज़रूरी नहीं. लौटाए जाने वाले वाहनों की ज़्यादा से ज़्यादा संख्या. हो सकता है कि सेवा इस संख्या से कम नतीजे दिखाए. अगर आप यह संख्या नहीं देते हैं, तो सर्वर यह तय करता है कि कितने नतीजे वापस करने हैं. |
page |
ज़रूरी नहीं. पेज टोकन, जो पिछले पेज बनाते समय, |
filter |
ज़रूरी नहीं. डिलीवरी करने वाले वाहनों की सूची बनाते समय लागू करने के लिए फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरणों के लिए, http://aip.dev/160 देखें. अगर आपने कोई वैल्यू नहीं दी है या फ़िल्टर के लिए कोई खाली स्ट्रिंग दी है, तो सभी डिलीवरी वाहन दिखाए जाते हैं. ध्यान दें कि सिर्फ़ वाहन के एट्रिब्यूट (जैसे कि किसी फ़िल्टर क्वेरी में ज़्यादा से ज़्यादा 50 पाबंदियां लगाई जा सकती हैं. पाबंदी, |
viewport |
ज़रूरी नहीं. यह फ़िल्टर, उन वाहनों को दिखाता है जिनकी पिछली जगह की जानकारी, व्यूपोर्ट के दायरे में मौजूद आयताकार इलाके में थी. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
deliveryVehicles.list
का जवाब देने वाला मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"deliveryVehicles": [
{
object ( |
फ़ील्ड | |
---|---|
delivery |
डिलीवरी वाहनों का सेट, जो फ़िल्टर करने के लिए बताई गई शर्तों को पूरा करता है. कोई फ़िल्टर तय न करने पर, अनुरोध से सभी डिलीवरी वाहन दिखते हैं. कामयाब जवाब वाला फ़ील्ड भी खाली हो सकता है. खाली जवाब का मतलब है कि फ़िल्टर के लिए बताई गई शर्तों को पूरा करने वाला कोई डिलीवरी वाहन नहीं मिला. |
next |
नतीजों की सूची जारी रखने के लिए, इस टोकन को |
total |
सभी पेजों पर, अनुरोध की ज़रूरी शर्तों से मैच करने वाले डिलीवरी वाहनों की कुल संख्या. |
व्यूपोर्ट
अक्षांश-देशांतर व्यूपोर्ट, जिसे डायगनल के दो विपरीत 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 |
ज़रूरी है. व्यूपोर्ट का सबसे ऊपरी हिस्सा. |