DistanceMatrixService क्लास
google.maps.DistanceMatrixService
क्लास
लाइब्रेरी "routes"
const {DistanceMatrixService} = await google.maps.importLibrary("routes");
निर्माता | |
|---|---|
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
ज़रूरी नहीं |
टाइप:
boolean optionalअगर true है, तो दूरी का मैट्रिक्स सेवा को निर्देश दिया जाता है कि जहां तक हो सके, फ़ेरी से बचें. ज़रूरी नहीं. |
avoidHighways
ज़रूरी नहीं |
टाइप:
boolean optionalअगर true है, तो Distance Matrix सेवा को निर्देश देता है कि जहां तक हो सके हाइवे से बचें. ज़रूरी नहीं. |
avoidTolls
ज़रूरी नहीं |
टाइप:
boolean optionalअगर true है, तो Distance Matrix सेवा को निर्देश मिलता है कि जहां तक हो सके टोल रोड से बचें. ज़रूरी नहीं. |
drivingOptions
ज़रूरी नहीं |
टाइप:
DrivingOptions optionalये सेटिंग सिर्फ़ उन अनुरोधों पर लागू होती हैं जिनमें travelMode की वैल्यू DRIVING होती है. इस ऑब्जेक्ट का असर, यात्रा के अन्य तरीकों पर नहीं पड़ेगा. |
language
ज़रूरी नहीं |
टाइप:
string optionalभाषा का आइडेंटिफ़ायर, जिससे यह तय होता है कि नतीजे किस भाषा में दिखाए जाएं. हालांकि, ऐसा तब ही होता है, जब उस भाषा में नतीजे दिखाना मुमकिन हो. उपलब्ध भाषाओं की सूची देखें. |
region
ज़रूरी नहीं |
टाइप:
string optionalजियोकोडिंग के अनुरोधों के लिए, बायस के तौर पर इस्तेमाल किया जाने वाला देश/इलाके का कोड. क्षेत्र कोड, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू स्वीकार करता है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ अपवाद भी होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" ( .co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" के लिए है. |
transitOptions
ज़रूरी नहीं |
टाइप:
TransitOptions optionalये सेटिंग सिर्फ़ उन अनुरोधों पर लागू होती हैं जिनमें travelMode की वैल्यू TRANSIT होती है. इस ऑब्जेक्ट का असर, यात्रा के अन्य तरीकों पर नहीं पड़ेगा. |
unitSystem
ज़रूरी नहीं |
टाइप:
UnitSystem optionalदूरी दिखाने के लिए, पसंदीदा यूनिट सिस्टम. ज़रूरी नहीं; डिफ़ॉल्ट रूप से, मेट्रिक पर सेट होता है. |
DistanceMatrixResponse इंटरफ़ेस
google.maps.DistanceMatrixResponse
इंटरफ़ेस
DistanceMatrixService अनुरोध का जवाब, जिसमें फ़ॉर्मैट किए गए ऑरिजिन और डेस्टिनेशन पते शामिल होते हैं. साथ ही, DistanceMatrixResponseRows का क्रम होता है, जो हर संबंधित ऑरिजिन पते के लिए एक होता है.
प्रॉपर्टी | |
|---|---|
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 हो सकती है, क्योंकि हो सकता है कि अवधि की जानकारी न हो. यह सुविधा, प्रीमियम प्लान के ग्राहकों के लिए सिर्फ़ तब उपलब्ध होती है, जब अनुरोध करते समय drivingOptions तय किया गया हो. |
fare |
टाइप:
TransitFareइस ओरिजिन-डेस्टिनेशन पेयरिंग का कुल किराया. यह सिर्फ़ बस, मेट्रो वगैरह के लिए किए गए अनुरोधों पर लागू होता है. |
status |
इस खास ऑरिजिन-डेस्टिनेशन पेयरिंग का स्टेटस. |
DistanceMatrixStatus कॉन्स्टेंट
google.maps.DistanceMatrixStatus
कॉन्सटेंट
लाइब्रेरी "routes"
दूरी के मैट्रिक्स का अनुरोध पूरा होने पर, DistanceMatrixService से मिले अनुरोध की सामान्य स्थिति. इन्हें वैल्यू या कॉन्सटेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'OK' या google.maps.DistanceMatrixStatus.OK.
इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को DistanceMatrixStatusString टाइप से तय किया जाता है.
const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");
कॉन्स्टेंट | |
|---|---|
INVALID_REQUEST |
अनुरोध अमान्य था. |
MAX_DIMENSIONS_EXCEEDED |
अनुरोध में 25 से ज़्यादा ऑरिजिन या 25 से ज़्यादा डेस्टिनेशन शामिल हैं. |
MAX_ELEMENTS_EXCEEDED |
शुरुआत की जगहों और मंज़िलों की संख्या, हर क्वेरी के लिए तय की गई सीमा से ज़्यादा है. |
OK |
जवाब में सही नतीजा शामिल हो. |
OVER_QUERY_LIMIT |
तय समयावधि में बहुत ज़्यादा एलिमेंट का अनुरोध किया गया है. कुछ समय बाद फिर से कोशिश करने पर, अनुरोध पूरा हो जाना चाहिए. |
REQUEST_DENIED |
सेवा ने आपके वेब पेज को Distance Matrix सेवा का इस्तेमाल करने की अनुमति नहीं दी. |
UNKNOWN_ERROR |
सर्वर की गड़बड़ी की वजह से, दूरी के मैट्रिक्स का अनुरोध प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है. |
DistanceMatrixElementStatus कॉन्स्टेंट
google.maps.DistanceMatrixElementStatus
कॉन्सटेंट
लाइब्रेरी "routes"
दूरी के मैट्रिक्स का अनुरोध पूरा होने पर, DistanceMatrixService से मिलने वाले एलिमेंट-लेवल स्टेटस की जानकारी. यह स्टेटस, शुरुआत और मंज़िल की जगह के किसी खास जोड़े के बारे में होता है. इन वैल्यू को स्ट्रिंग के तौर पर तय किया जाता है. उदाहरण के लिए, 'OK'.
इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को DistanceMatrixElementStatusString टाइप से तय किया जाता है.
const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");
कॉन्स्टेंट | |
|---|---|
NOT_FOUND |
इस पेयरिंग के ऑरिजिन और/या डेस्टिनेशन को जियोकोड नहीं किया जा सका. |
OK |
जवाब में सही नतीजा शामिल हो. |
ZERO_RESULTS |
यात्रा शुरू करने की जगह और मंज़िल के बीच कोई रास्ता नहीं मिला. |