Route Matrix (beta)

RouteMatrix क्लास

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

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

const {RouteMatrix} = await google.maps.importLibrary("routes") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
computeRouteMatrix
computeRouteMatrix(request)
पैरामीटर: 
लौटाई गई वैल्यू:  Promise<{matrix:RouteMatrix}>
यह फ़ंक्शन, ओरिजन और डेस्टिनेशन की सूची लेता है. इसके बाद, यह एक मैट्रिक्स दिखाता है. इस मैट्रिक्स में, ओरिजन और डेस्टिनेशन के हर कॉम्बिनेशन के लिए रास्ते की जानकारी होती है.

ध्यान दें: इस तरीके के लिए, यह ज़रूरी है कि अनुरोध में रिस्पॉन्स फ़ील्ड मास्क तय किया जाए. इसके लिए, ComputeRouteMatrixRequest.fields प्रॉपर्टी सेट करें. यह वैल्यू, फ़ील्ड पाथ की सूची होती है.

उदाहरण के लिए:
  • सभी उपलब्ध फ़ील्ड का फ़ील्ड मास्क: fields: ['*']
  • रास्ते के लेवल पर अवधि और दूरी का फ़ील्ड मास्क: fields: ['durationMillis', 'distanceMeters']

वाइल्डकार्ड रिस्पॉन्स फ़ील्ड मास्क fields: ['*'] का इस्तेमाल न करने का सुझाव दिया जाता है, क्योंकि:
  • सिर्फ़ ज़रूरी फ़ील्ड चुनने से, हमारे सर्वर को कंप्यूटेशन साइकल सेव करने में मदद मिलती है. इससे हम आपको कम समय में नतीजे दिखा पाते हैं.
  • सिर्फ़ उन फ़ील्ड को चुनने से जिनकी आपको प्रोडक्शन जॉब में ज़रूरत है, यह पक्का किया जा सकता है कि लेटेंसी की परफ़ॉर्मेंस स्थिर रहे. हम आने वाले समय में, जवाब के ज़्यादा फ़ील्ड जोड़ सकते हैं. इन नए फ़ील्ड के लिए, कैलकुलेशन में ज़्यादा समय लग सकता है. अगर आपने सभी फ़ील्ड चुने हैं या टॉप लेवल पर सभी फ़ील्ड चुने हैं, तो आपको परफ़ॉर्मेंस में गिरावट देखने को मिल सकती है. ऐसा इसलिए, क्योंकि हम जो भी नया फ़ील्ड जोड़ेंगे वह जवाब में अपने-आप शामिल हो जाएगा.
  • सिर्फ़ उन फ़ील्ड को चुनने से जिनके लिए आपको नतीजे चाहिए, जवाब का साइज़ छोटा हो जाता है. इससे नेटवर्क पर डेटा तेज़ी से लोड होता है.
rows
टाइप:  Array<RouteMatrixRow>
मैट्रिक्स की लाइनें. हर लाइन, किसी मूल स्थान से जुड़ी होती है. इसमें RouteMatrixItem का एक कलेक्शन होता है. हर 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
रास्ते के बारे में अतिरिक्त जानकारी.

ComputeRouteMatrixRequest इंटरफ़ेस

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

रास्ते की मैट्रिक्स के लिए अनुरोध.
destinations
डेस्टिनेशन का कलेक्शन. इससे रिस्पॉन्स मैट्रिक्स के कॉलम तय होते हैं. स्ट्रिंग के तौर पर पास की गई वैल्यू, कोई पता, प्लस कोड या जगह के संसाधन का नाम हो सकता है. ऊंचाई की वैल्यू को ध्यान में नहीं रखा जाता.
fields
टाइप:  Iterable<string>
फ़ेच किए जाने वाले फ़ील्ड का कलेक्शन. सभी फ़ील्ड के लिए ["*"] तय करें.
origins
ऑरिजिन का कलेक्शन, जिससे जवाब मैट्रिक्स की पंक्तियां तय होती हैं. स्ट्रिंग के तौर पर पास की गई वैल्यू, कोई पता, प्लस कोड या जगह के संसाधन का नाम हो सकता है. ऊंचाई की वैल्यू को ध्यान में नहीं रखा जाता.

ओरिजिन और डेस्टिनेशन के एलिमेंट की संख्या पर, साइज़ से जुड़ी कई पाबंदियां लागू होती हैं:
  • 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
अतिरिक्त कैलकुलेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है.

ध्यान दें: इन अतिरिक्त कंप्यूटेशन से, जवाब में अतिरिक्त फ़ील्ड दिख सकते हैं. जवाब में इन अतिरिक्त फ़ील्ड को शामिल करने के लिए, इन्हें 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
ऑरिजिन की जगह. स्ट्रिंग के तौर पर पास की गई वैल्यू, पता या प्लस कोड हो सकती है. ऊंचाई की वैल्यू को ध्यान में नहीं रखा जाता.
routeModifiers optional
टाइप:  RouteModifiers optional
हर उस रास्ते के लिए मॉडिफ़ायर जो इसे मूल जगह के तौर पर इस्तेमाल करता है.