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

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

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

रूट एपीआई 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 की जानकारी नहीं दी है, तो फ़्लाइट की रवानगी का अनुमानित समय ही अनुरोध का समय होगा. इसका मतलब है कि अनुरोध भेजे जाने के समय के आधार पर, आपको अलग-अलग वैल्यू मिल सकती हैं.