रूट मैट्रिक्स की गणना करें

एक से ज़्यादा बार के लिए, किसी रास्ते की दूरी और अवधि की गणना की जा सकती है ऑरिजिन और डेस्टिनेशन के लिए, ComputeRouteMatrix तरीके का इस्तेमाल किया गया है रूट Preferred API की ज़रूरी शर्तें पूरी करता है. ComputeRouteMatrix समर्थन करता है gRPC कॉल और REST एचटीटीपी कॉल, दोनों स्ट्रीमिंग की जा सकती हैं.

ऑरिजिन और डेस्टिनेशन पेयर की सूची दी गई है, ComputeRouteMatrix हर शुरुआत की जगह से शुरू होने वाले रास्ते की दूरी और अवधि की गणना करता है और हर डेस्टिनेशन पर खत्म होते हैं. स्ट्रीम का हर एलिमेंट एक-दूसरे से जुड़ा होता है में बदल जाता है.

ComputeRouteMatrix तरीके के कई फ़ायदे हैं. दूरी मैट्रिक्स सेवा:

• स्ट्रीमिंग की मदद से एलिमेंट को पूरे मैट्रिक्स से पहले दिखाया जा सकता है की गणना की गई है, जिससे प्रतीक्षा अवधि कम हो रही है.
• ComputeRouteMatrix में ट्रैफ़िक का हिसाब लगाने के लिए, बेहतर विकल्प उपलब्ध हैं, इससे आपको क्वालिटी के इंतज़ार का समय खत्म हो जाने के बारे में फ़ैसले लेने में मदद मिलेगी.
• Google के इन्फ़्रास्ट्रक्चर में अनुरोधों को प्राथमिकता दी जाती है, इसका नतीजा यह होता है कि प्रॉडक्ट की उपलब्धता ज़्यादा होती है.
• आप शीर्षक (यात्रा की दिशा) और सड़क के किनारे की जानकारी दे सकते हैं वेपॉइंट के लिए जानकारी.
• टोल की जानकारी के साथ-साथ उसे वापस करने का अनुरोध भी किया जा सकता है रास्ते की दूरी और ETA.

ComputeRouteMatrix का तरीका चालू करना

अपने कोड में ComputeRouteMatrix तरीके का इस्तेमाल करने से पहले, आपको ये काम करने होंगे इसे चालू करें. रूट को प्राथमिकता देने वाले एपीआई को चालू करने के बारे में ज़्यादा जानकारी पाने के लिए तरीकों के बारे में, शुरू करना देखें.

ComputeRouteMatrix तरीके का इस्तेमाल करना

ComputeRouteMatrix तरीका, पसंदीदा रूट के ज़रिए उपलब्ध है v1 एंडपॉइंट.

ज़्यादा जानकारी के लिए, यह दस्तावेज़ देखें:

जीआरपीसी: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

आराम: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

नीचे दिए गए सामान्य चरणों में, कॉल करने के लिए gRPC इस्तेमाल करने का तरीका बताया गया है ComputeRouteMatrix तरीका:

1. googleapis रिपॉज़िटरी से ज़रूरी प्रोटोबफ़र देखें:

   https://github.com/googleapis/googleapis/tree/master/google/maps/routes

   ध्यान रखें कि कुछ बिल्ड सिस्टम, जैसे कि Go जैसे बिल्ड सिस्टम आपके लिए अपने-आप यह काम कर सकते हैं.

2. अपनी पसंदीदा भाषा और बिल्ड टूल के सेट का इस्तेमाल करके, अपने काम के हिसाब से प्रोटोबफ़र कोड.

3. अपना अनुरोध जनरेट करें. मेटाडेटा के दो ज़रूरी हिस्से भेजने होंगे इस अनुरोध के साथ:

   • X-Goog-Api-Key को आपके एपीआई पासकोड पर सेट करना ज़रूरी है.

   • X-Goog-Fieldmask को फ़ील्ड की कॉमा से अलग की गई सूची पर सेट किया जाना चाहिए की ज़रूरत होती है. उदाहरण के लिए, X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status. सभी फ़ील्ड को दिखाने के लिए, वाइल्डकार्ड वर्ण (*) का इस्तेमाल किया जा सकता है, लेकिन यह निराश होकर वाइल्डकार्ड कैरेक्टर का इस्तेमाल करके, एपीआई रिस्पॉन्स, लेकिन उन फ़ील्ड को साफ़ तौर पर सूची में शामिल करना जिन्हें फ़ील्ड मास्क में शामिल करना है डाला गया है.

     फ़ील्ड मास्क स्ट्रिंग बनाने के बारे में ज़्यादा जानकारी के लिए, यहां देखें https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto. ध्यान दें कि आपको जिन फ़ील्ड की ज़रूरत नहीं है उन्हें बंद करने से इंतज़ार का समय कम हो सकता है इन फ़ील्ड के लिए और ज़्यादा कंप्यूटेशन की ज़रूरत हो सकती है. इंतज़ार का समय वैसे ही रहेगा स्थिर स्थिति, जब आप अपनी ज़रूरत के मुताबिक फ़ील्ड और नए फ़ील्ड बनाते हैं बाद में और गणना जोड़ी जाती है.

4. routespreferred.googleapis.com:443 को अपना अनुरोध भेजें.आपको इनका इस्तेमाल करना होगा TLS प्रोटोकॉल का इस्तेमाल करना चाहिए.

ComputeRouteMatrix तरीके को इस्तेमाल करने के उदाहरणों के लिए, देखें रूट मैट्रिक्स (बीटा) के उदाहरण.

ComputeRouteMatrix तरीके की एक खास सुविधा यह है कि गड़बड़ी के कोड पूरी स्ट्रीम के लिए या फिर किसी एक उपयोगकर्ता के लिए दिखाए जा सकते हैं एलिमेंट. उदाहरण के लिए, अगर स्ट्रीम कनेक्शन को ट्रिगर करने का अनुरोध किया जाता है, तो गलत है (उदाहरण के लिए, इसका ऑरिजिन शून्य है). हालांकि, अगर कोई गड़बड़ी होती है स्ट्रीम के कुछ एलिमेंट में (उदाहरण के लिए, जगह का अमान्य आईडी सेट करना) ) का इस्तेमाल किया जाता है, तो सिर्फ़ उन एलिमेंट में गड़बड़ी के कोड शामिल होते हैं जिन पर गड़बड़ी का असर हुआ है.

इस बात की कोई गारंटी नहीं है कि लाइव स्ट्रीम से वापस आने वाले एलिमेंट के लिए, सेल वाली वैल्यू वापस भेज दी जाएगी किसी भी क्रम में. इस वजह से, हर एलिमेंट में एक origin_index होता है और एक destination_index. बताए गए ऑरिजिन और डेस्टिनेशन के लिए अनुरोध करने से, रास्ते का मूल स्रोत origins[origin_index] के बराबर है और दिए गए एलीमेंट के लिए मार्ग गंतव्य समान है destinations[destination_index] तक. इन सरणियों को इंडेक्स नहीं किया जाता. यह ऑरिजिन और डेस्टिनेशन सूची के ऑर्डर को स्टोर करना ज़रूरी है.

टोल शुल्क का हिसाब लगाया जा रहा है

टोल शुल्क का हिसाब लगाने के बारे में जानकारी के लिए, देखें टोल शुल्क का हिसाब लगाना.

टोल शुल्क का हिसाब लगाने के उदाहरण देखने के लिए, यहां देखें रूट मैट्रिक्स का पता लगाना.