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 है, तो Distance Matrix सेवा को निर्देश देता है कि जहां तक हो सके, फ़ेरी से बचें. ज़रूरी नहीं.
avoidHighways optional
टाइप:  boolean optional
अगर true है, तो Distance Matrix सेवा को निर्देश देता है कि जहां तक हो सके, हाइवे से बचें. ज़रूरी नहीं.
avoidTolls optional
टाइप:  boolean optional
अगर true है, तो Distance Matrix सेवा को निर्देश देता है कि जहां हो सके वहां टोल वाली सड़कों से बचें. ज़रूरी नहीं.
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 का क्रम होता है. हर डेस्टिनेशन पते के लिए एक DistanceMatrixResponseElement होता है.
elements
लाइन में मौजूद एलिमेंट, जो डेस्टिनेशन पतों से जुड़े होते हैं.

DistanceMatrixResponseElement इंटरफ़ेस

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

यह DistanceMatrixService अनुरोध के जवाब का एक एलिमेंट है. इसमें एक जगह से दूसरी जगह तक जाने में लगने वाला समय और दूरी की जानकारी होती है.
distance
टाइप:  Distance
यात्रा शुरू करने की जगह और मंज़िल के इस कॉम्बिनेशन के बीच की दूरी. इस प्रॉपर्टी को तय नहीं किया जा सकता, क्योंकि दूरी के बारे में जानकारी नहीं हो सकती.
duration
टाइप:  Duration
इस जगह से इस जगह तक की यात्रा की अवधि. इस प्रॉपर्टी की वैल्यू तय नहीं की जा सकती, क्योंकि हो सकता है कि अवधि के बारे में जानकारी न हो.
duration_in_traffic
टाइप:  Duration
trafficModel प्रॉपर्टी में बताई गई ट्रैफ़िक की स्थितियों को ध्यान में रखते हुए, इस मूल जगह से मंज़िल तक की यात्रा में लगने वाला समय. इस प्रॉपर्टी को undefined किया जा सकता है, क्योंकि हो सकता है कि अवधि की जानकारी न हो. यह सुविधा सिर्फ़ Premium Plan के ग्राहकों के लिए उपलब्ध है. इसके लिए, अनुरोध करते समय 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 इस सेवा ने आपके वेब पेज को Distance Matrix सेवा का इस्तेमाल करने की अनुमति नहीं दी.
UNKNOWN_ERROR सर्वर की गड़बड़ी की वजह से, दूरी की जानकारी देने वाले मैट्रिक्स के अनुरोध को प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है.

DistanceMatrixElementStatus कॉन्स्टेंट

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

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

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
NOT_FOUND इस पेयरिंग के ऑरिजिन और/या डेस्टिनेशन को जियोकोड नहीं किया जा सका.
OK जवाब में मान्य नतीजा शामिल है.
ZERO_RESULTS यात्रा शुरू करने की जगह और मंज़िल के बीच कोई रास्ता नहीं मिला.