Route Matrix

RouteMatrix क्लास

google.maps.routes.RouteMatrix क्लास

RouteMatrix.computeRouteMatrix ने शुरुआत की जगह/मंज़िल के जोड़ों के सेट के लिए, रूट का मैट्रिक्स कैलकुलेट किया है

const {RouteMatrix} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

स्टैटिक मेथड

computeRouteMatrix

computeRouteMatrix(request) पैरामीटर:  request:  ComputeRouteMatrixRequest रिटर्न वैल्यू:  Promise<{matrix:RouteMatrix}> यह फ़ंक्शन, सफ़र शुरू करने की जगहों और मंज़िलों की सूची लेता है. इसके बाद, सफ़र शुरू करने की जगह और मंज़िल के हर कॉम्बिनेशन के लिए, रास्ते की जानकारी वाला मैट्रिक्स दिखाता है. ध्यान दें: इस तरीके के लिए, आपको अनुरोध में रिस्पॉन्स फ़ील्ड मास्क की जानकारी देनी होगी. इसके लिए, ComputeRouteMatrixRequest.fields प्रॉपर्टी सेट करें. यह वैल्यू, फ़ील्ड पाथ की सूची होती है. उदाहरण के लिए: सभी उपलब्ध फ़ील्ड का फ़ील्ड मास्क: fields: ['*'] रूट-लेवल की अवधि और दूरी का फ़ील्ड मास्क: fields: ['durationMillis', 'distanceMeters'] वाइल्डकार्ड रिस्पॉन्स फ़ील्ड मास्क fields: ['*'] का इस्तेमाल करने से बचें, क्योंकि: सिर्फ़ ज़रूरी फ़ील्ड चुनने से, हमारे सर्वर को कंप्यूटेशन साइकल सेव करने में मदद मिलती है. इससे हम आपको कम इंतज़ार के समय में नतीजा दिखा पाते हैं. प्रोडक्शन जॉब में सिर्फ़ ज़रूरी फ़ील्ड चुनने से, इंतज़ार का समय कम रहता है. हम आने वाले समय में, जवाब के लिए ज़्यादा फ़ील्ड जोड़ सकते हैं. इन नए फ़ील्ड के लिए, कंप्यूटेशन में ज़्यादा समय लग सकता है. अगर आपने सभी फ़ील्ड या टॉप लेवल पर सभी फ़ील्ड चुने हैं, तो हो सकता है कि आपको परफ़ॉर्मेंस में गिरावट देखने को मिले. ऐसा इसलिए, क्योंकि हम जो भी नया फ़ील्ड जोड़ेंगे वह जवाब में अपने-आप शामिल हो जाएगा. सिर्फ़ ज़रूरी फ़ील्ड चुनने से, रिस्पॉन्स का साइज़ छोटा हो जाता है. इससे नेटवर्क पर लोड होने में कम समय लगता है.

प्रॉपर्टी
rows	टाइप:  Array<RouteMatrixRow> मैट्रिक्स की पंक्तियां. हर लाइन, किसी ऑरिजिन से जुड़ी होती है. इसमें RouteMatrixItem की एक कैटगरी होती है. हर कैटगरी, किसी डेस्टिनेशन के रास्ते को दिखाती है.

तरीके
toJSON	toJSON() पैरामीटर:  कोई नहीं रिटर्न वैल्यू:  Object ऑब्जेक्ट में बदलता है.

RouteMatrixRow क्लास

google.maps.routes.RouteMatrixRow क्लास

यह RouteMatrix.computeRouteMatrix को पास किए गए ऑरिजिन से मेल खाता है. इसमें RouteMatrixItem की सूची होती है. हर आइटम, किसी डेस्टिनेशन के रास्ते को दिखाता है.

const {RouteMatrixRow} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

प्रॉपर्टी
items	टाइप:  Array<RouteMatrixItem> हर डेस्टिनेशन के लिए रास्ते की जानकारी.

तरीके
toJSON	toJSON() पैरामीटर:  कोई नहीं रिटर्न वैल्यू:  Object ऑब्जेक्ट में बदलता है.

RouteMatrixItem क्लास

google.maps.routes.RouteMatrixItem क्लास

इसमें RouteMatrix.computeRouteMatrix को पास किए गए ऑरिजिन/डेस्टिनेशन पेयर के लिए, कैलकुलेट किए गए रास्ते की जानकारी शामिल होती है.

const {RouteMatrixItem} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

