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

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

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

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

अनुरोध करते समय, यह तय करें कि आपको सबसे सटीक नतीजे चाहिए या जल्द से जल्द नतीजे चाहिए. 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 के मोबाइल ऐप्लिकेशन में इस्तेमाल किए जाने वाले मोड के बराबर होती है.

कैलकुलेट रूट मैट्रिक के साथ इस विकल्प का इस्तेमाल करने पर, किसी अनुरोध में एलिमेंट की संख्या (ऑरिजिन की संख्या × डेस्टिनेशन की संख्या)

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

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

• 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 की मदद से, ट्रैफ़िक की जानकारी देने वाली पॉलीलाइन के साथ-साथ ट्रैफ़िक की स्थिति के बारे में जानकारी का अनुरोध किया जा सकता है. ज़्यादा जानकारी के लिए, पॉलीलाइन का अनुरोध करें लेख पढ़ें.