Route Matrix

RouteMatrix क्लास

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

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

const {RouteMatrix} = await google.maps.importLibrary("routes");

स्टैटिक मेथड

computeRouteMatrix

computeRouteMatrix(request) पैरामीटर: request: ComputeRouteMatrixRequest रिटर्न वैल्यू: 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	टाइप: 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 ज़रूरी नहीं	टाइप: Date optional पहुंचने का समय. ध्यान दें: इसे सिर्फ़ तब सेट किया जा सकता है, जब ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट किया गया हो. ComputeRouteMatrixRequest.departureTime या ComputeRouteMatrixRequest.arrivalTime में से किसी एक को तय किया जा सकता है, लेकिन दोनों को नहीं. बस, मेट्रो वगैरह से की गई यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.
departureTime ज़रूरी नहीं	टाइप: Date optional रवानगी का समय. अगर आपने यह वैल्यू सेट नहीं की है, तो यह वैल्यू डिफ़ॉल्ट रूप से उस समय पर सेट हो जाती है जब आपने अनुरोध किया था. ध्यान दें: ComputeRouteMatrixRequest.travelMode को TRANSIT पर सेट करने पर ही, बीते समय की कोई तारीख चुनी जा सकती है. बस, मेट्रो वगैरह से की गई यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.
extraComputations ज़रूरी नहीं	टाइप: Iterable<ComputeRouteMatrixExtraComputation> optional अतिरिक्त कंप्यूटेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है. ध्यान दें: इन अतिरिक्त कंप्यूटेशन की वजह से, रिस्पॉन्स में अतिरिक्त फ़ील्ड दिख सकते हैं. जवाब में वापस पाने के लिए, इन अतिरिक्त फ़ील्ड को 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	टाइप: string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint यात्रा शुरू होने की जगह. स्ट्रिंग के तौर पर पास की गई वैल्यू, कोई पता या प्लस कोड हो सकता है. ऊंचाई की वैल्यू को ध्यान में नहीं रखा जाता.
routeModifiers ज़रूरी नहीं	टाइप: RouteModifiers optional इस जगह से शुरू होने वाले हर रास्ते के लिए मॉडिफ़ायर.