Distance Matrix API (लेगसी), एक वेब सेवा है. यह शुरुआती जगहों और मंज़िलों के मैट्रिक्स के लिए, यात्रा की दूरी और समय की जानकारी देती है. यह जानकारी, हर जोड़े के बीच के सुझाए गए रास्ते के आधार पर दी जाती है. यात्रा का मोड (ड्राइविंग, पैदल, साइकल से यात्रा, ट्रांज़िट), ट्रांज़िट मोड, इकाइयां, और ट्रैफ़िक के हिसाब से यात्रा में लगने वाले समय के लिए, जाने का समय सेट किया जा सकता है. यह JSON या एक्सएमएल दिखाता है.
Distance Matrix API: मुख्य बातें
- प्रॉडक्ट: Distance Matrix API
- इसे इस नाम से भी जाना जाता है: Distance Matrix API (लेगसी), Distance Matrix (लेगसी)
- कैटगरी: रास्ते
- प्लैटफ़ॉर्म: वेब सेवा (REST)
- इस पर चलता है: सर्वर (बैकएंड कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: लेगसी
- इसकी जगह इस्तेमाल किया जा रहा है: Routes API
- खास जानकारी: Distance Matrix API के बारे में खास जानकारी
Distance Matrix API: इसका इस्तेमाल कब करें
Distance Matrix API का इस्तेमाल तब करें, जब:
- आपके पास कोई ऐसा मौजूदा प्रोजेक्ट है जिसमें Distance Matrix API (लेगसी) पहले से चालू है और
/maps/api/distancematrixको कॉल करता है. - आपको किसी सर्वर से, शुरुआत की कई जगहों और कई मंज़िलों के बीच की दूरी और यात्रा में लगने वाले समय की जानकारी चाहिए.
- आपको ड्राइविंग के लिए, ट्रैफ़िक में लगने वाले समय की जानकारी चाहिए. इसके लिए,
departure_timeऔर वैकल्पिक तौर परtraffic_modelका इस्तेमाल करें.
Distance Matrix API का इस्तेमाल तब न करें, जब:
- आपने एक नया Google Cloud प्रोजेक्ट बनाने की प्रोसेस शुरू की है. अक्टूबर 2026 से, Distance Matrix API (लेगसी) को नए प्रोजेक्ट के लिए चालू नहीं किया जा सकेगा. इसके बजाय, Routes API का इस्तेमाल करें.
- आपको नई सुविधाएं चाहिए या स्ट्रीम किए गए रिस्पॉन्स (
computeRouteMatrix) के साथ 625 एलिमेंट तक का रूट मैट्रिक्स चाहिए. इसके बजाय, Routes API का इस्तेमाल करें. - आपको पॉइंट के बीच की दूरी और समय की वैल्यू के साथ-साथ, चरणों और पॉलीलाइन के साथ पूरा रास्ता चाहिए. इसके बजाय, Routes API का इस्तेमाल करें.
Distance Matrix API: सेटअप
- चालू की जाने वाली सेवा:
distance-matrix-backend.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- इस्तेमाल शुरू करें: Distance Matrix API सेट अप करें
- रेफ़रंस: Distance Matrix API का रेफ़रंस
- कीमत: Distance Matrix API का इस्तेमाल और बिलिंग
- नीतियां: Distance Matrix API की नीतियां
- रिलीज़ नोट: Distance Matrix API के रिलीज़ नोट
Distance Matrix API: आम तौर पर होने वाली गलतियां
- समस्या: सर्वर-साइड के हर अनुरोध में, ज़्यादा से ज़्यादा 100 एलिमेंट (शुरुआती जगह × मंज़िल) और 25 शुरुआती जगहें या 25 मंज़िलें शामिल की जा सकती हैं. इससे बड़े अनुरोधों के लिए,
MAX_ELEMENTS_EXCEEDEDयाMAX_DIMENSIONS_EXCEEDEDदिखता है. समाधान: मैट्रिक्स को ऐसे अनुरोधों में बांटें जिनमें 100 से ज़्यादा एलिमेंट और 25 से ज़्यादा ऑरिजिन या डेस्टिनेशन न हों. /maps/documentation/distance-matrix/usage-and-billing#usage-limits देखें. - समस्या: अगर
departure_timeकी वैल्यू नहीं दी जाती है, तो रूट और समय, ट्रैफ़िक के औसत समय के हिसाब से तय होता है. साथ ही, कोईduration_in_trafficनहीं दिखाया जाता. समय के साथ, नतीजों में बदलाव हो सकता है. ठीक करने का तरीका: ट्रैफ़िक के हिसाब से यात्रा में लगने वाले समय की जानकारी पाने के लिए,departure_timeकोnowयाmode=drivingके साथ आने वाले समय पर सेट करें. ध्यान दें कि ट्रैफ़िक के अनुरोधों के लिए, ज़्यादा शुल्क लिया जाता है. /maps/documentation/distance-matrix/distance-matrix देखें. - समस्या:
unitsपैरामीटर, सिर्फ़ दूरी वाले फ़ील्ड में मौजूद टेक्स्ट को बदलता है. दूरी की वैल्यू हमेशा मीटर में होती है. ठीक करने का तरीका:distance.valueको मीटर के तौर पर पढ़ें या डिसप्ले के लिएdistance.textका इस्तेमाल करें. /maps/documentation/distance-matrix/distance-matrix देखें. - समस्या: किसी ऐसे प्रोजेक्ट से Distance Matrix API (लेगसी) को कॉल करने पर जहां यह चालू नहीं है,
statusमेंREQUEST_DENIEDऔरLegacyApiNotActivatedMapErrorसे लिंक करने वालाerror_messageदिखता है. एआई असिस्टेंट अक्सर डिफ़ॉल्ट रूप से, लेगसी-एपीआई कोड जनरेट करते हैं. ठीक करने का तरीका: Routes APIcomputeRouteMatrixपर माइग्रेट करें (X-Goog-FieldMaskहेडर के साथ). फ़ॉर्म भरकर, लेगसी एपीआई को कुछ समय के लिए ही चालू किया जा सकता है. /maps/legacy#LegacyApiNotActivatedMapError देखें.