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

ट्रैफ़िक मॉडल, खास एल्गोरिदम और फ़ैक्टर का इस्तेमाल करके यह अनुमान लगाते हैं कि ट्रैफ़िक की स्थितियां, किसी दिए गए रास्ते के लिए यात्रा में लगने वाले कुल समय पर किस तरह असर डालती हैं. Routes API, अलग-अलग तरह के ट्रैफ़िक मॉडल ऑफ़र करता है, ताकि ट्रैफ़िक का हिसाब लगाते समय इस्तेमाल किए जाने वाले अलग-अलग फ़ैक्टर को प्राथमिकता दी जा सके. अपने रूट या रूट मैट्रिक्स की अवधि का कैलकुलेशन करते समय, रूट तय किया जा सकता है. ट्रैफ़िक मॉडल टाइप सेट करने पर, duration फ़ील्ड में दिखने वाली वैल्यू, आपके चुने गए ट्रैफ़िक मॉडल के आधार पर अलग-अलग होती है.

रूट एपीआई 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 फ़ील्ड डालें.

    रेस्ट

    -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"