Route Matrix

RouteMatrix क्लास

क्लास google.maps.routes.RouteMatrix
लाइब्रेरी "routes"

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

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

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

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

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

RouteMatrixRow क्लास

क्लास google.maps.routes.RouteMatrixRow
लाइब्रेरी "routes"

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

const {RouteMatrixRow} = await google.maps.importLibrary("routes");
items
readonly
टाइप: Array<RouteMatrixItem>
हर डेस्टिनेशन के लिए रास्ते की जानकारी.
इनहेरिट किया गया: toJSON

RouteMatrixItem क्लास

क्लास google.maps.routes.RouteMatrixItem
लाइब्रेरी "routes"

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

const {RouteMatrixItem} = await google.maps.importLibrary("routes");
condition
readonly
टाइप: RouteMatrixItemCondition optional
इससे पता चलता है कि रास्ता मिला या नहीं.
distanceMeters
readonly
टाइप: number optional
मीटर में रास्ते की दूरी.
durationMillis
readonly
टाइप: number optional
रास्ते पर नेविगेट करने में लगने वाला समय, मिलीसेकंड में. अगर ComputeRouteMatrixRequest.routingPreference को TRAFFIC_UNAWARE पर सेट किया जाता है, तो यह वैल्यू RouteMatrixItem.staticDurationMillis के बराबर होगी. अगर ComputeRouteMatrixRequest.routingPreference को TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट किया जाता है, तो इस वैल्यू का हिसाब ट्रैफ़िक की स्थिति को ध्यान में रखकर लगाया जाता है.

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

ध्यान दें: अगर अवधि 2^53 मिलीसेकंड से ज़्यादा है, तो यह वैल्यू Number.POSITIVE_INFINITY होगी.
travelAdvisory
readonly
टाइप: 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
ज़रूरी नहीं
टाइप: Date optional
पहुंचने का समय.

ध्यान दें: इसे सिर्फ़ तब सेट किया जा सकता है, जब ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट किया गया हो. ComputeRouteMatrixRequest.departureTime या ComputeRouteMatrixRequest.arrivalTime में से किसी एक को तय किया जा सकता है, लेकिन दोनों को नहीं. बस, मेट्रो वगैरह से की गई यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.
departureTime
ज़रूरी नहीं
टाइप: Date optional
रवानगी का समय. अगर आपने यह वैल्यू सेट नहीं की है, तो यह वैल्यू डिफ़ॉल्ट रूप से उस समय पर सेट हो जाती है जब आपने अनुरोध किया था.

ध्यान दें: ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट करने पर ही, बीते समय की कोई तारीख चुनी जा सकती है. बस, मेट्रो वगैरह से की गई यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.
extraComputations
ज़रूरी नहीं
अतिरिक्त कंप्यूटेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है.

