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

ट्रैफ़िक मॉडल, कुछ खास एल्गोरिदम और फ़ैक्टर का इस्तेमाल करते हैं. इससे यह अनुमान लगाया जाता है कि किसी रास्ते पर ट्रैफ़िक की वजह से, यात्रा में लगने वाले कुल समय पर क्या असर पड़ेगा. 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

   आरपीसी

   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"