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

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

अगर आपका बिलिंग पता यूरोपियन इकनॉमिक एरिया में है, तो 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 की वैल्यू नहीं दी है, तो अनुरोध किए जाने के समय को ही प्रस्थान का समय माना जाएगा. इसका मतलब है कि अनुरोध भेजे जाने के समय के आधार पर, आपको अलग-अलग वैल्यू मिल सकती हैं.