दूरीमैट्रिक्स सर्विस क्लास
google.maps.DistanceMatrixService
कक्षा
यह सेवा कई ऑरिजिन और डेस्टिनेशन के बीच की दूरी का पता लगाने के लिए इस्तेमाल की जाती है.
const {DistanceMatrixService} = await google.maps.importLibrary("routes")
पर कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
निर्माता | |
---|---|
DistanceMatrixService |
DistanceMatrixService() पैरामीटर: कोई नहीं
DistanceMatrixService का एक नया इंस्टेंस बनाता है, जो Google सर्वर को दूरी की मैट्रिक्स क्वेरी भेजता है. |
तरीके | |
---|---|
getDistanceMatrix |
getDistanceMatrix(request[, callback]) पैरामीटर:
सामान लौटाने की वैल्यू:
Promise<DistanceMatrixResponse> दूरी के मैट्रिक्स का अनुरोध जारी करता है. |
दूरी मैट्रिक्स का अनुरोध इंटरफ़ेस
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 के ट्रांज़िट के अनुरोधों पर लागू होने वाली सेटिंग. इस ऑब्जेक्ट से, यात्रा के दूसरे मोड पर कोई असर नहीं पड़ेगा. |
unitSystem optional |
टाइप:
UnitSystem optional दूरी दिखाते समय इस्तेमाल करने के लिए पसंदीदा यूनिट सिस्टम. ज़रूरी नहीं; डिफ़ॉल्ट रूप से मेट्रिक. |
दूरीमैट्रिक्स रिस्पॉन्स इंटरफ़ेस
google.maps.DistanceMatrixResponse
इंटरफ़ेस
DistanceMatrixService
के अनुरोध का जवाब, जिसमें फ़ॉर्मैट किए गए शुरुआत की जगह और डेस्टिनेशन के पते शामिल हैं. साथ ही, इसमें DistanceMatrixResponseRow
के क्रम की जानकारी होती है जिसमें हर यूआरएल के लिए एक ही पता होता है.
प्रॉपर्टी | |
---|---|
destinationAddresses |
टाइप:
Array<string> फ़ॉर्मैट किए गए डेस्टिनेशन के पते. |
originAddresses |
टाइप:
Array<string> फ़ॉर्मैट किए गए मूल पते. |
rows |
टाइप:
Array<DistanceMatrixResponseRow> ऑरिजिन के पते से जुड़ी मैट्रिक्स की पंक्तियां. |
दूरीमैट्रिक्स रिस्पॉन्स R इंटरफ़ेस
google.maps.DistanceMatrixResponseRow
इंटरफ़ेस
DistanceMatrixService
अनुरोध के जवाब की पंक्ति, जिसमें DistanceMatrixResponseElement
s का क्रम होता है, जिसमें हर संबंधित गंतव्य पते के लिए एक होता है.
प्रॉपर्टी | |
---|---|
elements |
डेस्टिनेशन के पते के हिसाब से लाइन की जानकारी. |
दूरीमेट्रिक्स रिस्पॉन्स एलिमेंट इंटरफ़ेस
google.maps.DistanceMatrixResponseElement
इंटरफ़ेस
DistanceMatrixService
अनुरोध के जवाब का एक एलिमेंट, जिसमें एक शुरुआत से लेकर एक मंज़िल तक की अवधि और दूरी शामिल होती है.
प्रॉपर्टी | |
---|---|
distance |
टाइप:
Distance इस ऑरिजिन-डेस्टिनेशन पेयरिंग की दूरी. हो सकता है कि इस प्रॉपर्टी के बारे में कोई जानकारी न हो, क्योंकि दूरी की जानकारी न हो. |
duration |
टाइप:
Duration इस ऑरिजिन-डेस्टिनेशन पेयरिंग की अवधि. शायद इस प्रॉपर्टी के बारे में कोई जानकारी नहीं है, क्योंकि शायद पूरी अवधि की जानकारी नहीं है. |
duration_in_traffic |
टाइप:
Duration इस ऑरिजिन-डेस्टिनेशन पेयरिंग का कुल समय, trafficModel प्रॉपर्टी से मिली ट्रैफ़िक की स्थितियों को ध्यान में रखते हुए. यह प्रॉपर्टी undefined हो सकती है, क्योंकि शायद समय की जानकारी न हो. यह सुविधा सिर्फ़ Premium प्लान के ग्राहकों के लिए उपलब्ध है, बशर्ते drivingOptions की सदस्यता का अनुरोध किया जा रहा हो. |
fare |
टाइप:
TransitFare ऑरिजिन-डेस्टिनेशन की इस जोड़ी के लिए कुल किराया. सिर्फ़ सार्वजनिक परिवहन के अनुरोधों पर लागू होता है. |
status |
खास तौर पर, डेस्टिनेशन डेस्टिनेशन के पेयर की स्थिति. |
दूरी मैट्रिक्स की स्थिति कॉन्सटेंट
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 |
सर्वर में गड़बड़ी की वजह से, दूरी के मैट्रिक्स का अनुरोध प्रोसेस नहीं किया जा सका. आपके दोबारा कोशिश करने पर, अनुरोध पूरा हो सकता है. |
दूरीमैट्रिक्सएलिमेंट स्थिति कॉन्सटेंट
google.maps.DistanceMatrixElementStatus
कॉन्सटेंट
दूरी के मैट्रिक्स का अनुरोध पूरा होने पर, DistanceMatrixService
से जनरेट हुए खास ऑरिजिन के डेस्टिनेशन के बारे में एलिमेंट लेवल की स्थिति. ये वैल्यू स्ट्रिंग के तौर पर तय की जाती हैं, जैसे कि 'OK'
.
const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes")
पर कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
स्थिरांक | |
---|---|
NOT_FOUND |
इस जोड़े के ऑरिजिन और/या डेस्टिनेशन को वेब पेज से कनेक्ट नहीं किया जा सका. |
OK |
जवाब में एक मान्य नतीजा शामिल है. |
ZERO_RESULTS |
शुरुआत की जगह और मंज़िल के बीच का कोई रास्ता नहीं मिला. |