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

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

Routes API 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"

4. फ़ील्ड मास्क में 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"