अनुरोध के विकल्पों से मैच करने वाली, सेवा देने वाली कंपनी से जुड़े वाहनों की पेज की गई सूची दिखाता है.
एचटीटीपी अनुरोध
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. यह |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
header |
Fleet Engine के अनुरोध का स्टैंडर्ड हेडर. |
page |
लौटाए जाने वाले वाहनों की ज़्यादा से ज़्यादा संख्या. डिफ़ॉल्ट वैल्यू: 100. |
page |
|
minimum |
इससे, वाहन की कम से कम ज़रूरी क्षमता का पता चलता है. लौटाए गए सभी वाहनों के लिए, |
trip |
इस नीति से, ऐसे वाहनों पर रिस्पॉन्स नहीं दिया जाता जो किसी खास तरह की यात्रा के साथ काम करते हों. |
maximum |
यह उन वाहनों के लिए जवाब देने पर पाबंदी लगाता है जिन्होंने तय समयावधि के दौरान, Fleet Engine को जगह की जानकारी के अपडेट भेजे हैं. स्टेशनरी वाहन अब भी अपनी जगह की जानकारी भेज रहे हैं, तो उन्हें पुराना नहीं माना जाता है. अगर यह मौजूद है, तो एक मान्य धनात्मक अवधि होनी चाहिए. सेकंड में एक अवधि, जिसमें ज़्यादा से ज़्यादा नौ दशमलव अंक होते हैं और जो ' |
vehicle |
ज़रूरी है. यह विकल्प, जवाब को सिर्फ़ उन वाहनों तक सीमित करता है जो तय की गई कैटगरी में शामिल हैं. |
required |
कॉलर
यह विकल्प, तय किए गए एट्रिब्यूट वाले वाहनों के लिए ही जवाब दिखाता है. यह फ़ील्ड एक संयोजन/AND कार्रवाई है. ज़्यादा से ज़्यादा 50 ज़रूरी एट्रिब्यूट जोड़े जा सकते हैं. यह वाहन के लिए तय की गई ज़्यादा से ज़्यादा संख्या से मेल खाती है. दोहराई गई हर स्ट्रिंग, "key:value" फ़ॉर्मैट में होनी चाहिए. |
required |
यह फ़ंक्शन, हर |
required |
इस विकल्प का इस्तेमाल करके, |
vehicle |
इस नीति की मदद से, सिर्फ़ उन वाहनों पर यह कार्रवाई की जा सकती है जिनकी इस स्थिति के लिए वाहन का इस्तेमाल किया गया है. |
on |
सिर्फ़ उन वाहनों की जानकारी दिखाएं जिनका इस्तेमाल मौजूदा यात्रा के लिए किया जा रहा है. |
filter |
ज़रूरी नहीं. वाहनों की लिस्टिंग करते समय लागू करने के लिए फ़िल्टर क्वेरी. फ़िल्टर सिंटैक्स के उदाहरणों के लिए, http://aip.dev/160 देखें. इस फ़ील्ड को यह फ़िल्टर, ध्यान दें कि सिर्फ़ वाहन के एट्रिब्यूट (उदाहरण के लिए, साथ ही, सभी एट्रिब्यूट को स्ट्रिंग के तौर पर सेव किया जाता है. इसलिए, एट्रिब्यूट के लिए सिर्फ़ स्ट्रिंग तुलनाएं ही इस्तेमाल की जा सकती हैं. संख्या या बूलियन वैल्यू की तुलना करने के लिए, वैल्यू को साफ़ तौर पर कोट किया जाना चाहिए, ताकि उन्हें स्ट्रिंग के तौर पर माना जा सके. उदाहरण के लिए, |
viewport |
ज़रूरी नहीं. यह फ़िल्टर, उन वाहनों को दिखाता है जिनकी पिछली जगह की जानकारी, व्यूपोर्ट के दायरे में मौजूद आयताकार इलाके में थी. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
vehicles.list
जवाब का मैसेज.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"vehicles": [
{
object ( |
फ़ील्ड | |
---|---|
vehicles[] |
अनुरोध में बताई गई शर्तों से मेल खाने वाले वाहन. अनुरोध में दिए गए |
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 |
ज़रूरी है. व्यूपोर्ट का सबसे ऊपरी हिस्सा. |