Distance Matrix (deprecated)

DistanceMatrixService क्लास

क्लास google.maps.DistanceMatrixService
लाइब्रेरी "routes"

इस्तेमाल नहीं किया जा सकता: 25 फ़रवरी, 2026 से google.maps.DistanceMatrixService का इस्तेमाल नहीं किया जा सकता. फ़िलहाल, google.maps.DistanceMatrixService को बंद करने का कोई प्लान नहीं है. साथ ही, इसमें होने वाली किसी भी बड़ी गड़बड़ी को ठीक किया जाता रहेगा. सहायता बंद करने से कम से कम 12 महीने पहले आपको इसकी सूचना दी जाएगी. ज़्यादा जानकारी के लिए, कृपया https://developers.google.com/maps/legacy पर जाएं.

const {DistanceMatrixService} = await google.maps.importLibrary("routes");

निर्माता
DistanceMatrixService	DistanceMatrixService() पैरामीटर: कोई नहीं DistanceMatrixService का एक नया इंस्टेंस बनाता है, जो Google के सर्वर को दूरी के मैट्रिक्स की क्वेरी भेजता है.

तरीके
getDistanceMatrix	getDistanceMatrix(request[, callback]) पैरामीटर: request: DistanceMatrixRequest callback: function(DistanceMatrixResponse optional, DistanceMatrixStatus): void optional रिटर्न वैल्यू: Promise<DistanceMatrixResponse> दूरी के मैट्रिक्स का अनुरोध करता है.

DistanceMatrixRequest इंटरफ़ेस

इंटरफ़ेस google.maps.DistanceMatrixRequest

DistanceMatrixService से भेजी गई दूरी के मैट्रिक्स की क्वेरी. इसमें शुरुआत और मंज़िल की जगहों के कलेक्शन के साथ-साथ, मेट्रिक का हिसाब लगाने के लिए अलग-अलग विकल्प शामिल हैं.

प्रॉपर्टी
destinations	टाइप: Array<string|LatLng|LatLngLiteral|Place> एक कलेक्शन, जिसमें डेस्टिनेशन के पते की स्ट्रिंग या LatLng या Place ऑब्जेक्ट शामिल होते हैं. इनकी मदद से, दूरी और समय का हिसाब लगाया जाता है. ज़रूरी है.
origins	टाइप: Array<string|LatLng|LatLngLiteral|Place> एक कलेक्शन, जिसमें शुरुआत की जगह के पते की स्ट्रिंग, LatLng या Place ऑब्जेक्ट शामिल होते हैं. इनकी मदद से, दूरी और समय का हिसाब लगाया जाता है. ज़रूरी है.
travelMode	टाइप: TravelMode अनुरोध किए गए रूटिंग का टाइप. ज़रूरी है.
avoidFerries ज़रूरी नहीं	टाइप: boolean optional अगर true है, तो दूरी का मैट्रिक्स सेवा को निर्देश दिया जाता है कि जहां तक हो सके, फ़ेरी से बचें. ज़रूरी नहीं.
avoidHighways ज़रूरी नहीं	टाइप: boolean optional अगर true है, तो Distance Matrix सेवा को निर्देश देता है कि जहां तक हो सके हाइवे से बचें. ज़रूरी नहीं.
avoidTolls ज़रूरी नहीं	टाइप: boolean optional अगर true है, तो Distance Matrix सेवा को निर्देश मिलता है कि जहां तक हो सके टोल रोड से बचें. ज़रूरी नहीं.
drivingOptions ज़रूरी नहीं	टाइप: DrivingOptions optional ये सेटिंग सिर्फ़ उन अनुरोधों पर लागू होती हैं जिनमें travelMode की वैल्यू DRIVING होती है. इस ऑब्जेक्ट का असर, यात्रा के अन्य तरीकों पर नहीं पड़ेगा.
language ज़रूरी नहीं	टाइप: string optional भाषा का आइडेंटिफ़ायर, जिससे यह तय होता है कि नतीजे किस भाषा में दिखाए जाएं. हालांकि, ऐसा तब ही होता है, जब उस भाषा में नतीजे दिखाना मुमकिन हो. उपलब्ध भाषाओं की सूची देखें.
region ज़रूरी नहीं	टाइप: string optional जियोकोडिंग के अनुरोधों के लिए, बायस के तौर पर इस्तेमाल किया जाने वाला देश/इलाके का कोड. क्षेत्र कोड, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू स्वीकार करता है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ अपवाद भी होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" के लिए है.
transitOptions ज़रूरी नहीं	टाइप: TransitOptions optional ये सेटिंग सिर्फ़ उन अनुरोधों पर लागू होती हैं जिनमें travelMode की वैल्यू TRANSIT होती है. इस ऑब्जेक्ट का असर, यात्रा के अन्य तरीकों पर नहीं पड़ेगा.
unitSystem ज़रूरी नहीं	टाइप: UnitSystem optional दूरी दिखाने के लिए, पसंदीदा यूनिट सिस्टम. ज़रूरी नहीं; डिफ़ॉल्ट रूप से, मेट्रिक पर सेट होता है.

DistanceMatrixResponse इंटरफ़ेस

इंटरफ़ेस google.maps.DistanceMatrixResponse

DistanceMatrixService अनुरोध का जवाब, जिसमें फ़ॉर्मैट किए गए ऑरिजिन और डेस्टिनेशन पते शामिल होते हैं. साथ ही, DistanceMatrixResponseRows का क्रम होता है, जो हर संबंधित ऑरिजिन पते के लिए एक होता है.

