Distance Matrix API के बारे में खास जानकारी

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 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 API computeRouteMatrix पर माइग्रेट करें (X-Goog-FieldMask हेडर के साथ). फ़ॉर्म भरकर, लेगसी एपीआई को कुछ समय के लिए ही चालू किया जा सकता है. /maps/legacy#LegacyApiNotActivatedMapError देखें.