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

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

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

  • ट्रैफ़िक के बारे में जानकारी -- सबसे सटीक नतीजे दिखाता है. हालांकि, इसके लिए ज़्यादा समय लगता है.

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

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

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