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

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

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