ध्यान दें: इन अतिरिक्त कंप्यूटेशन की वजह से, रिस्पॉन्स में अतिरिक्त फ़ील्ड दिख सकते हैं. जवाब में वापस पाने के लिए, इन अतिरिक्त फ़ील्ड को ComputeRouteMatrixRequest.fields में भी शामिल करना होगा.
internalUsageAttributionIds
ज़रूरी नहीं
टाइप: Iterable<string> optional
इन आइडेंटिफ़ायर का इस्तेमाल, कॉल को खास पैकेज या ओएसएस लाइब्रेरी से एट्रिब्यूट करने के लिए किया जाता है.
language
ज़रूरी नहीं
टाइप: string optional
BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, यूनिकोड लोकेल आइडेंटिफ़ायर देखें. यह सुविधा किन भाषाओं में उपलब्ध है, इसकी सूची देखने के लिए यह सुविधा किन भाषाओं में उपलब्ध है लेख पढ़ें. अगर यह वैल्यू नहीं दी जाती है, तो भाषा का पता Google Maps JavaScript API की स्थानीय भाषा की सेटिंग से लगाया जाता है. ऐसा न होने पर, भाषा का अनुमान पहले ऑरिजिन की जगह से लगाया जाता है.
region
ज़रूरी नहीं
टाइप: string optional
क्षेत्र का कोड, ccTLD ("टॉप-लेवल डोमेन") के तौर पर दो वर्णों की वैल्यू के तौर पर दिया जाता है. ज़्यादा जानकारी के लिए, देश के कोड के हिसाब से टॉप लेवल डोमेन देखें. अगर आपने यह वैल्यू नहीं दी है, तो Google Maps JavaScript API की स्थानीय भाषा की सेटिंग से क्षेत्र का पता लगाया जाता है. अगर ऐसा नहीं है, तो क्षेत्र का अनुमान, पहले ऑरिजिन की जगह से लगाया जाता है.
routingPreference
ज़रूरी नहीं
टाइप: RoutingPreference optional
इससे पता चलता है कि रूट मैट्रिक्स की गिनती कैसे की जाती है. सर्वर, रूट मैट्रिक्स का हिसाब लगाने के लिए, चुनी गई रूटिंग की प्राथमिकता का इस्तेमाल करने की कोशिश करता है. अगर रूटिंग की प्राथमिकता की वजह से कोई गड़बड़ी होती है या इंतज़ार का समय बहुत ज़्यादा होता है, तो गड़बड़ी का मैसेज दिखता है. इस विकल्प को सिर्फ़ तब चुना जा सकता है, जब ComputeRouteMatrixRequest.travelMode की वैल्यू DRIVING या TWO_WHEELER हो. ऐसा न होने पर, अनुरोध पूरा नहीं हो पाएगा.
trafficModel
ज़रूरी नहीं
टाइप: TrafficModel optional
इससे उन अनुमानों के बारे में पता चलता है जिनका इस्तेमाल, ट्रैफ़िक में लगने वाले समय का हिसाब लगाने के लिए किया जाता है. इस सेटिंग का असर, RouteMatrixItem.durationMillis में दिखाई गई वैल्यू पर पड़ता है. इसमें, पुराने औसत के आधार पर ट्रैफ़िक में लगने वाले अनुमानित समय की जानकारी होती है. ComputeRouteMatrixRequest.trafficModel सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें ComputeRouteMatrixRequest.routingPreference को TRAFFIC_AWARE_OPTIMAL और ComputeRouteMatrixRequest.travelMode को DRIVING पर सेट किया गया है. डिफ़ॉल्ट रूप से, यह BEST_GUESS पर सेट होता है.
transitPreference
ज़रूरी नहीं
टाइप: TransitPreference optional
इससे उन प्राथमिकताओं के बारे में पता चलता है जो TRANSIT रास्तों के लिए दिखाए गए रास्ते पर असर डालती हैं.

ध्यान दें: इसे सिर्फ़ तब तय किया जा सकता है, जब ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट किया गया हो.
travelMode
ज़रूरी नहीं
टाइप: TravelMode optional
इससे यात्रा के साधन के बारे में पता चलता है.
units
ज़रूरी नहीं
टाइप: UnitSystem optional
इससे, डिसप्ले फ़ील्ड के लिए माप की इकाइयां तय होती हैं. अगर आपने यह वैल्यू नहीं दी है, तो डिसप्ले यूनिट का अनुमान, पहली ऑरिजिन की जगह से लगाया जाता है.

ComputeRouteMatrixExtraComputation कॉन्स्टेंट

कॉन्सटैंट google.maps.routes.ComputeRouteMatrixExtraComputation
लाइब्रेरी "routes"

अनुरोध पूरा करते समय की जाने वाली अतिरिक्त कंप्यूटेशन. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को ComputeRouteMatrixExtraComputationString टाइप से तय किया जाता है.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");
TOLLS मैट्रिक्स एलिमेंट के लिए टोल की जानकारी. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.

RouteMatrixItemCondition कॉन्स्टेंट

कॉन्सटैंट google.maps.routes.RouteMatrixItemCondition
लाइब्रेरी "routes"

लौटाए जा रहे रास्ते की स्थिति. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को RouteMatrixItemConditionString टाइप से तय किया जाता है.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");
ROUTE_EXISTS एक रूट मिला और एलिमेंट के लिए उससे जुड़ी जानकारी भरी गई. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.
ROUTE_NOT_FOUND कोई रास्ता नहीं मिला. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.

RouteMatrixItemError क्लास

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

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

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");
इनहेरिट किया गया: toJSON

RouteMatrixItemLocalizedValues क्लास

क्लास google.maps.routes.RouteMatrixItemLocalizedValues
लाइब्रेरी "routes"

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

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
टाइप: string optional
टेक्स्ट के तौर पर, रूट मैट्रिक्स आइटम की यात्रा की दूरी.
distanceLanguage
readonly
टाइप: string optional
दूरी के टेक्स्ट का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn".

ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier पर जाएं.
duration
readonly
टाइप: string optional
अवधि, टेक्स्ट के तौर पर दिखाई जाती है और क्वेरी के क्षेत्र के हिसाब से स्थानीय भाषा में होती है. ट्रैफ़िक की स्थिति को ध्यान में रखता है.

ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू RouteMatrixItemLocalizedValues.staticDuration की वैल्यू के बराबर होगी.
durationLanguage
readonly
टाइप: string optional
अवधि के टेक्स्ट का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn".

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

ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier पर जाएं.
इनहेरिट किया गया: toJSON

RouteMatrixOrigin इंटरफ़ेस

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

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