प्रॉपर्टी
condition	टाइप:  RouteMatrixItemCondition optional इससे पता चलता है कि रास्ता मिला या नहीं.
distanceMeters	टाइप:  number optional मीटर में रास्ते की दूरी.
durationMillis	टाइप:  number optional रास्ते पर नेविगेट करने में लगने वाला समय, मिलीसेकंड में. अगर ComputeRouteMatrixRequest.routingPreference को TRAFFIC_UNAWARE पर सेट किया जाता है, तो यह वैल्यू RouteMatrixItem.staticDurationMillis के बराबर होगी. अगर ComputeRouteMatrixRequest.routingPreference को TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट किया जाता है, तो इस वैल्यू का हिसाब ट्रैफ़िक की स्थिति को ध्यान में रखकर लगाया जाता है. ध्यान दें: अगर अवधि 2^53 मिलीसेकंड से ज़्यादा है, तो यह वैल्यू Number.POSITIVE_INFINITY होगी.
error	टाइप:  RouteMatrixItemError optional रास्ते का हिसाब लगाने के दौरान हुई गड़बड़ी.
fallbackInfo	टाइप:  FallbackInfo optional कुछ मामलों में, जब सर्वर इस ऑरिजिन/डेस्टिनेशन पेयर के लिए दी गई प्राथमिकताओं के हिसाब से रास्ते का हिसाब नहीं लगा पाता है, तो वह हिसाब लगाने के लिए किसी दूसरे मोड का इस्तेमाल कर सकता है. फ़ॉलबैक का इस्तेमाल किए जाने पर, इस फ़ील्ड में फ़ॉलबैक रिस्पॉन्स के बारे में पूरी जानकारी होती है. अगर ऐसा नहीं है, तो यह फ़ील्ड सेट नहीं किया जाता.
localizedValues	टाइप:  RouteMatrixItemLocalizedValues optional RouteMatrixItem की प्रॉपर्टी को टेक्स्ट के तौर पर दिखाना.
staticDurationMillis	टाइप:  number optional ट्रैफ़िक का हाल ध्यान में रखे बिना, रास्ते से यात्रा करने में लगने वाला समय. ध्यान दें: अगर अवधि 2^53 मिलीसेकंड से ज़्यादा है, तो यह वैल्यू Number.POSITIVE_INFINITY होगी.
travelAdvisory	टाइप:  RouteTravelAdvisory optional रास्ते के बारे में ज़्यादा जानकारी.

तरीके
toJSON	toJSON() पैरामीटर:  कोई नहीं रिटर्न वैल्यू:  Object ऑब्जेक्ट में बदलता है.

ComputeRouteMatrixRequest इंटरफ़ेस

google.maps.routes.ComputeRouteMatrixRequest इंटरफ़ेस

रूट मैट्रिक्स का अनुरोध.

