- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- रूट
- RouteLabel
- RouteLeg
- पॉलीलाइन
- RouteLegStep
- NavigationInstruction
- चालबाज़ी
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- व्यूपोर्ट
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
टर्मिनल और बीच के वेपॉइंट के सेट के आधार पर, वैकल्पिक रास्तों के साथ मुख्य रास्ता दिखाता है.
ध्यान दें: इस तरीके के लिए ज़रूरी है कि आप इनपुट में रिस्पॉन्स फ़ील्ड मास्क दें. यूआरएल पैरामीटर $fields
या fields
का इस्तेमाल करके या एचटीटीपी/gRPC हेडर X-Goog-FieldMask
का इस्तेमाल करके, रिस्पॉन्स फ़ील्ड मास्क दिया जा सकता है. उपलब्ध यूआरएल पैरामीटर और हेडर देखें. यह वैल्यू, फ़ील्ड पाथ की कॉमा लगाकर अलग की गई सूची होती है. फ़ील्ड पाथ बनाने के तरीके के बारे में ज़्यादा जानकारी वाले दस्तावेज़ देखें.
उदाहरण के लिए, इस तरीके में:
- सभी उपलब्ध फ़ील्ड का फ़ील्ड मास्क (मैन्युअल जांच के लिए):
X-Goog-FieldMask: *
- रूट-लेवल पर तय की गई दूरी, दूरी, और पॉलीलाइन का फ़ील्ड मास्क (उदाहरण के तौर पर, प्रोडक्शन सेटअप का उदाहरण):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google, वाइल्डकार्ड (*
) रिस्पॉन्स फ़ील्ड मास्क या टॉप लेवल (routes
) पर फ़ील्ड मास्क शामिल करने से मना करता है, क्योंकि:
- सिर्फ़ अपनी ज़रूरत के फ़ील्ड चुनने पर, हमारे सर्वर को कंप्यूटेशन साइकल सेव करने में मदद मिलती है. इससे हम इंतज़ार के समय को कम करके, आपको नतीजे दिखा पाते हैं.
- प्रोडक्शन जॉब के लिए ज़रूरी फ़ील्ड चुनने से यह पक्का होता है कि इंतज़ार के समय की परफ़ॉर्मेंस बेहतर हो. आने वाले समय में, हम जवाब वाले और फ़ील्ड जोड़ सकते हैं. साथ ही, उन नए फ़ील्ड को कैलकुलेट करने में ज़्यादा समय लग सकता है. अगर सभी फ़ील्ड चुने जाते हैं या टॉप लेवल पर सभी फ़ील्ड चुने जाते हैं, तो परफ़ॉर्मेंस में गिरावट आ सकती है. इसकी वजह यह है कि हम जो भी नया फ़ील्ड जोड़ते हैं वह जवाब में अपने-आप शामिल हो जाता है.
- सिर्फ़ उन फ़ील्ड को चुनने से जिनका रिस्पॉन्स साइज़ छोटा होता है और नेटवर्क की क्षमता में बढ़ोतरी होती है.
एचटीटीपी अनुरोध
POST https://routes.googleapis.com/directions/v2:computeRoutes
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "origin": { object ( |
फ़ील्ड | |
---|---|
origin |
ज़रूरी है. ऑरिजिन वेपॉइंट. |
destination |
ज़रूरी है. डेस्टिनेशन वेपॉइंट. |
intermediates[] |
ज़रूरी नहीं. रास्ते पर वेपॉइंट का एक सेट (टर्मिनल पॉइंट को छोड़कर), या तो वहां से निकलने या रोकने के लिए. ज़्यादा से ज़्यादा 25 इंटरमीडिएट वेपॉइंट इस्तेमाल किए जा सकते हैं. |
travelMode |
ज़रूरी नहीं. परिवहन का साधन बताता है. |
routingPreference |
ज़रूरी नहीं. बताता है कि रूट की गणना कैसे की जाए. रूट की गणना करने के लिए सर्वर चुनी गई रूटिंग प्राथमिकता का इस्तेमाल करने की कोशिश करता है. अगर रूटिंग की प्राथमिकता से गड़बड़ी होती है या इंतज़ार का समय ज़्यादा होता है, तो गड़बड़ी दिखती है. इस विकल्प को सिर्फ़ तब तय किया जा सकता है, जब |
polylineQuality |
ज़रूरी नहीं. पॉलीलाइन की क्वालिटी के लिए आपकी प्राथमिकता बताता है. |
polylineEncoding |
ज़रूरी नहीं. पॉलीलाइन के लिए पसंदीदा एन्कोडिंग तय करता है. |
departureTime |
ज़रूरी नहीं. रवानगी का समय. अगर यह वैल्यू सेट नहीं की जाती है, तो डिफ़ॉल्ट रूप से यह वैल्यू, अनुरोध किए जाने के समय से मेल खाएगी. ध्यान दें: RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: |
arrivalTime |
ज़रूरी नहीं. पहुंचने का समय. ध्यान दें: इसे सिर्फ़ तब सेट किया जा सकता है, जब RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: |
computeAlternativeRoutes |
ज़रूरी नहीं. इस बात की जानकारी देता है कि रास्ते के साथ-साथ दूसरे रास्तों की भी गणना करनी है या नहीं. उन अनुरोधों के लिए कोई वैकल्पिक रास्ता नहीं दिखाया जाता जिनमें बीच के वेपॉइंट हैं. |
routeModifiers |
ज़रूरी नहीं. रास्तों का हिसाब लगाने के तरीके पर असर डालने वाली शर्तों का सेट. |
languageCode |
ज़रूरी नहीं. BCP-47 भाषा कोड, जैसे "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, यूनिकोड स्थान-भाषा आइडेंटिफ़ायर देखें. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, भाषा की सुविधा देखें. यह वैल्यू नहीं देने पर, डिसप्ले भाषा का अनुमान उस जगह के हिसाब से लगाया जाता है जहां के लिए रूट का अनुरोध किया गया था. |
regionCode |
ज़रूरी नहीं. क्षेत्र का कोड, जिसे ccTLD ("टॉप लेवल डोमेन") दो वर्ण की वैल्यू के तौर पर दिखाया जाता है. ज़्यादा जानकारी के लिए, देश कोड टॉप लेवल डोमेन देखें. |
units |
ज़रूरी नहीं. डिसप्ले फ़ील्ड की माप की इकाइयों के बारे में बताता है. इन फ़ील्ड में, |
optimizeWaypointOrder |
ज़रूरी नहीं. अगर नीति को 'सही है' पर सेट किया जाता है, तो सेवा बीच में आने वाले वेपॉइंट को फिर से क्रम में लगाकर, रूट की कुल लागत को कम करने की कोशिश करती है. अगर कोई भी बीच का वेपॉइंट |
requestedReferenceRoutes[] |
ज़रूरी नहीं. इससे यह पता चलता है कि डिफ़ॉल्ट रूट के साथ-साथ, अनुरोध के हिस्से के तौर पर किन रेफ़रंस रूट का हिसाब लगाना है. रेफ़रंस रूट, ऐसा रूट है जिसका मकसद डिफ़ॉल्ट रूट से अलग रूट कैलकुलेट करना है. उदाहरण के लिए, |
extraComputations[] |
ज़रूरी नहीं. अतिरिक्त कंप्यूटेशन की एक सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है. ध्यान दें: ये अतिरिक्त कंप्यूटेशन, रिस्पॉन्स पर अतिरिक्त फ़ील्ड दिखा सकते हैं. जवाब में दिखाने के लिए, इन अतिरिक्त फ़ील्ड को फ़ील्ड मास्क में भी तय करना होगा. |
trafficModel |
ज़रूरी नहीं. ट्रैफ़िक में समय का हिसाब लगाते समय इस्तेमाल किए जाने वाले अनुमानों को दिखाता है. इस सेटिंग से, |
transitPreferences |
ज़रूरी नहीं. उन प्राथमिकताओं के बारे में बताता है जो |
जवाब का मुख्य भाग
v2.ComputeRoutes, रिस्पॉन्स मैसेज दिखाता है.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "routes": [ { object ( |
फ़ील्ड | |
---|---|
routes[] |
इसमें |
fallbackInfo |
कुछ मामलों में, जब सर्वर सभी इनपुट प्राथमिकताओं के साथ रूट के नतीजों का कंप्यूट नहीं कर पाता है, तो हो सकता है कि वह कंप्यूटेशन के किसी दूसरे तरीके का इस्तेमाल करे. फ़ॉलबैक मोड का इस्तेमाल करने पर, इस फ़ील्ड में फ़ॉलबैक के रिस्पॉन्स के बारे में पूरी जानकारी मौजूद होती है. ऐसा न करने पर, यह फ़ील्ड सेट नहीं होता है. |
geocodingResults |
इसमें पतों के तौर पर बताए गए वेपॉइंट के लिए जियोकोडिंग जवाब की जानकारी होती है. |
PolylineQuality
वैल्यू का सेट, जो पॉलीलाइन की क्वालिटी के बारे में बताता है.
Enums | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
कोई पॉलीलाइन क्वालिटी प्राथमिकता नहीं दी गई है. डिफ़ॉल्ट वैल्यू OVERVIEW होती है. |
HIGH_QUALITY |
अच्छी क्वालिटी की पॉलीलाइन दिखाता है - जिसे रिस्पॉन्स साइज़ बढ़ाने की कीमत पर, OVERVIEW से ज़्यादा पॉइंट का इस्तेमाल करके बनाया जाता है. इस वैल्यू का इस्तेमाल तब करें, जब आपको ज़्यादा सटीक जानकारी की ज़रूरत हो. |
OVERVIEW |
ओवरव्यू पॉलीलाइन तय करता है - जिसे कम पॉइंट का इस्तेमाल करके बनाया गया है. रास्ते की खास जानकारी दिखाते समय इस मान का इस्तेमाल करें. HIGH_QUALITY विकल्प के मुकाबले, इस विकल्प का इस्तेमाल करने पर अनुरोध दिखने में लगने वाला समय कम होता है. |
PolylineEncoding
यह तय करता है कि किस तरह की पॉलीलाइन दिखानी है.
Enums | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
कोई पॉलीलाइन प्रकार प्राथमिकता तय नहीं की गई है. डिफ़ॉल्ट वैल्यू ENCODED_POLYLINE होती है. |
ENCODED_POLYLINE |
पॉलीलाइन एन्कोडिंग एल्गोरिदम का इस्तेमाल करके, कोड में बदली गई पॉलीलाइन को तय करता है. |
GEO_JSON_LINESTRING |
GeoJSON LineString फ़ॉर्मैट का इस्तेमाल करके पॉलीलाइन तय करता है |
ReferenceRoute
ComputeRoutesRequest पर, इस्तेमाल किया जा सकने वाला रेफ़रंस रूट.
Enums | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
इस्तेमाल नहीं किया गया. इस वैल्यू वाले अनुरोध पूरे नहीं हो सके. |
FUEL_EFFICIENT |
ईंधन की कम खपत वाला रास्ता. जिन रास्तों को इस वैल्यू के साथ लेबल किया गया है उन्हें ईंधन की खपत जैसे पैरामीटर के हिसाब से ऑप्टिमाइज़ किया जाता है. |
ExtraComputation
अनुरोध पूरा करते समय की जाने वाली अतिरिक्त गणना.
Enums | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
इस्तेमाल नहीं किया गया. इस वैल्यू वाले अनुरोध स्वीकार नहीं किए जाएंगे. |
TOLLS |
रास्ते के लिए टोल की जानकारी. |
FUEL_CONSUMPTION |
रास्तों के लिए ईंधन की अनुमानित खपत. |
TRAFFIC_ON_POLYLINE |
रास्तों के लिए ट्रैफ़िक की जानकारी देने वाली पॉलीलाइन. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions को, फ़ॉर्मैट किए गए एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया गया है. यह कॉन्टेंट इसी रूप में पढ़ने के लिए है. यह कॉन्टेंट सिर्फ़ डिसप्ले के लिए है. इसे प्रोग्राम के हिसाब से पार्स न करें. |
देश के हिसाब से डेटा
इसमें एक रास्ता है, जिसमें कई सड़क के सेगमेंट हैं जो शुरुआती, आखिरी, और बीच के वेपॉइंट को जोड़ते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "routeLabels": [ enum ( |
फ़ील्ड | |
---|---|
routeLabels[] |
|
legs[] |
लेग (वेपॉइंट के बीच के पथ सेगमेंट) का संग्रह, जिससे रास्ता बनता है. हर पैर दो गैर- |
distanceMeters |
रास्ते की दूरी मीटर में. |
duration |
मार्ग को नेविगेट करने में लगने वाला समय. अगर सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
staticDuration |
ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना रास्ते में यात्रा करने में लगने वाला समय. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
polyline |
पूरा रास्ता पॉलीलाइन. यह पॉलीलाइन सभी |
description |
रास्ते के बारे में जानकारी. |
warnings[] |
रूट दिखाते समय दिखने वाली चेतावनियों का कलेक्शन. |
viewport |
पॉलीलाइन का व्यूपोर्ट बाउंडिंग बॉक्स. |
travelAdvisory |
रास्ते के बारे में ज़्यादा जानकारी. |
optimizedIntermediateWaypointIndex[] |
अगर |
localizedValues |
|
routeToken |
वेब के लिए सुरक्षित, base64 कोड में बदला गया रूट टोकन, जिसे नेविगेशन SDK टूल को भेजा जा सकता है. इसकी मदद से नेविगेशन SDK टूल, नेविगेशन के दौरान रूट को फिर से बना सकता है. साथ ही, रास्ता बदलने की स्थिति में, v2.computeRoutes को कॉल करके रूट बनाते समय असली मकसद का पालन किया जा सकता है. ग्राहकों को इस टोकन को ओपेक ब्लॉब के तौर पर इस्तेमाल करना चाहिए. इसे पढ़ने या बदलने के लिए नहीं बनाया गया है. ध्यान दें: |
RouteLabel
के लिए लेबल, जो रूट की खास प्रॉपर्टी की पहचान करने में मदद करते हैं, ताकि उनकी तुलना अन्य प्रॉपर्टी से की जा सके.Route
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
डिफ़ॉल्ट - इस्तेमाल नहीं किया गया. |
DEFAULT_ROUTE |
रूट कंप्यूटेशन के लिए डिफ़ॉल्ट "सबसे अच्छा" रूट दिखाया गया. |
DEFAULT_ROUTE_ALTERNATE |
डिफ़ॉल्ट "सबसे अच्छे" रास्ते का एक विकल्प. के बताए जाने पर इस तरह के रास्ते दिखाए जाएंगे. |
FUEL_EFFICIENT |
ईंधन की कम खपत वाला रास्ता. जिन रास्तों को इस वैल्यू के साथ लेबल किया गया है उन्हें ईंधन की खपत जैसे ईको पैरामीटर के हिसाब से ऑप्टिमाइज़ किया जाता है. |
RouteLeg
इसमें गैर-via
वेपॉइंट के बीच एक सेगमेंट होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
फ़ील्ड | |
---|---|
distanceMeters |
रूट लेग की यात्रा की दूरी, मीटर में. |
duration |
पैर तक ले जाने में लगने वाला समय. अगर सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
staticDuration |
ट्रैफ़िक की स्थितियों पर ध्यान दिए बिना, पूरी यात्रा की अवधि का हिसाब. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
polyline |
इस लेग की पूरी पॉलीलाइन, जिसमें |
startLocation |
इस टांग की शुरुआत की जगह. यह जगह, दी गई |
endLocation |
इस टांग के आखिर की जगह. यह जगह, दी गई |
steps[] |
इस लेग में मौजूद सेगमेंट को दिखाने वाले चरणों का कलेक्शन. हर चरण, एक नेविगेशन निर्देश के बारे में बताता है. |
travelAdvisory |
इसमें ऐसी अतिरिक्त जानकारी शामिल होती है जिसके बारे में उपयोगकर्ता को सूचना दी जानी चाहिए. जैसे, किसी रूट पर ट्रैफ़िक ज़ोन से जुड़ी संभावित पाबंदियां. |
localizedValues |
|
stepsOverview |
|
पॉलीलाइन
कोड में बदली गई पॉलीलाइन को एन्कैप्सुलेट करता है.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड polyline_type . पॉलीलाइन के टाइप को एन्कैप्सुलेट करता है. डिफ़ॉल्ट तौर पर, यह encoded_polyline पर सेट होता है. polyline_type इनमें से सिर्फ़ एक हो सकती है: |
|
encodedPolyline |
पॉलीलाइन एन्कोडिंग एल्गोरिदम का इस्तेमाल करके, पॉलीलाइन की स्ट्रिंग को कोड में बदलने का तरीका |
geoJsonLinestring |
GeoJSON LineString फ़ॉर्मैट का इस्तेमाल करके पॉलीलाइन तय करता है. |
RouteLegStep
इसमें
का सेगमेंट होता है. चरण, सिंगल नेविगेशन के निर्देश से जुड़ा होता है. रूट लेग, सीढ़ियों से बने होते हैं.RouteLeg
जेएसओएन के काेड में दिखाना |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
फ़ील्ड | |
---|---|
distanceMeters |
इस कदम की दूरी मीटर में. कुछ मामलों में, हो सकता है कि इस फ़ील्ड में कोई वैल्यू न हो. |
staticDuration |
ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना इस चरण तक पहुंचने में लगने वाला समय. कुछ मामलों में, हो सकता है कि इस फ़ील्ड में कोई वैल्यू न हो. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
polyline |
इस चरण से जुड़ी पॉलीलाइन. |
startLocation |
इस चरण की शुरुआत की जगह. |
endLocation |
इस चरण के खत्म होने की जगह. |
navigationInstruction |
नेविगेशन के निर्देश. |
travelAdvisory |
इसमें ऐसी अतिरिक्त जानकारी होती है जिसके बारे में उपयोगकर्ता को सूचना दी जानी चाहिए. जैसे, किसी गतिविधि के दौरान ट्रैफ़िक ज़ोन से जुड़ी संभावित पाबंदियों की जानकारी. |
localizedValues |
|
transitDetails |
अगर यात्रा मोड |
travelMode |
इस चरण के लिए इस्तेमाल किया गया यात्रा का मोड. |
मैन्यूवर
वैल्यू का एक सेट, जो मौजूदा चरण पर जाने के लिए नेविगेशन कार्रवाई तय करता है (उदाहरण के लिए, बाएं मुड़ना, मर्ज करना या सीधा होना).
Enums | |
---|---|
MANEUVER_UNSPECIFIED |
इस्तेमाल नहीं किया गया. |
TURN_SLIGHT_LEFT |
थोड़ा बाएं मुड़ें. |
TURN_SHARP_LEFT |
तेज़ी से बाईं ओर मुड़ें. |
UTURN_LEFT |
बायां यू-टर्न लें. |
TURN_LEFT |
बाएं मुड़ें. |
TURN_SLIGHT_RIGHT |
थोड़ा दाएं मुड़ें. |
TURN_SHARP_RIGHT |
एकदम दाएं मुड़ें. |
UTURN_RIGHT |
दाईं ओर यू-टर्न लें. |
TURN_RIGHT |
दाएं मुड़ें. |
STRAIGHT |
सीधे आगे बढ़ें. |
RAMP_LEFT |
बायां रैंप लें. |
RAMP_RIGHT |
सही रैंप लें. |
MERGE |
ट्रैफ़िक में शामिल हो जाएं. |
FORK_LEFT |
बायां फ़ोर्क लें. |
FORK_RIGHT |
सही फ़ोर्क लें. |
FERRY |
फ़ेरी से जाएं. |
FERRY_TRAIN |
फ़ेरी पर जाने वाली ट्रेन से जाएं. |
ROUNDABOUT_LEFT |
गोलचक्कर पर बाएं मुड़ें. |
ROUNDABOUT_RIGHT |
गोलचक्कर पर दाएं मुड़ें. |
DEPART |
शुरुआती सूझ-बूझ. |
NAME_CHANGE |
इसका इस्तेमाल सड़क के नाम में बदलाव को दिखाने के लिए किया जाता है. |
RouteLegStepTravelAdvisory
इसमें ऐसी अतिरिक्त जानकारी होती है जिसके बारे में उपयोगकर्ता को सूचना दी जानी चाहिए. जैसे, किसी चरण में ट्रैफ़िक ज़ोन से जुड़ी संभावित पाबंदियां.
जेएसओएन के काेड में दिखाना |
---|
{
"speedReadingIntervals": [
{
object ( |
फ़ील्ड | |
---|---|
speedReadingIntervals[] |
ध्यान दें: फ़िलहाल, इस फ़ील्ड में जानकारी अपने-आप नहीं भरी हुई है. |
RouteLegStepLocalizedValues
कुछ प्रॉपर्टी को टेक्स्ट के ज़रिए दिखाएं.
जेएसओएन के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी, टेक्स्ट के रूप में दिखाई गई है. |
staticDuration |
ट्रैफ़िक की शर्तों को ध्यान में रखे बिना अवधि, जिसे टेक्स्ट के रूप में दिखाया गया है. |
RouteLegStepTransitDetails
TRANSIT
रास्तों से जुड़े RouteLegStep
के लिए ज़्यादा जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "stopDetails": { object ( |
फ़ील्ड | |
---|---|
stopDetails |
कदम के लिए पहुंचने और जाने के स्टॉप के बारे में जानकारी. |
localizedValues |
|
headsign |
वाहन या जाने के स्टॉप पर इस लाइन पर जिस दिशा में यात्रा करनी है उसके बारे में बताता है. दिशा-निर्देश अक्सर टर्मिनस स्टेशन पर होता है. |
headway |
इस समय एक ही स्टॉप से जाने वाली गाड़ियों के बीच के कुल समय की जानकारी देता है. उदाहरण के लिए, अगर हेडवे सेकंड की वैल्यू 600 है, तो आपकी बस छूट जाने पर आपको दस मिनट का इंतज़ार करना पड़ सकता है. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
transitLine |
इस चरण में इस्तेमाल की गई बस, मेट्रो वगैरह के लिए जानकारी. |
stopCount |
रवाना होने से लेकर, मंज़िल पर पहुंचने के स्टॉप तक की संख्या. इस संख्या में, मंज़िल पर पहुंचने का स्टॉप शामिल है, लेकिन इसमें फ़्लाइट की रवानगी का स्टॉप शामिल नहीं है. उदाहरण के लिए, अगर आपका रास्ता स्टॉप A से जाता है, स्टॉप B और C से गुज़रता है और स्टॉप D पर पहुंचता है, तो स्टॉपवॉच की संख्या तीन दिखेगी. |
tripShortText |
यह टेक्स्ट, शेड्यूल और साइन बोर्ड में दिखता है, ताकि यात्रियों को बस, मेट्रो वगैरह के लिए यात्रा की पहचान की जा सके. टेक्स्ट में सेवा दिन के दौरान यात्रा की खास तरह से पहचान होनी चाहिए. उदाहरण के लिए, "538", Amtrak ट्रेन का |
TransitStopDetails
RouteLegStep
के लिए ट्रांज़िट स्टॉप के बारे में जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "arrivalStop": { object ( |
फ़ील्ड | |
---|---|
arrivalStop |
कदम के लिए पहुंचने के स्टॉप के बारे में जानकारी. |
arrivalTime |
चरण के लिए पहुंचने का अनुमानित समय. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: |
departureStop |
चरण के लिए रवाना होने के स्टॉप के बारे में जानकारी. |
departureTime |
चरण के लिए रवानगी का अनुमानित समय. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: |
TransitStop
बस, मेट्रो वगैरह के स्टॉप के बारे में जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{
"name": string,
"location": {
object ( |
फ़ील्ड | |
---|---|
name |
बस, मेट्रो वगैरह के स्टॉप का नाम. |
location |
अक्षांश/देशांतर निर्देशांक में बताया गया स्टॉप की जगह. |
TransitDetailsLocalizedValues
RouteTransitDetails
के लिए मान की स्थानीय भाषा में जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "arrivalTime": { object ( |
फ़ील्ड | |
---|---|
arrivalTime |
समय क्षेत्र के साथ फ़ॉर्मैट किए गए टेक्स्ट में समय. |
departureTime |
समय क्षेत्र के साथ फ़ॉर्मैट किए गए टेक्स्ट में समय. |
LocalizedTime
स्थानीय जगह के अनुसार समय की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{
"time": {
object ( |
फ़ील्ड | |
---|---|
time |
किसी दिए गए टाइम ज़ोन में स्ट्रिंग के तौर पर दिया गया समय. |
timeZone |
इसमें टाइम ज़ोन शामिल होता है. वैल्यू, टाइम ज़ोन का नाम है, जैसा कि आईएएनए टाइम ज़ोन के डेटाबेस में बताया गया है, जैसे कि "अमेरिका/New_York". |
TransitLine
इसमें, इस चरण में इस्तेमाल की गई ट्रांज़िट लाइन की जानकारी होती है.
जेएसओएन के काेड में दिखाना |
---|
{ "agencies": [ { object ( |
फ़ील्ड | |
---|---|
agencies[] |
इस ट्रांज़िट लाइन को चलाने वाली ट्रांसपोर्ट एजेंसी (या एजेंसियां). |
name |
इस ट्रांज़िट लाइन का पूरा नाम, उदाहरण के लिए, "8 Avenue Local". |
uri |
इस ट्रांज़िट लाइन का यूआरआई, जो ट्रांसपोर्ट एजेंसी ने उपलब्ध कराया है. |
color |
इस लाइन के लिए आम तौर पर साइनेज में इस्तेमाल किया जाने वाला रंग. हेक्साडेसिमल में दिखाया जाता है. |
iconUri |
इस लाइन से जुड़े आइकॉन का यूआरआई. |
nameShort |
इस ट्रांज़िट लाइन का छोटा नाम. यह नाम आम तौर पर एक लाइन नंबर के तौर पर इस्तेमाल होता है, जैसे कि "M7" या "355". |
textColor |
इस लाइन के लिए साइनेज पर आम तौर पर इस्तेमाल होने वाला रंग. हेक्साडेसिमल में दिखाया जाता है. |
vehicle |
इस ट्रांज़िट लाइन पर चलने वाला वाहन किस तरह का है. |
TransitAgency
वह ट्रांसपोर्ट एजेंसी जो ट्रांज़िट लाइन का इस्तेमाल करती है.
जेएसओएन के काेड में दिखाना |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
फ़ील्ड | |
---|---|
name |
इस ट्रांसपोर्ट एजेंसी का नाम. |
phoneNumber |
ट्रांसपोर्ट एजेंसी का स्थान-भाषा के हिसाब से फ़ॉर्मैट किया गया फ़ोन नंबर. |
uri |
ट्रांज़िट एजेंसी का यूआरआई. |
TransitVehicle
सार्वजनिक परिवहन के रास्तों में इस्तेमाल किए गए वाहन की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "name": { object ( |
फ़ील्ड | |
---|---|
name |
इस वाहन का नाम, कैपिटल लेटर में है. |
type |
इस्तेमाल किया गया वाहन किस तरह का है. |
iconUri |
इस तरह के वाहन से जुड़े आइकॉन का यूआरआई. |
localIconUri |
लोकल ट्रांसपोर्ट साइनेज के आधार पर, इस तरह के वाहन से जुड़े आइकॉन का यूआरआई. |
TransitVehicleType
सार्वजनिक परिवहन के रास्तों के लिए वाहन किस तरह के हैं.
Enums | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
अप्रयुक्त. |
BUS |
बस. |
CABLE_CAR |
केबल से चलने वाला वाहन, जो आम तौर पर ज़मीन पर होता है. एरियल केबल कार GONDOLA_LIFT टाइप की हो सकती हैं. |
COMMUTER_TRAIN |
यात्री रेल. |
FERRY |
फ़ेरी. |
FUNICULAR |
ऐसा वाहन जिसे केबल की मदद से ऊपर की ओर खड़ा किया गया हो. एक फ़्यूनिक्यूलर में आम तौर पर दो कारें होती हैं और हर कार, दूसरी कार के लिए काउंटरवेट के तौर पर काम करती है. |
GONDOLA_LIFT |
हवा में चलने वाली केबल कार. |
HEAVY_RAIL |
भारी रेल. |
HIGH_SPEED_TRAIN |
तेज़ रफ़्तार वाली ट्रेन. |
INTERCITY_BUS |
एक शहर से दूसरे शहर जाने वाली बस. |
LONG_DISTANCE_TRAIN |
लंबी दूरी की ट्रेन. |
METRO_RAIL |
लाइट रेल ट्रांज़िट. |
MONORAIL |
मोनोरेल. |
OTHER |
अन्य सभी वाहन. |
RAIL |
रेल. |
SHARE_TAXI |
शेयर टैक्सी एक ऐसी बस है जो अपने रास्ते में कहीं भी उतर सकती है और यात्रियों को पिक अप कर सकती है. |
SUBWAY |
अंडरग्राउंड लाइट रेल. |
TRAM |
ग्राउंड लाइट रेल के ऊपर. |
TROLLEYBUS |
ट्रॉलीबस. |
RouteLegTravelAdvisory
इसमें ऐसी अतिरिक्त जानकारी शामिल होती है जिसके बारे में उपयोगकर्ता को किसी पैदल यात्रा के दौरान सूचना दी जानी चाहिए. जैसे, ट्रैफ़िक ज़ोन की संभावित पाबंदियां.
जेएसओएन के काेड में दिखाना |
---|
{ "tollInfo": { object ( |
फ़ील्ड | |
---|---|
tollInfo |
इसमें खास |
speedReadingIntervals[] |
ट्रैफ़िक घनत्व का विवरण देने वाले स्पीड रीडिंग अंतराल. उदाहरण:
|
RouteLegLocalizedValues
कुछ प्रॉपर्टी को टेक्स्ट के ज़रिए दिखाएं.
जेएसओएन के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी, टेक्स्ट के रूप में दिखाई गई है. |
duration |
ट्रैफ़िक की शर्तों को ध्यान में रखते हुए, टेक्स्ट के रूप में अवधि को ध्यान में रखते हुए अवधि. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू staticअवधि के बराबर होगी. |
staticDuration |
ट्रैफ़िक की शर्तों को ध्यान में रखे बिना अवधि, जिसे टेक्स्ट के रूप में दिखाया गया है. |
StepsOverview
RouteLegStep
की सूची के बारे में खास जानकारी देता है.
जेएसओएन के काेड में दिखाना |
---|
{
"multiModalSegments": [
{
object ( |
फ़ील्ड | |
---|---|
multiModalSegments[] |
|
MultiModalSegment
RouteLeg.steps
के अलग-अलग मल्टी-मोडल सेगमेंट के बारे में कम शब्दों में जानकारी देता है. मल्टी-मोडल सेगमेंट को एक या उससे ज़्यादा ऐसे RouteLegStep
के तौर पर परिभाषित किया जाता है जिनका RouteTravelMode
एक जैसा होता है. अगर RouteLeg
में कोई मल्टी-मोडल सेगमेंट नहीं है, तो इस फ़ील्ड में जानकारी अपने-आप नहीं भरती.
जेएसओएन के काेड में दिखाना |
---|
{ "navigationInstruction": { object ( |
फ़ील्ड | |
---|---|
navigationInstruction |
मल्टी-मोडल सेगमेंट के लिए नेविगेशन से जुड़ा निर्देश. |
travelMode |
मल्टी-मोडल सेगमेंट का यात्रा मोड. |
stepStartIndex |
इससे जुड़ा |
stepEndIndex |
इससे जुड़ा |
व्यूपोर्ट
अक्षांश-देशांतर व्यूपोर्ट, जिसे low
और high
पॉइंट के सामने दो तिरछे तरीके से दिखाया जाता है. व्यूपोर्ट को बंद क्षेत्र माना जाता है, यानी इसमें इसकी सीमा शामिल है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच होनी चाहिए और देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए. ऐसे कई मामले हैं:
अगर
low
=high
है, तो व्यूपोर्ट में वह एक पॉइंट शामिल होता है.अगर
low.longitude
>high.longitude
है, तो देशांतर की रेंज उलटी होती है (व्यूपोर्ट 180 डिग्री देशांतर की लाइन को पार करता है).अगर
low.longitude
= -180 डिग्री औरhigh.longitude
= 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं.अगर
low.longitude
= 180 डिग्री औरhigh.longitude
= -180 डिग्री है, तो देशांतर की सीमा खाली होगी.अगर
low.latitude
>high.latitude
है, तो अक्षांश की रेंज खाली होती है.
low
और high
, दोनों में जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स खाली नहीं छोड़ा जा सकता (जैसा कि ऊपर दी गई परिभाषाओं में बताया गया है). व्यूपोर्ट खाली रखने से गड़बड़ी होगी.
उदाहरण के लिए, यह व्यूपोर्ट न्यूयॉर्क शहर को पूरी तरह से घेरता है:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
जेएसओएन के काेड में दिखाना |
---|
{ "low": { object ( |
फ़ील्ड | |
---|---|
low |
ज़रूरी है. व्यूपोर्ट का निचला पॉइंट. |
high |
ज़रूरी है. व्यूपोर्ट का हाई पॉइंट. |
RouteLocalizedValues
कुछ प्रॉपर्टी को टेक्स्ट के ज़रिए दिखाएं.
जेएसओएन के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी, टेक्स्ट के रूप में दिखाई गई है. |
duration |
ट्रैफ़िक की शर्तों को ध्यान में रखते हुए, अवधि को टेक्स्ट के रूप में दिखाया गया है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू |
staticDuration |
ट्रैफ़िक की शर्तों को ध्यान में रखे बिना अवधि, जिसे टेक्स्ट के रूप में दिखाया गया है. |
transitFare |
बस, मेट्रो वगैरह का किराया टेक्स्ट फ़ॉर्म में दिखाया गया है. |
GeocodingResults
इसमें शुरुआत की जगह, मंज़िल, और बीच के वेपॉइंट के लिए
शामिल है. सिर्फ़ वेपॉइंट के लिए, अपने-आप जानकारी भरी जाती है.GeocodedWaypoints
जेएसओएन के काेड में दिखाना |
---|
{ "origin": { object ( |
फ़ील्ड | |
---|---|
origin |
ऑरिजिन जियोकोड किया गया वेपॉइंट. |
destination |
डेस्टिनेशन जियोकोड किया गया वेपॉइंट. |
intermediates[] |
जियोकोड किए गए इंटरमीडिएट वेपॉइंट की सूची जिसमें हर एक इंडेक्स फ़ील्ड होता है, जो अनुरोध में बताए गए वेपॉइंट की ज़ीरो-आधारित पोज़िशन से मेल खाता है. |
GeocodedWaypoint
वेपॉइंट के तौर पर इस्तेमाल की गई जगहों के बारे में जानकारी. सिर्फ़ वेपॉइंट के लिए, अपने-आप जानकारी भरी जाती है. इसमें जियोकोडिंग नतीजों के बारे में जानकारी होती है, ताकि यह पता लगाया जा सके कि पता किस पते पर जियोकोड किया गया था.
जेएसओएन के काेड में दिखाना |
---|
{
"geocoderStatus": {
object ( |
फ़ील्ड | |
---|---|
geocoderStatus |
जियोकोडिंग कार्रवाई से शुरू होने वाले स्थिति कोड को दिखाता है. |
type[] |
नतीजे के टाइप, शून्य या उससे ज़्यादा टाइप के टैग के रूप में. इस्तेमाल किए जा सकने वाले टाइप: पते के टाइप और उनके कॉम्पोनेंट टाइप. |
partialMatch |
इससे पता चलता है कि जियोकोडर ने मूल अनुरोध के लिए एक सटीक मिलान नहीं दिया, हालांकि यह अनुरोध किए गए पते के भाग से मेल खा रहा था. गलत स्पेलिंग और/या अधूरे पते के लिए, मूल अनुरोध की जांच की जा सकती है. |
placeId |
इस नतीजे के लिए जगह का आईडी. |
intermediateWaypointRequestIndex |
अनुरोध में शामिल इंटरमीडिएट वेपॉइंट का इंडेक्स. सिर्फ़ तब जानकारी अपने-आप भर जाती है, जब उससे जुड़ा वेपॉइंट, बीच का वेपॉइंट हो. |