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

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