आपकी ओर से चुनी गई ट्रैफ़िक प्राथमिकताएं, अनुरोध की परफ़ॉर्मेंस और रूट की जानकारी की सटीक जानकारी को संतुलित करती हैं. अनुरोध करते समय, आपको यह जानना चाहिए कि क्या सबसे सटीक नतीजे दिखाना बेहतर है या जल्द से जल्द नतीजे देना है. Routes API से ऐसे विकल्प मिलते हैं जिनकी मदद से, रिस्पॉन्स डेटा की क्वालिटी बनाम रिस्पॉन्स मिलने के इंतज़ार के समय को कंट्रोल किया जा सकता है.
ट्रैफ़िक डेटा का लेवल सेट करना
Routes API, RoutingPreference (REST) और RoutingPreference (gRPC) उपलब्ध कराता है, ताकि आपको रूट कैलकुलेट करने के लिए रूटिंग की प्राथमिकताएं तय की जा सकें. ये प्राथमिकताएं अलग-अलग तरह की होती हैं, क्योंकि ये ट्रैफ़िक की स्थितियों के हिसाब से रूट की गिनती में अलग-अलग होती हैं. रूटिंग की हर प्राथमिकता से ऐसे नतीजे मिलते हैं जो रूट की क्वालिटी, अनुमानित ईटीए, और रिस्पॉन्स में लगने वाले समय की वजह से अलग-अलग होते हैं.
ट्रैफ़िक की स्थितियां, ट्रैफ़िक फ़्लो की दर की जानकारी देती हैं. उदाहरण के लिए:
- जब ट्रैफ़िक न हो, तो ट्रैफ़िक को सामान्य माना जाता है और ट्रैफ़िक बिना किसी रुकावट के सामान्य तरीके से फ़्लो होता है.
- बिजली की ज़्यादा खपत वाले समय पर, ट्रैफ़िक सघनता बढ़ जाती है. इससे ट्रैफ़िक कम हो जाता है और ट्रैफ़िक कम या ज़्यादा हो जाता है.
- बंपर से बंपर ट्रैफ़िक में, फ़्लो-रेट धीरे-धीरे रुक जाता है, जिससे ट्रैफ़िक की भारी स्थिति पैदा होती है.
ट्रैफ़िक की जानकारी नहीं है
जब TRAFFIC_UNAWARE
रूटिंग की प्राथमिकता सेट की जाती है, तब रास्तों की गिनती मौजूदा ट्रैफ़िक की स्थितियों को ध्यान में किए बिना की जाती है. रूटिंग की इस प्राथमिकता से, रिस्पॉन्स मिलने में लगने वाला सबसे कम समय मिलता है (रिस्पॉन्स सबसे तेज़ी से मिलते हैं).
TRAFFIC_UNAWARE
डिफ़ॉल्ट सेटिंग है.
इस जवाब में:
ETA,
duration
रिस्पॉन्स प्रॉपर्टी में शामिल है.duration
औरstaticDuration
रिस्पॉन्स प्रॉपर्टी की वैल्यू एक ही है.
इस रूटिंग प्राथमिकता का उपयोग तब करें जब आप चाहते हैं कि जवाब जल्द से जल्द वापस आएं और अनुमानित रूटिंग विवरण काफ़ी हों.
ट्रैफ़िक के बारे में जानकारी
जब TRAFFIC_AWARE
रूटिंग की प्राथमिकता सेट की जाती है, तब ट्रैफ़िक की मौजूदा स्थितियों को ध्यान में रखते हुए रास्तों की गिनती की जाती है. इसी वजह से, रास्ते और रास्तों का ब्यौरा, असल हालात की ज़्यादा सटीक जानकारी देता है. डेटा क्वालिटी में होने वाली यह बढ़ोतरी, रिस्पॉन्स में लगने वाले समय की वजह से आती है. इसलिए, परफ़ॉर्मेंस को ऑप्टिमाइज़ करने के लिए ये बदलाव किए जाते हैं, ताकि जवाब मिलने में लगने वाला समय कम किया जा सके.
इस जवाब में:
रीयल-टाइम ट्रैफ़िक को ध्यान में रखते हुए ईटीए,
duration
रिस्पॉन्स प्रॉपर्टी में शामिल होता है.staticDuration
रिस्पॉन्स प्रॉपर्टी में, ट्रैफ़िक की स्थितियों पर ध्यान दिए बिना रूट पर यात्रा करने का कुल समय शामिल होता है.
इस रूटिंग प्राथमिकता का इस्तेमाल तब करें, जब आपको TRAFFIC_UNAWARE
की तुलना में ज़्यादा सटीक रूटिंग जानकारी
चाहिए. हालांकि, अगर जवाब, इंतज़ार के समय में थोड़ी-बहुत बढ़ोतरी करके वापस मिलते हैं, तो आपको कोई परेशानी नहीं है.
ट्रैफ़िक के बारे में बेहतर जानकारी
TRAFFIC_AWARE_OPTIMAL
रूटिंग की प्राथमिकता सेट करने पर, ट्रैफ़िक की मौजूदा स्थितियों के हिसाब से रूट का आकलन किया जाता है. हालांकि, परफ़ॉर्मेंस ऑप्टिमाइज़ेशन लागू नहीं किया जाता. इस मोड में, सर्वर सबसे सही रास्ता ढूंढने के लिए सड़क के नेटवर्क की
ज़्यादा जानकारी खोजता है.
TRAFFIC_AWARE_OPTIMAL
रूटिंग प्राथमिकता, maps.google.com और Google Maps मोबाइल ऐप्लिकेशन पर इस्तेमाल किए जाने वाले मोड के बराबर है.
कंप्यूट रूट मैट्रिक्स के साथ इस विकल्प का इस्तेमाल करने पर, किसी अनुरोध में एलिमेंट की संख्या (ऑरिजिन की संख्या × डेस्टिनेशन की संख्या) 100 से ज़्यादा नहीं हो सकती. कंप्यूट रूट मैट्रिक्स की सीमाओं के बारे में ज़्यादा जानने के लिए, रूट मैट्रिक्स को कैलकुलेट करें देखें.
इस जवाब में:
रीयल-टाइम ट्रैफ़िक को ध्यान में रखते हुए ईटीए,
duration
रिस्पॉन्स प्रॉपर्टी में शामिल होता है.staticDuration
रिस्पॉन्स प्रॉपर्टी में, ट्रैफ़िक की स्थितियों पर ध्यान दिए बिना रूट पर यात्रा करने का कुल समय शामिल होता है.
यह रूटिंग प्राथमिकता, सबसे ज़्यादा प्रतिक्रिया इंतज़ार का समय (यानी, रिस्पॉन्स मिलने में सबसे ज़्यादा देरी के साथ वापस आती है) देती है. इस रूटिंग प्राथमिकता का इस्तेमाल तब करें, जब आपको सबसे अच्छी क्वालिटी के नतीजे चाहिए. इस बात से कोई फ़र्क़ नहीं पड़ता कि रिस्पॉन्स में कितना समय लगा है.
रवानगी का समय सेट करने का असर
आप चाहें, तो किसी यात्रा के लिए जाने का समय सेट करने के लिए, departureTime
प्रॉपर्टी का इस्तेमाल करें. departureTime
प्रॉपर्टी को सेट न करने पर, डिफ़ॉल्ट रूप से अनुरोध करने का समय लागू हो जाता है.
TRAFFIC_UNAWARE
के लिए, आपdepartureTime
सेट नहीं कर सकते, क्योंकि रास्ता और अवधि का चुनाव सड़क के नेटवर्क और औसत समय पर निर्भर ट्रैफ़िक पर आधारित है.लाइव ट्रैफ़िक की स्थिति को ध्यान में रखने वाले
TRAFFIC_AWARE
औरTRAFFIC_AWARE_OPTIMAL
के लिए, लाइव ट्रैफ़िक अबdepartureTime
के जितना करीब हो गया है. आने वाले समय में, जाने का समय जितना तय होगा, ट्रैफ़िक की पुरानी स्थितियों पर उतना ही ज़्यादा ध्यान दिया जाएगा.
रूटिंग की प्राथमिकता सेटिंग का उदाहरण
नीचे दिया गया JSON कोड, अनुरोध वाले मैसेज की इकाई के मुख्य हिस्से में रूटिंग की प्राथमिकता सेट करने का तरीका बताता है.
{ "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 से, ट्रैफ़िक की जानकारी को मैनेज करने वाली पॉलीलाइन के साथ-साथ ट्रैफ़िक की स्थितियों के बारे में जानकारी मांगी जा सकती है. ज़्यादा जानकारी के लिए, पॉलीलाइन का अनुरोध करें देखें.