Distance Matrix

DistanceMatrixService क्लास

google.maps.DistanceMatrixService क्लास

एक से ज़्यादा ऑरिजिन और डेस्टिनेशन के बीच की दूरी की गणना करने की सेवा.

const {DistanceMatrixService} = await google.maps.importLibrary("routes") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.

DistanceMatrixService
DistanceMatrixService()
पैरामीटर: कोई नहीं
DistanceMatrixService का एक नया इंस्टेंस बनाता है, जो Google के सर्वर को दूरी के मैट्रिक्स से जुड़ी क्वेरी भेजता है.
getDistanceMatrix
getDistanceMatrix(request[, callback])
पैरामीटर: 
रिटर्न वैल्यू:  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 optional
टाइप:  boolean optional
अगर true है, तो जहां तक हो सके फ़ेरी से बचने के लिए, डिस्टेंस मैट्रिक्स सेवा को निर्देश देता है. ज़रूरी नहीं.
avoidHighways optional
टाइप:  boolean optional
अगर true, तो डिस्टेंस मैट्रिक्स सेवा को निर्देश देता है कि जहां भी मुमकिन हो वहां हाइवे से बचें. ज़रूरी नहीं.
avoidTolls optional
टाइप:  boolean optional
अगर true, तो जहां भी संभव हो टोल सड़कों से बचने के लिए, डिस्टेंस मैट्रिक्स सेवा को निर्देश देता है. ज़रूरी नहीं.
drivingOptions optional
टाइप:  DrivingOptions optional
सिर्फ़ उन अनुरोधों पर लागू होने वाली सेटिंग जहां travelMode, DRIVING है. इस ऑब्जेक्ट पर, यात्रा के दूसरे मोड पर कोई असर नहीं पड़ेगा.
language optional
टाइप:  string optional
जब संभव होने पर, उस भाषा के लिए भाषा का आइडेंटिफ़ायर जिसमें नतीजे दिखाए जाने चाहिए. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
region optional
टाइप:  string optional
जियोकोडिंग अनुरोधों के लिए पक्षपात के रूप में इस्तेमाल किया गया क्षेत्र कोड. क्षेत्रीय कोड में ccTLD ("टॉप-लेवल डोमेन") की दो वर्ण वाली वैल्यू इस्तेमाल की जा सकती है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड से मेल खाते हैं. हालांकि, इसमें कुछ खास अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि उसका ISO 3166-1 कोड "gb" है (तकनीकी रूप से "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन और नॉदर्न आयरलैंड" की इकाई के लिए).
transitOptions optional
टाइप:  TransitOptions optional
ऐसी सेटिंग जो सिर्फ़ उन अनुरोधों पर लागू होती हैं जिनमें travelMode, Transit है. इस ऑब्जेक्ट पर, यात्रा के दूसरे मोड पर कोई असर नहीं पड़ेगा.
unitSystem optional
टाइप:  UnitSystem optional
दूरी दिखाते समय इस्तेमाल करने के लिए पसंदीदा यूनिट सिस्टम. ज़रूरी नहीं; मेट्रिक को डिफ़ॉल्ट रूप से चुना जाता है.

DistanceMatrixResponse इंटरफ़ेस

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

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

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

DistanceMatrixResponseRow इंटरफ़ेस

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

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

elements
लाइन के एलिमेंट, जो डेस्टिनेशन पतों से जुड़े होते हैं.

DistanceMatrixResponseElement इंटरफ़ेस

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

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

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

DistanceMatrixStatus कॉन्सटेंट

google.maps.DistanceMatrixStatus कॉन्सटेंट

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

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.

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

DistanceMatrixElementStatus कॉन्सटेंट

google.maps.DistanceMatrixElementStatus कॉन्सटेंट

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

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.

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