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

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

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

यह प्रॉडक्ट या सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है (pre-GA). Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको सीमित सहायता मिल सकती है. साथ ही, ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA Offerings पर, 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 की जानकारी नहीं दी है, तो अनुरोध करने के समय को ही प्रस्थान का समय माना जाएगा. इसका मतलब है कि अनुरोध भेजे जाने के समय के हिसाब से, आपको अलग-अलग वैल्यू मिल सकती हैं.