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 |
टाइप:
Array<DistanceMatrixResponseRow> मैट्रिक्स की पंक्तियां, जिनमें ऑरिजिन के पतों से जुड़ी जानकारी होती है. |
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 |
शुरुआत की जगह और मंज़िल के बीच कोई रास्ता नहीं मिला. |