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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

अगर आपका बिलिंग पता यूरोपियन इकनॉमिक एरिया में है, तो 8 जुलाई 2025 से, सेवाओं के आपके इस्तेमाल पर Google Maps Platform की ईईए से जुड़ी सेवा की शर्तें लागू होंगी. यह सुविधा, देश/इलाके के हिसाब से अलग-अलग हो सकती है. ज़्यादा जानें.

यह प्रॉडक्ट या सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है (pre-GA). हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको पूरी सहायता न मिले. साथ ही, ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर, Google Maps Platform की सेवा से जुड़ी खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

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

   ध्यान दें: ऐसा हो सकता है कि BEST_GUESS में यात्रा के अनुमानित समय की जानकारी, OPTIMISTIC से कम या PESSIMISTIC से ज़्यादा हो. ऐसा इसलिए होता है, क्योंकि BEST_GUESS में लाइव ट्रैफ़िक की जानकारी को शामिल करने का तरीका अलग होता है.

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"

ध्यान दें: अगर आपने departureTime की जानकारी नहीं दी है, तो अनुरोध करने के समय को ही यात्रा शुरू करने का समय माना जाएगा. इसका मतलब है कि अनुरोध भेजने के समय के हिसाब से, आपको अलग-अलग वैल्यू मिल सकती हैं.