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