ट्रैफ़िक डेटा का लेवल सेट करना

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

ट्रैफ़िक की प्राथमिकताएं चुनने पर, रास्ते की जानकारी की सटीकता और अनुरोध की परफ़ॉर्मेंस के बीच संतुलन बनाया जाता है. इसके लिए, इनमें से कोई एक तरीका इस्तेमाल किया जाता है:

  • ट्रैफ़िक की जानकारी के साथ -- सबसे सटीक नतीजे दिखाएं (ज़्यादा लेटेंसी).

  • ट्रैफ़िक की जानकारी नहीं है -- नतीजे जल्द से जल्द दिखाओ (सबसे कम लेटेंसी).

अनुरोध करते समय, यह तय करें कि सबसे सटीक नतीजे दिखाना बेहतर है या जल्द से जल्द नतीजे दिखाना बेहतर है. Routes API, ऐसे विकल्प उपलब्ध कराता है जिनकी मदद से, जवाब के डेटा की क्वालिटी और जवाब मिलने में लगने वाले समय को कंट्रोल किया जा सकता है.

ट्रैफ़िक लेवल सेट करने का तरीका

Routes API, RoutingPreference (REST) और RoutingPreference (gRPC) उपलब्ध कराता है. इनकी मदद से, रास्तों का हिसाब लगाने के लिए रास्तों से जुड़ी प्राथमिकताओं को तय किया जा सकता है.

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

ट्रैफ़िक का हाल

ट्रैफ़िक की स्थिति से, ट्रैफ़िक के फ़्लो की दर का पता चलता है:

  • सामान्य ट्रैफ़िक: ट्रैफ़िक सामान्य रफ़्तार से चल रहा है और कोई रुकावट नहीं है.

  • ट्रैफ़िक न कम है, न ज़्यादा: ट्रैफ़िक बढ़ रहा है, लेकिन गाड़ियां धीमी गति से चल रही हैं.

  • बहुत ज़्यादा ट्रैफ़िक: बहुत ज़्यादा ट्रैफ़िक होने की वजह से, वाहनों की रफ़्तार बहुत कम हो जाती है.

ट्रैफ़िक की जानकारी नहीं है

TRAFFIC_UNAWARE डिफ़ॉल्ट सेटिंग है. अगर आपको सबसे कम समय में जवाब चाहिए और रास्ते की सामान्य जानकारी आपके लिए काफ़ी है, तो इस राउटिंग सेटिंग का इस्तेमाल करें.

TRAFFIC_UNAWARE रास्तों का हिसाब लगाते समय, मौजूदा ट्रैफ़िक की स्थितियों को ध्यान में नहीं रखा जाता. इस राउटिंग की प्राथमिकता से, अनुरोध का जवाब सबसे कम समय में मिलता है.

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

आपको ये जवाब दिखेंगे:

  • duration - इसमें रूट के लिए पहुंचने का अनुमानित समय होता है.

  • staticDuration: सिर्फ़ ट्रैफ़िक की पिछली जानकारी के आधार पर, रास्ते के लिए ईटीए. TRAFFIC_UNAWARE के लिए, इसमें वही वैल्यू होती है जो duration में होती है.

ट्रैफ़िक की जानकारी देने वाली सुविधा

इस राउटिंग प्राथमिकता का इस्तेमाल तब करें, जब आपको TRAFFIC_UNAWARE की तुलना में राउटिंग की ज़्यादा सटीक जानकारी चाहिए हो. हालांकि, इससे जवाब मिलने में थोड़ा समय लग सकता है.

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

आपको ये जवाब दिखेंगे:

  • duration: रीयल-टाइम ट्रैफ़िक की जानकारी के हिसाब से ईटीए.

  • staticDuration सिर्फ़ पुराने ट्रैफ़िक की जानकारी के आधार पर, रास्ते के लिए ईटीए.

ट्रैफ़िक के हिसाब से सबसे अच्छा

अगर आपको सबसे अच्छी क्वालिटी के नतीजे चाहिए और आपको इस बात से कोई फ़र्क़ नहीं पड़ता कि जवाब मिलने में कितना समय लगता है, तो इस राउटिंग सेटिंग का इस्तेमाल करें. इस राउटिंग सेटिंग में जवाब मिलने में सबसे ज़्यादा समय लगता है (सबसे ज़्यादा लेटेन्सी).

