Route Matrix (beta)

RouteMatrix क्लास

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

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

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 का एक कलेक्शन होता है. हर RouteMatrixItem, किसी मंज़िल तक पहुंचने का रास्ता दिखाता है.

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

RouteMatrixRow क्लास

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

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

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

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

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

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

RouteMatrixItem क्लास

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

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

इसमें 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 रास्ते के बारे में अतिरिक्त जानकारी.

ComputeRouteMatrixRequest इंटरफ़ेस

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

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

रास्ते की मैट्रिक्स के लिए अनुरोध.

प्रॉपर्टी
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 कॉन्स्टेंट

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

RouteMatrix.computeRouteMatrix अनुरोध के लिए अतिरिक्त कंप्यूटेशन.

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

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

RouteMatrixItemCondition कॉन्स्टेंट

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

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

यात्रा शुरू करने की जगह/मंज़िल के किसी दिए गए जोड़े के लिए, रास्ते की स्थिति.

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

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

RouteMatrixItemError क्लास

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

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

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

यह क्लास Error तक चलेगी.

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

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

RouteMatrixItemLocalizedValues क्लास

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

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

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 इंटरफ़ेस

ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है.

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

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