इस्तेमाल करने के लिए ट्रैफ़िक मॉडल का टाइप तय करें

यह प्रॉडक्ट या सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है (Pre-GA). ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता ही मिले. साथ ही, Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

ट्रैफ़िक मॉडल, खास एल्गोरिदम और फ़ैक्टर का इस्तेमाल करके यह अनुमान लगाते हैं कि किसी रास्ते पर ट्रैफ़िक की स्थिति, यात्रा के कुल समय पर कैसे असर डालती है. Routes API, ट्रैफ़िक में लगने वाले समय का हिसाब लगाने के लिए, अलग-अलग तरह के ट्रैफ़िक मॉडल उपलब्ध कराता है. इन मॉडल की मदद से, ट्रैफ़िक में लगने वाले समय का हिसाब लगाने के लिए इस्तेमाल किए जाने वाले अलग-अलग फ़ैक्टर को प्राथमिकता दी जाती है. अपने रास्तों या रास्ते के मैट्रिक के लिए, यात्रा की अवधि का हिसाब लगाते समय, आपके पास ट्रैफ़िक मॉडल टाइप तय करने का विकल्प होता है. ट्रैफ़िक मॉडल का टाइप सेट करने पर, duration फ़ील्ड में दिखने वाली वैल्यू, आपके चुने गए ट्रैफ़िक मॉडल के हिसाब से अलग-अलग होती है.

Routes API Compute Routes और Compute Route Matrix, दोनों तरीके ट्रैफ़िक मॉडल टाइप के साथ काम करते हैं.

डिफ़ॉल्ट रूप से, दोनों तरीके BEST_GUESS ट्रैफ़िक मॉडल टाइप का इस्तेमाल करते हैं.

ट्रैफ़िक का टाइप तय करने के लिए

1. ऑरिजिन और डेस्टिनेशन सेट करें.

2. अगर फ़्लाइट का फ़्लाइट शेड्यूल आने वाले समय के लिए है, तो departure_time पैरामीटर का इस्तेमाल करके समय शामिल करें. अगर आपने जाने का समय नहीं बताया है, तो यह डिफ़ॉल्ट रूप से अभी पर सेट हो जाता है.

3. trafficModel पैरामीटर के साथ इस्तेमाल करने के लिए, ट्रैफ़िक मॉडल चुनें और इनमें से कोई एक टाइप चुनें:

   • BEST_GUESS (डिफ़ॉल्ट) का इस्तेमाल करके अनुरोध करें कि दिखाया गया duration_in_traffic, यात्रा के समय का सबसे सही अनुमान है. यह अनुमान, ट्रैफ़िक की पुरानी स्थितियों और लाइव ट्रैफ़िक, दोनों के आधार पर लगाया जाता है. departure_time के अब होने के जितने करीब होगा, ट्रैफ़िक के लाइव अपडेट उतने ही ज़्यादा अहम होंगे. BEST_GUESS के डिफ़ॉल्ट टाइप का इस्तेमाल करने से, इस्तेमाल के ज़्यादातर उदाहरणों के लिए सबसे ज़्यादा काम के अनुमान मिलते हैं.

   • PESSIMISTIC, यह अनुरोध करता है कि लौटाए गए duration_in_traffic मॉडल में, ट्रैफ़िक के खराब दिनों के हिसाब से, समय का अनुमान लगाया जाए. इस तरह की जानकारी से, यात्रा में लगने वाले अनुमानित समय का पता चलता है. यह समय, ज़्यादातर दिनों में यात्रा में लगने वाले असल समय से ज़्यादा होता है. हालांकि, कभी-कभी खराब परिस्थितियों में, यह अनुमानित समय ज़्यादा हो सकता है.

   • OPTIMISTIC का अनुरोध किया जा सकता है, ताकि ट्रैफ़िक के अच्छे दिनों के ट्रैफ़िक की पुरानी स्थितियों के आधार पर, रिटर्न किए गए duration_in_traffic से समय का अनुमान लगाया जा सके. इस तरह की जानकारी से, यात्रा में लगने वाले समय का अनुमान मिलता है. यह अनुमानित समय, ज़्यादातर दिनों में यात्रा में लगने वाले असल समय से कम होता है. कभी-कभी, खास तौर पर अच्छी परिस्थितियों में, डिवाइस को चार्ज होने में इस अनुमान से कम समय लग सकता है.

   उदाहरण के लिए:

   "trafficModel": "OPTIMISTIC"

   ध्यान दें: BEST_GUESS, लाइव ट्रैफ़िक की जानकारी को इंटिग्रेट करने के तरीके की वजह से, हो सकता है कि BEST_GUESS के हिसाब से यात्रा का अनुमानित समय, OPTIMISTIC से कम या PESSIMISTIC से ज़्यादा हो.

4. फ़ील्ड मास्क में routes.duration फ़ील्ड की जानकारी दें.

   REST

   -H X-Goog-FieldMask: routes.duration

   आरपीसी

   const (fieldMask = "routes.duration")

Routes API, ट्रैफ़िक में लगने वाले समय का अनुमान लगाते समय, आपके अनुरोध किए गए ट्रैफ़िक मॉडल टाइप का इस्तेमाल करता है.

उदाहरण: ट्रैफ़िक मॉडल का अनुरोध

उदाहरण के लिए, इस अनुरोध में बताया गया है कि यात्रा में लगने वाले समय का अनुमान, OPTIMISTIC किसी खास समय पर ट्रैफ़िक मॉडल टाइप का इस्तेमाल करके लगाया जाए:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

यह अनुरोध, यात्रा के लिए OPTIMISTIC ट्रैफ़िक मॉडल के टाइप का इस्तेमाल करके, अनुमानित समय दिखाता है:

"duration": "1238s"

ट्रैफ़िक मॉडल टाइप को PESSIMISTIC में बदलने पर, दिखने वाली अवधि ज़्यादा होती है:

"duration": "2436s"

ध्यान दें: अगर आपने departureTime की वैल्यू नहीं दी है, तो प्रस्थान का समय, अनुरोध करने का समय माना जाएगा. इसका मतलब है कि अनुरोध भेजे जाने के समय के आधार पर, आपको अलग-अलग वैल्यू मिल सकती हैं.