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

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

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

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

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

1. शुरुआत की जगह और मंज़िल सेट करें.

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

3. routingPreference पैरामीटर को TRAFFIC_AWARE_OPTIMAL पर सेट करें. routingPreference को TRAFFIC_UNAWARE या TRAFFIC_AWARE पर सेट करना, trafficModel पैरामीटर के साथ काम नहीं करता.

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

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

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

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

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

   "trafficModel": "OPTIMISTIC"

5. फ़ील्ड मास्क में, routes.duration फ़ील्ड तय करें.

   REST

   -H X-Goog-FieldMask: routes.duration

   RPC

   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"