प्रॉपर्टी
destinations	टाइप:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> मंज़िलों का कलेक्शन, जिससे रिस्पॉन्स मैट्रिक्स के कॉलम तय होते हैं. स्ट्रिंग के तौर पर पास की गई वैल्यू, कोई पता, प्लस कोड या जगह के संसाधन का नाम हो सकती है. ऊंचाई की वैल्यू को ध्यान में नहीं रखा जाता.
fields	टाइप:  Iterable<string> फ़ेच किए जाने वाले फ़ील्ड का कलेक्शन. सभी फ़ील्ड के लिए ["*"] तय करें.
origins	टाइप:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> शुरुआती जगहों का कलेक्शन, जिससे रिस्पॉन्स मैट्रिक्स की लाइनें तय होती हैं. स्ट्रिंग के तौर पर पास की गई वैल्यू, कोई पता, प्लस कोड या जगह के संसाधन का नाम हो सकती है. ऊंचाई की वैल्यू को ध्यान में नहीं रखा जाता. ओरिजिन और डेस्टिनेशन के एलिमेंट की संख्या पर, साइज़ से जुड़ी कई पाबंदियां लागू होती हैं: string या Place के तौर पर तय किए गए ऑरिजिन और डेस्टिनेशन की कुल संख्या 50 से ज़्यादा नहीं होनी चाहिए. शुरुआत की जगहों और मंज़िलों की संख्या का प्रॉडक्ट, 625 से ज़्यादा नहीं होना चाहिए. अगर ComputeRouteMatrixRequest.routingPreference को TRAFFIC_AWARE_OPTIMAL पर सेट किया गया है, तो ओरिजिन और डेस्टिनेशन की संख्या का प्रॉडक्ट 100 से ज़्यादा नहीं होना चाहिए. अगर ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट किया गया है, तो ओरिजिन और डेस्टिनेशन की संख्या का प्रॉडक्ट 100 से ज़्यादा नहीं होना चाहिए.
arrivalTime optional	टाइप:  Date optional पहुंचने का समय. ध्यान दें: इसे सिर्फ़ तब सेट किया जा सकता है, जब ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट किया गया हो. ComputeRouteMatrixRequest.departureTime या ComputeRouteMatrixRequest.arrivalTime में से किसी एक को तय किया जा सकता है, लेकिन दोनों को नहीं. बस, मेट्रो वगैरह से की गई यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.
departureTime optional	टाइप:  Date optional रवानगी का समय. अगर आपने यह वैल्यू सेट नहीं की है, तो यह वैल्यू डिफ़ॉल्ट रूप से उस समय पर सेट हो जाती है जब आपने अनुरोध किया था. ध्यान दें: ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट करने पर ही, बीते समय की कोई तारीख चुनी जा सकती है. बस, मेट्रो वगैरह से की गई यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.
extraComputations optional	टाइप:  Iterable<ComputeRouteMatrixExtraComputation> optional अतिरिक्त कंप्यूटेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है. ध्यान दें: इन अतिरिक्त कंप्यूटेशन की वजह से, रिस्पॉन्स में अतिरिक्त फ़ील्ड दिख सकते हैं. जवाब में वापस पाने के लिए, इन अतिरिक्त फ़ील्ड को ComputeRouteMatrixRequest.fields में भी शामिल करना होगा.
language optional	टाइप:  string optional BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, यूनिकोड लोकेल आइडेंटिफ़ायर देखें. यह सुविधा किन भाषाओं में उपलब्ध है, इसकी सूची देखने के लिए यह सुविधा किन भाषाओं में उपलब्ध है लेख पढ़ें. अगर यह वैल्यू नहीं दी जाती है, तो भाषा का पता Google Maps JavaScript API की स्थानीय भाषा की सेटिंग से लगाया जाता है. ऐसा न होने पर, भाषा का अनुमान पहले ऑरिजिन की जगह से लगाया जाता है.
region optional	टाइप:  string optional क्षेत्र का कोड, ccTLD ("टॉप-लेवल डोमेन") के तौर पर दो वर्णों की वैल्यू के तौर पर दिया जाता है. ज़्यादा जानकारी के लिए, देश के कोड के हिसाब से टॉप लेवल डोमेन देखें. अगर आपने यह वैल्यू नहीं दी है, तो Google Maps JavaScript API की स्थानीय भाषा की सेटिंग से क्षेत्र का पता लगाया जाता है. अगर ऐसा नहीं है, तो क्षेत्र का अनुमान, पहले ऑरिजिन की जगह से लगाया जाता है.
routingPreference optional	टाइप:  RoutingPreference optional इससे पता चलता है कि रूट मैट्रिक्स की गिनती कैसे की जाती है. सर्वर, रूट मैट्रिक्स का हिसाब लगाने के लिए, चुनी गई रूटिंग की प्राथमिकता का इस्तेमाल करने की कोशिश करता है. अगर रूटिंग की प्राथमिकता की वजह से कोई गड़बड़ी होती है या इंतज़ार का समय बहुत ज़्यादा होता है, तो गड़बड़ी का मैसेज दिखता है. इस विकल्प को सिर्फ़ तब चुना जा सकता है, जब ComputeRouteMatrixRequest.travelMode की वैल्यू DRIVING या TWO_WHEELER हो. ऐसा न होने पर, अनुरोध पूरा नहीं हो पाएगा.
trafficModel optional	टाइप:  TrafficModel optional इससे उन अनुमानों के बारे में पता चलता है जिनका इस्तेमाल, ट्रैफ़िक में लगने वाले समय का हिसाब लगाने के लिए किया जाता है. इस सेटिंग का असर, RouteMatrixItem.durationMillis में दिखाई गई वैल्यू पर पड़ता है. इसमें, पुराने औसत के आधार पर ट्रैफ़िक में लगने वाले अनुमानित समय की जानकारी होती है. ComputeRouteMatrixRequest.trafficModel सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें ComputeRouteMatrixRequest.routingPreference को TRAFFIC_AWARE_OPTIMAL और ComputeRouteMatrixRequest.travelMode को DRIVING पर सेट किया गया है. डिफ़ॉल्ट रूप से, यह BEST_GUESS पर सेट होता है.
transitPreference optional	टाइप:  TransitPreference optional इससे उन प्राथमिकताओं के बारे में पता चलता है जो TRANSIT रास्तों के लिए दिखाए गए रास्ते पर असर डालती हैं. ध्यान दें: इसे सिर्फ़ तब तय किया जा सकता है, जब ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट किया गया हो.
travelMode optional	टाइप:  TravelMode optional इससे यात्रा के साधन के बारे में पता चलता है.
units optional	टाइप:  UnitSystem optional इससे, डिसप्ले फ़ील्ड के लिए माप की इकाइयां तय होती हैं. अगर आपने यह वैल्यू नहीं दी है, तो डिसप्ले यूनिट का अनुमान, पहली ऑरिजिन की जगह से लगाया जाता है.