TRAFFIC_AWARE_OPTIMAL राउटिंग की प्राथमिकता सेट करने पर, सेवा मौजूदा ट्रैफ़िक की स्थितियों को ध्यान में रखकर रास्ते का हिसाब लगाती है. हालांकि, परफ़ॉर्मेंस ऑप्टिमाइज़ेशन लागू नहीं करती है. इस मोड में, सर्वर सड़क नेटवर्क की ज़्यादा बारीकी से जाँच करता है, ताकि सबसे अच्छा रास्ता मिल सके.

TRAFFIC_AWARE_OPTIMAL रास्तों के लिए प्राथमिकता का विकल्प, maps.google.com और Google Maps के मोबाइल ऐप्लिकेशन में इस्तेमाल किए गए मोड के बराबर होता है.

Compute Route Matrix के साथ इस विकल्प का इस्तेमाल करने पर, अनुरोध में मौजूद एलिमेंट की संख्या (ओरिजन की संख्या × डेस्टिनेशन की संख्या) 100 से ज़्यादा नहीं होनी चाहिए

  1. Compute Route Matrix की सीमाओं के बारे में ज़्यादा जानने के लिए, रास्ते की मैट्रिक्स कैलकुलेट करना लेख पढ़ें.

आपको ये जवाब दिखेंगे:

  • duration: रीयल-टाइम ट्रैफ़िक की जानकारी के हिसाब से, रास्ते के लिए ईटीए.

  • staticDuration: सिर्फ़ ट्रैफ़िक की पिछली जानकारी के आधार पर, रास्ते के लिए ईटीए.

जाने का समय सेट करना (ज़रूरी नहीं)

इस प्रॉपर्टी का इस्तेमाल सिर्फ़ उन अनुरोधों के लिए करें जिनमें ट्रैफ़िक की जानकारी शामिल होती है. साथ ही, जिनमें यात्रा शुरू करने का समय आने वाले समय का होना चाहिए. अगर आपने departureTime प्रॉपर्टी सेट नहीं की है, तो यह डिफ़ॉल्ट रूप से उस समय पर सेट हो जाती है जब आपने अनुरोध किया था.

जब आपको किसी रास्ते को चुनते समय, सेवा के ट्रैफ़िक का अनुमान लगाने के तरीके में बदलाव करना हो, तब TRAFFIC_AWARE और TRAFFIC_AWARE_OPTIMAL विकल्पों के साथ departureTime प्रॉपर्टी का इस्तेमाल करें.

  • TRAFFIC_UNAWARE: सुझाया नहीं गया है, क्योंकि रास्ते और अवधि का चुनाव, सड़क नेटवर्क और समय के हिसाब से ट्रैफ़िक की औसत स्थितियों के आधार पर किया जाता है.

  • TRAFFIC_AWARE और TRAFFIC_AWARE_OPTIMAL: इनका इस्तेमाल, आने वाले समय में होने वाली यात्राओं के लिए किया जा सकता है. ऐसा इसलिए, क्योंकि ये प्राथमिकताएं, ट्रैफ़िक की मौजूदा स्थितियों को ध्यान में रखती हैं. लाइव ट्रैफ़िक की जानकारी, departureTime के समय के जितना करीब होगी उतनी ही ज़्यादा ज़रूरी और काम की होगी. यात्रा शुरू करने का समय जितना बाद का चुना जाएगा, रास्तों को चुनते समय ट्रैफ़िक की पुरानी स्थितियों को उतना ही ज़्यादा ध्यान में रखा जाएगा.

उदाहरण: ट्रैफ़िक की जानकारी के हिसाब से रूट चुनने की सुविधा को कैसे चालू करें

यहां दिए गए JSON कोड से पता चलता है कि अनुरोध के मैसेज एंटिटी बॉडी में, TRAFFIC_AWARE_OPTIMAL राउटिंग की प्राथमिकता कैसे सेट की जाती है.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude";:37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

पॉलीलाइन पर ट्रैफ़िक की जानकारी कॉन्फ़िगर करना

Routes API की मदद से, ट्रैफ़िक की जानकारी देने वाली पॉलीलाइन पर ट्रैफ़िक की स्थिति के बारे में जानकारी का अनुरोध किया जा सकता है. ज़्यादा जानकारी के लिए, पॉलीलाइन का अनुरोध करना लेख पढ़ें.