प्रॉपर्टी
destinationAddresses	टाइप: Array<string> फ़ॉर्मैट किए गए डेस्टिनेशन पते.
originAddresses	टाइप: Array<string> फ़ॉर्मैट किए गए मूल पते.
rows	टाइप: Array<DistanceMatrixResponseRow> मैट्रिक्स की लाइनें, जो ऑरिजिन के पतों से जुड़ी होती हैं.

DistanceMatrixResponseRow इंटरफ़ेस

इंटरफ़ेस google.maps.DistanceMatrixResponseRow

DistanceMatrixService अनुरोध के जवाब की एक लाइन, जिसमें DistanceMatrixResponseElement का क्रम होता है. हर डेस्टिनेशन पते के लिए एक लाइन होती है.

प्रॉपर्टी
elements	टाइप: Array<DistanceMatrixResponseElement> डेस्टिनेशन के पतों से जुड़े पंक्ति के एलिमेंट.

DistanceMatrixResponseElement इंटरफ़ेस

इंटरफ़ेस google.maps.DistanceMatrixResponseElement

DistanceMatrixService अनुरोध के जवाब का एक एलिमेंट, जिसमें एक ऑरिजिन से एक डेस्टिनेशन तक की अवधि और दूरी शामिल होती है.

प्रॉपर्टी
distance	टाइप: Distance यात्रा शुरू करने की जगह और मंज़िल के बीच की दूरी. ऐसा हो सकता है कि इस प्रॉपर्टी की वैल्यू तय न हो, क्योंकि दूरी की जानकारी नहीं है.
duration	टाइप: Duration शुरुआत की जगह और मंज़िल के इस जोड़े के लिए तय की गई अवधि. ऐसा हो सकता है कि इस प्रॉपर्टी के बारे में जानकारी न दी गई हो, क्योंकि अवधि के बारे में जानकारी नहीं है.
duration_in_traffic	टाइप: Duration इस ऑरिजिन-डेस्टिनेशन पेयरिंग के लिए लगने वाला समय. इसमें trafficModel प्रॉपर्टी से मिलने वाले ट्रैफ़िक का हाल को ध्यान में रखा जाता है. यह प्रॉपर्टी undefined हो सकती है, क्योंकि हो सकता है कि अवधि की जानकारी न हो. यह सुविधा, प्रीमियम प्लान के ग्राहकों के लिए सिर्फ़ तब उपलब्ध होती है, जब अनुरोध करते समय drivingOptions तय किया गया हो.
fare	टाइप: TransitFare इस ओरिजिन-डेस्टिनेशन पेयरिंग का कुल किराया. यह सिर्फ़ बस, मेट्रो वगैरह के लिए किए गए अनुरोधों पर लागू होता है.
status	टाइप: DistanceMatrixElementStatus इस खास ऑरिजिन-डेस्टिनेशन पेयरिंग का स्टेटस.

DistanceMatrixStatus कॉन्स्टेंट

कॉन्सटैंट google.maps.DistanceMatrixStatus
लाइब्रेरी "routes"

दूरी के मैट्रिक्स का अनुरोध पूरा होने पर, DistanceMatrixService से मिले अनुरोध की सामान्य स्थिति. इन्हें वैल्यू या कॉन्सटेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'OK' या google.maps.DistanceMatrixStatus.OK.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को DistanceMatrixStatusString टाइप से तय किया जाता है.

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");

कॉन्स्टेंट
INVALID_REQUEST	अनुरोध अमान्य था.
MAX_DIMENSIONS_EXCEEDED	अनुरोध में 25 से ज़्यादा ऑरिजिन या 25 से ज़्यादा डेस्टिनेशन शामिल हैं.
MAX_ELEMENTS_EXCEEDED	शुरुआत की जगहों और मंज़िलों की संख्या, हर क्वेरी के लिए तय की गई सीमा से ज़्यादा है.
OK	जवाब में सही नतीजा शामिल हो.
OVER_QUERY_LIMIT	तय समयावधि में बहुत ज़्यादा एलिमेंट का अनुरोध किया गया है. कुछ समय बाद फिर से कोशिश करने पर, अनुरोध पूरा हो जाना चाहिए.
REQUEST_DENIED	सेवा ने आपके वेब पेज को Distance Matrix सेवा का इस्तेमाल करने की अनुमति नहीं दी.
UNKNOWN_ERROR	सर्वर की गड़बड़ी की वजह से, दूरी के मैट्रिक्स का अनुरोध प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है.

DistanceMatrixElementStatus कॉन्स्टेंट

कॉन्सटैंट google.maps.DistanceMatrixElementStatus
लाइब्रेरी "routes"

दूरी के मैट्रिक्स का अनुरोध पूरा होने पर, DistanceMatrixService से मिलने वाले एलिमेंट-लेवल स्टेटस की जानकारी. यह स्टेटस, शुरुआत और मंज़िल की जगह के किसी खास जोड़े के बारे में होता है. इन वैल्यू को स्ट्रिंग के तौर पर तय किया जाता है. उदाहरण के लिए, 'OK'.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को DistanceMatrixElementStatusString टाइप से तय किया जाता है.

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");

कॉन्स्टेंट
NOT_FOUND	इस पेयरिंग के ऑरिजिन और/या डेस्टिनेशन को जियोकोड नहीं किया जा सका.
OK	जवाब में सही नतीजा शामिल हो.
ZERO_RESULTS	यात्रा शुरू करने की जगह और मंज़िल के बीच कोई रास्ता नहीं मिला.