ट्रैफ़िक मॉडल, खास एल्गोरिदम और फ़ैक्टर का इस्तेमाल करके यह अनुमान लगाते हैं कि ट्रैफ़िक की स्थितियां, किसी दिए गए रास्ते पर लगने वाली यात्रा में लगने वाले कुल समय पर कैसे असर डालती हैं. रूट एपीआई में, अलग-अलग तरह के ट्रैफ़िक मॉडल होते हैं. इनका इस्तेमाल, ट्रैफ़िक की अवधि का हिसाब लगाने में इस्तेमाल की जाने वाली अलग-अलग चीज़ों को प्राथमिकता देने के लिए किया जाता है. अपने रूट या रूट मैट्रिक्स की अवधि का हिसाब लगाते समय, आपके हिसाब से ट्रैफ़िक मॉडल का टाइप तय किया जा सकता है. ट्रैफ़िक मॉडल का टाइप सेट करने पर, duration
फ़ील्ड में दिखने वाली वैल्यू, आपके चुने गए ट्रैफ़िक मॉडल के आधार पर अलग-अलग होती है.
रूट एपीआई Compute Routes
और Compute Route Matrix
, दोनों ही तरीके ट्रैफ़िक मॉडल के साथ काम करते हैं.
डिफ़ॉल्ट रूप से, दोनों तरीकों में BEST_GUESS
ट्रैफ़िक मॉडल टाइप का इस्तेमाल किया जाता है.
ट्रैफ़िक प्रकार बताने के लिए
अपनी यात्रा का शुरुआत की जगह और मंज़िल सेट करें.
अगर आपकी रवानगी का समय आगे का है, तो
departure_time
पैरामीटर का इस्तेमाल करके, समय को शामिल करें. अगर आप जाने का समय नहीं बताते हैं, तो यह डिफ़ॉल्ट रूप से पर सेट होता है.trafficModel
पैरामीटर और इनमें से किसी एक टाइप के साथ इस्तेमाल करने के लिए, ट्रैफ़िक मॉडल चुनें:BEST_GUESS
(डिफ़ॉल्ट) यह अनुरोध करने के लिए कि लौटाया गयाduration_in_traffic
, यात्रा में लगने वाले समय का सबसे सही अनुमान है. यह पुराने ट्रैफ़िक की स्थिति और लाइव ट्रैफ़िक, दोनों की जानकारी है.departure_time
के आस-पास होने पर, लाइव ट्रैफ़िक ज़्यादा ज़रूरी हो जाता है.BEST_GUESS
के डिफ़ॉल्ट टाइप का इस्तेमाल करने से, इस्तेमाल के ज़्यादातर मामलों में सबसे काम के अनुमान मिलते हैं.यह अनुरोध करने के लिए
PESSIMISTIC
कि लौटाए गएduration_in_traffic
, खराब ट्रैफ़िक वाले दिनों के दौरान, ट्रैफ़िक की पुरानी शर्तों के आधार पर समय का मॉडल बना सकते हैं. इस टाइप से अनुमानित समय की जानकारी मिलती है, जो ज़्यादातर दिनों में यात्रा में लगने वाले असल समय से ज़्यादा हो सकती है. कभी-कभी खराब स्थिति वाले दिन भी इस अनुमान से ज़्यादा हो सकते हैं.यह अनुरोध करने के लिए
OPTIMISTIC
कि वापस लौटाए गएduration_in_traffic
, ट्रैफ़िक वाले दिनों के पुराने ट्रैफ़िक की स्थितियों के आधार पर समय का मॉडल बना सकते हैं. इस टाइप से अनुमानित समय की जानकारी मिलती है, जो ज़्यादातर दिनों में यात्रा में लगने वाले असल समय से कम हो सकती है. कभी-कभी ख़ास तौर पर अच्छी स्थिति वाले दिन भी इस अनुमान से ज़्यादा तेज़ हो सकते हैं.
उदाहरण के लिए:
"trafficModel": "OPTIMISTIC"
फ़ील्ड मास्क में
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"