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

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

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

4. फ़ील्ड मास्क में routes.duration फ़ील्ड के बारे में बताएं.

   आराम

   -H X-Goog-FieldMask: routes.duration

   आरपीसी

   const (fieldMask = "routes.duration")

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

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

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