ComputeRouteMatrixExtraComputation कॉन्स्टेंट

google.maps.routes.ComputeRouteMatrixExtraComputation कॉन्सटैंट

RouteMatrix.computeRouteMatrix अनुरोध के लिए, अतिरिक्त कंप्यूटेशन की ज़रूरत होती है.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

कॉन्स्टेंट
TOLLS	मैट्रिक्स आइटम के लिए टोल की जानकारी.

RouteMatrixItemCondition कॉन्स्टेंट

google.maps.routes.RouteMatrixItemCondition कॉन्सटैंट

यात्रा शुरू करने की जगह और मंज़िल के बीच के रास्ते की स्थिति.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

कॉन्स्टेंट
ROUTE_EXISTS	एक रास्ता मिला.
ROUTE_NOT_FOUND	कोई रास्ता नहीं मिला.

RouteMatrixItemError क्लास

google.maps.routes.RouteMatrixItemError क्लास

किसी खास ऑरिजिन/डेस्टिनेशन पेयर के लिए, RouteMatrix.computeRouteMatrix के दौरान हुई गड़बड़ी.

यह क्लास, Error को एक्सटेंड करती है.

const {RouteMatrixItemError} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

तरीके
toJSON	toJSON() पैरामीटर:  कोई नहीं रिटर्न वैल्यू:  Object ऑब्जेक्ट में बदलता है.

RouteMatrixItemLocalizedValues क्लास

google.maps.routes.RouteMatrixItemLocalizedValues क्लास

RouteMatrixItem को टेक्स्ट के तौर पर दिखाने की सुविधा.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.

प्रॉपर्टी
distance	टाइप:  string optional टेक्स्ट के तौर पर, रूट मैट्रिक्स आइटम की यात्रा की दूरी.
distanceLanguage	टाइप:  string optional दूरी के टेक्स्ट का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier पर जाएं.
duration	टाइप:  string optional अवधि, टेक्स्ट के तौर पर दिखाई जाती है और क्वेरी के क्षेत्र के हिसाब से स्थानीय भाषा में होती है. ट्रैफ़िक की स्थिति को ध्यान में रखता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू RouteMatrixItemLocalizedValues.staticDuration की वैल्यू के बराबर होगी.
durationLanguage	टाइप:  string optional अवधि के टेक्स्ट का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier पर जाएं.
staticDuration	टाइप:  string optional ट्रैफ़िक का हाल ध्यान में रखे बिना, यात्रा में लगने वाला समय. इसे टेक्स्ट के तौर पर दिखाया जाता है.
staticDurationLanguage	टाइप:  string optional स्टैटिक टेक्स्ट के तौर पर दी गई अवधि का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn".
transitFare	टाइप:  string optional बस, मेट्रो वगैरह का किराया, टेक्स्ट के तौर पर दिखाया जाता है.
transitFareLanguage	टाइप:  string optional बस, मेट्रो वगैरह के किराये की जानकारी देने वाले टेक्स्ट का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier पर जाएं.

तरीके
toJSON	toJSON() पैरामीटर:  कोई नहीं रिटर्न वैल्यू:  Object ऑब्जेक्ट में बदलता है.

RouteMatrixOrigin इंटरफ़ेस

google.maps.routes.RouteMatrixOrigin इंटरफ़ेस

ComputeRouteMatrixRequest के लिए एक ऑरिजिन.

प्रॉपर्टी
waypoint	टाइप:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint यात्रा शुरू होने की जगह. स्ट्रिंग के तौर पर पास की गई वैल्यू, कोई पता या प्लस कोड हो सकता है. ऊंचाई की वैल्यू को ध्यान में नहीं रखा जाता.
routeModifiers optional	टाइप:  RouteModifiers optional इस जगह से शुरू होने वाले हर रास्ते के लिए मॉडिफ़ायर.