DistanceMatrixService class
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 कोड से मेल खाते हैं. हालांकि, कुछ कोड अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का सीसीटीएलडी "uk" ( .co.uk ) है, जबकि इसका आईएसओ 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" की इकाई के लिए है. |
transitOptions optional |
टाइप:
TransitOptions optional ऐसी सेटिंग जो सिर्फ़ उन अनुरोधों पर लागू होती हैं जिनमें travelMode का मतलब 'बस, मेट्रो वगैरह' है. यात्रा के अन्य तरीकों पर इस ऑब्जेक्ट का कोई असर नहीं पड़ेगा. |
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
का क्रम होता है. हर डेस्टिनेशन पते के लिए एक 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 |
यात्रा शुरू करने की जगह और मंज़िल के बीच कोई रास्ता नहीं मिला. |