- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- रास्ता
- RouteLabel
- RouteLeg
- Polyline
- 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 ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{ "origin": { object ( |
फ़ील्ड | |
---|---|
origin |
ज़रूरी है. ऑरिजिन वेपॉइंट. |
destination |
ज़रूरी है. डेस्टिनेशन वेपॉइंट. |
intermediates[] |
ज़रूरी नहीं. रास्ते पर पड़ने वाले पॉइंट का एक सेट (टर्मिनल पॉइंट को छोड़कर), जो किसी जगह पर रुकने या वहां से गुजरने के लिए इस्तेमाल किया जाता है. इंटरमीडिएट में ज़्यादा से ज़्यादा 25 वेपॉइंट डाले जा सकते हैं. |
travelMode |
ज़रूरी नहीं. परिवहन का साधन बताता है. |
routingPreference |
ज़रूरी नहीं. रूट कंप्यूट करने का तरीका बताता है. रूट की गणना करने के लिए सर्वर, चुनी गई रूटिंग प्राथमिकता के इस्तेमाल की कोशिश करता है. अगर रूटिंग प्राथमिकता के कारण कोई गड़बड़ी होती है या अतिरिक्त लंबी प्रतीक्षा अवधि होती है, तो एक गड़बड़ी वापस मिलती है. इस विकल्प को सिर्फ़ तब तय किया जा सकता है, जब |
polylineQuality |
ज़रूरी नहीं. यह पॉलीलाइन की क्वालिटी के लिए आपकी प्राथमिकता बताता है. |
polylineEncoding |
ज़रूरी नहीं. पॉलीलाइन के लिए पसंदीदा एन्कोडिंग तय करता है. |
departureTime |
ज़रूरी नहीं. रवानगी का समय. अगर यह वैल्यू सेट नहीं की जाती है, तो यह वैल्यू आपके अनुरोध के समय पर डिफ़ॉल्ट रूप से सेट हो जाती है. ध्यान दें: जब आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
arrivalTime |
ज़रूरी नहीं. पहुंचने का समय. ध्यान दें: इसे सिर्फ़ तब सेट किया जा सकता है, जब आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
computeAlternativeRoutes |
ज़रूरी नहीं. तय करता है कि रूट के अलावा वैकल्पिक रास्तों की गणना करनी है या नहीं. इंटरमीडिएट वेपॉइंट वाले अनुरोधों के लिए कोई दूसरा रास्ता नहीं दिखाया जाता. |
routeModifiers |
ज़रूरी नहीं. शर्तों का एक सेट, जो रास्ते की गणना के तरीके को प्रभावित करती है. |
languageCode |
ज़रूरी नहीं. BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn" के रूप में जाना जाता है. ज़्यादा जानकारी के लिए, यूनिकोड स्थान-भाषा आइडेंटिफ़ायर देखें. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, भाषा की सुविधा पर जाएं. यह वैल्यू न देने पर, डिसप्ले की भाषा का अनुमान, रास्ते के अनुरोध की जगह के आधार पर लगाया जाता है. |
regionCode |
ज़रूरी नहीं. क्षेत्र का कोड, जिसे ccTLD ("टॉप लेवल डोमेन") दो वर्णों की वैल्यू के तौर पर दिया गया है. ज़्यादा जानकारी के लिए देश कोड के टॉप लेवल डोमेन देखें. |
units |
ज़रूरी नहीं. डिसप्ले फ़ील्ड के लिए माप की इकाइयां बताता है. इन फ़ील्ड में |
optimizeWaypointOrder |
ज़रूरी नहीं. अगर इसे 'सही है' पर सेट किया जाता है, तो सेवा बताए गए इंटरमीडिएट वेपॉइंट को फिर से क्रम में लगाकर, रूट की कुल लागत को कम करने की कोशिश करती है. अगर कोई भी इंटरमीडिएट वेपॉइंट एक |
requestedReferenceRoutes[] |
ज़रूरी नहीं. इससे पता चलता है कि अनुरोध के तहत, डिफ़ॉल्ट रूट के अलावा किन रेफ़रंस रूट का हिसाब लगाया जाना चाहिए. रेफ़रंस रूट, ऐसा रूट होता है जिसका लक्ष्य, डिफ़ॉल्ट रूट से अलग होता है. उदाहरण के लिए, |
extraComputations[] |
ज़रूरी नहीं. अतिरिक्त कंप्यूटेशन की सूची, जिसका इस्तेमाल अनुरोध को पूरा करने के लिए किया जा सकता है. ध्यान दें: ये अतिरिक्त कंप्यूटेशन, रिस्पॉन्स में अतिरिक्त फ़ील्ड दिखा सकते हैं. रिस्पॉन्स में दिखाए जाने के लिए, इन अतिरिक्त फ़ील्ड को फ़ील्ड मास्क में भी बताना ज़रूरी है. |
trafficModel |
ज़रूरी नहीं. ट्रैफ़िक में समय की गणना करते समय उपयोग किए जाने वाले अनुमान तय करता है. यह सेटिंग, |
transitPreferences |
ज़रूरी नहीं. |
जवाब का मुख्य भाग
जवाब देने वाले मैसेज को v2.computeRoutes पर दे सकता है.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "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 को फ़ॉर्मैट किए गए एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया जाता है. इस कॉन्टेंट को उसी तरह पढ़ा जाना चाहिए. यह कॉन्टेंट सिर्फ़ दिखाने के लिए है. इसे प्रोग्राम के हिसाब से पार्स न करें. |
रास्ता
इसमें एक रास्ता होता है. इसमें सड़क के कई सेगमेंट होते हैं जो शुरू, खत्म होने, और बीच के वेपॉइंट को जोड़ते हैं.
JSON के काेड में दिखाना |
---|
{ "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
वेपॉइंट के बीच का एक सेगमेंट शामिल है.
JSON के काेड में दिखाना |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
फ़ील्ड | |
---|---|
distanceMeters |
रास्ते में पड़ने वाली दूरी, मीटर में. |
duration |
पैर को नेविगेट करने में लगने वाला समय. अगर सेकंड में कुल नौ दशमलव अंक, जो ' |
staticDuration |
ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना, पैर के सफ़र में लगने वाला कुल समय. सेकंड में कुल नौ दशमलव अंक, जो ' |
polyline |
इस पैर के लिए पूरी पॉलीलाइन, जिसमें हर |
startLocation |
इस पैर के शुरू होने की जगह. यह जगह, दी गई |
endLocation |
इस पैर के अंत का स्थान. यह जगह, दी गई |
steps[] |
इस हिस्से के अलग-अलग हिस्सों को दिखाने वाले चरणों का कलेक्शन. हर चरण में एक नेविगेशन निर्देश दिखता है. |
travelAdvisory |
इसमें वह अतिरिक्त जानकारी होती है जिसके बारे में उपयोगकर्ता को जानकारी होनी चाहिए. जैसे, रूट लेग पर संभावित ट्रैफ़िक ज़ोन से जुड़ी पाबंदियां. |
localizedValues |
|
stepsOverview |
इस |
पॉलीलाइन
कोड में बदली गई पॉलीलाइन को इनकैप्सुलेट करता है.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड polyline_type . पॉलीलाइन के टाइप को इनकैप्सुलेट करता है. डिफ़ॉल्ट तौर पर, encoded_polyline काम करने लगता है. polyline_type इनमें से सिर्फ़ एक हो सकता है: |
|
encodedPolyline |
पॉलीलाइन एन्कोडिंग एल्गोरिदम का इस्तेमाल करके, पॉलीलाइन की स्ट्रिंग एन्कोडिंग |
geoJsonLinestring |
GeoJSON LineString फ़ॉर्मैट का इस्तेमाल करके पॉलीलाइन तय करता है. |
RouteLegStep
इसमें
का एक सेगमेंट शामिल है. कोई चरण, एक नेविगेशन निर्देश से जुड़ा होता है. रास्ते में बनी लेग, सीढ़ियों से बनी हैं.RouteLeg
JSON के काेड में दिखाना |
---|
{ "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
इसमें वह अतिरिक्त जानकारी शामिल होती है जिसके बारे में उपयोगकर्ता को जानकारी दी जानी चाहिए. जैसे, किसी लेग स्टेप पर संभावित ट्रैफ़िक ज़ोन से जुड़ी पाबंदियां.
JSON के काेड में दिखाना |
---|
{
"speedReadingIntervals": [
{
object ( |
फ़ील्ड | |
---|---|
speedReadingIntervals[] |
ध्यान दें: यह फ़ील्ड अभी अपने-आप नहीं भरा गया है. |
RouteLegStepLocalizedValues
कुछ प्रॉपर्टी को टेक्स्ट में दिखाना.
JSON के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी की जानकारी टेक्स्ट के तौर पर दी गई है. |
staticDuration |
ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना कुल समय, जिसे टेक्स्ट के तौर पर दिखाया गया है. |
RouteLegStepTransitDetails
TRANSIT
रास्तों से जुड़े RouteLegStep
के लिए ज़्यादा जानकारी.
JSON के काेड में दिखाना |
---|
{ "stopDetails": { object ( |
फ़ील्ड | |
---|---|
stopDetails |
इस चरण में आने और जाने के स्टॉप की जानकारी. |
localizedValues |
|
headsign |
वाहन पर या जाने के स्टॉप पर इस लाइन पर यात्रा की दिशा बताता है. अक्सर टर्मिनस स्टेशन की दिशा होती है. |
headway |
इस समय उसी स्टॉप से जाने वाली फ़्लाइट के बीच के अनुमानित समय को तय करता है. उदाहरण के लिए, अगर हेडवे सेकंड की वैल्यू 600 है, तो अगर आपकी बस छूट जाती है, तो आपको दस मिनट इंतज़ार करना होगा. सेकंड में कुल नौ दशमलव अंक, जो ' |
transitLine |
इस चरण में इस्तेमाल की गई बस, मेट्रो वगैरह के रूट की जानकारी. |
stopCount |
फ़्लाइट की रवानगी से लेकर आने तक के स्टॉप की संख्या. इस गिनती में आने के स्टॉप शामिल हैं, लेकिन इसमें जाने के स्टॉप शामिल नहीं हैं. उदाहरण के लिए, अगर आपका रास्ता स्टॉप A से जाता है, स्टॉप B और C से गुजरता है और स्टॉप D पर आता है, तो स्टॉपवॉच 3 देगी. |
tripShortText |
शेड्यूल और साइन बोर्ड में दिखने वाला टेक्स्ट, जिससे यात्रियों के लिए बस, मेट्रो वगैरह की यात्रा के बारे में पता चलता है. टेक्स्ट को सेवा के दिन में यात्रा की खास तौर पर पहचान करनी चाहिए. उदाहरण के लिए, "538" ट्रेन की |
TransitStopDetails
RouteLegStep
के ट्रांज़िट स्टॉप के बारे में जानकारी.
JSON के काेड में दिखाना |
---|
{ "arrivalStop": { object ( |
फ़ील्ड | |
---|---|
arrivalStop |
कदम के लिए पहुंचने के स्टॉप के बारे में जानकारी. |
arrivalTime |
कदम के पहुंचने का अनुमानित समय. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
departureStop |
कदम के लिए रवाना होने वाले स्टॉप के बारे में जानकारी. |
departureTime |
कदम के लिए निकलने का अनुमानित समय. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
TransitStop
किसी ट्रांज़िट स्टॉप के बारे में जानकारी.
JSON के काेड में दिखाना |
---|
{
"name": string,
"location": {
object ( |
फ़ील्ड | |
---|---|
name |
ट्रांज़िट स्टॉप का नाम. |
location |
अक्षांश/देशांतर निर्देशांक में, स्टॉप की जगह की जानकारी. |
TransitDetailsLocalizedValues
RouteTransitDetails
की वैल्यू का स्थानीय भाषा में ब्यौरा.
JSON के काेड में दिखाना |
---|
{ "arrivalTime": { object ( |
फ़ील्ड | |
---|---|
arrivalTime |
फ़ॉर्मैट किए गए टेक्स्ट में समय को संबंधित टाइम ज़ोन के साथ दिखाएं. |
departureTime |
फ़ॉर्मैट किए गए टेक्स्ट में समय को संबंधित टाइम ज़ोन के साथ दिखाएं. |
LocalizedTime
समय का स्थानीय भाषा में लिखा हुआ विवरण.
JSON के काेड में दिखाना |
---|
{
"time": {
object ( |
फ़ील्ड | |
---|---|
time |
किसी दिए गए टाइम ज़ोन में स्ट्रिंग के तौर पर दिया गया समय. |
timeZone |
इसमें टाइम ज़ोन होता है. वैल्यू, टाइम ज़ोन का नाम है, जैसा कि IANA टाइम ज़ोन डेटाबेस में बताया गया है, जैसे कि "अमेरिका/New_York". |
TransitLine
इसमें इस चरण में इस्तेमाल की गई बस, मेट्रो वगैरह के रूट के बारे में जानकारी होती है.
JSON के काेड में दिखाना |
---|
{ "agencies": [ { object ( |
फ़ील्ड | |
---|---|
agencies[] |
इस ट्रांज़िट लाइन को चलाने वाली ट्रांसपोर्ट एजेंसी या एजेंसियां. |
name |
इस ट्रांज़िट लाइन का पूरा नाम, जैसे कि "8 Avenue Local". |
uri |
इस ट्रांज़िट लाइन का यूआरआई, जैसा कि ट्रांसपोर्ट एजेंसी ने उपलब्ध कराया है. |
color |
इस लाइन के साइनेज में आम तौर पर इस्तेमाल होने वाला रंग. हेक्साडेसिमल में दिखाया जाता है. |
iconUri |
इस लाइन से जुड़े आइकॉन का यूआरआई. |
nameShort |
इस ट्रांज़िट लाइन का छोटा नाम. आम तौर पर, यह नाम कोई लाइन नंबर होगा, जैसे कि "M7" या "355" है. |
textColor |
इस लाइन के साइनेज के टेक्स्ट में, आम तौर पर इस्तेमाल होने वाला रंग. हेक्साडेसिमल में दिखाया जाता है. |
vehicle |
इस ट्रांज़िट लाइन पर चलने वाले वाहन का टाइप. |
TransitAgency
सार्वजनिक परिवहन एजेंसी, जो बस, मेट्रो वगैरह के रूट का इस्तेमाल करती है.
JSON के काेड में दिखाना |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
फ़ील्ड | |
---|---|
name |
इस सार्वजनिक परिवहन एजेंसी का नाम. |
phoneNumber |
सार्वजनिक परिवहन एजेंसी का स्थान-भाषा के हिसाब से फ़ॉर्मैट किया गया फ़ोन नंबर. |
uri |
सार्वजनिक परिवहन एजेंसी का यूआरआई. |
TransitVehicle
सार्वजनिक परिवहन के रास्तों में इस्तेमाल होने वाले वाहन की जानकारी.
JSON के काेड में दिखाना |
---|
{ "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
इसमें वह अतिरिक्त जानकारी होती है जिसके बारे में उपयोगकर्ता को किसी चरण के दौरान सूचित किया जाना चाहिए, जैसे कि संभावित ट्रैफ़िक ज़ोन से जुड़ी पाबंदियां.
JSON के काेड में दिखाना |
---|
{ "tollInfo": { object ( |
फ़ील्ड | |
---|---|
tollInfo |
इसमें, किसी खास |
speedReadingIntervals[] |
ट्रैफ़िक डेंसिटी की जानकारी देने वाले स्पीड रीडिंग के इंटरवल. यह उदाहरण:
|
RouteLegLocalizedValues
कुछ प्रॉपर्टी को टेक्स्ट में दिखाना.
JSON के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी की जानकारी टेक्स्ट के तौर पर दी गई है. |
duration |
ट्रैफ़िक की स्थितियों को ध्यान में रखते हुए, टेक्स्ट के तौर पर दिखाया गया समय. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी के लिए अनुरोध नहीं किया है, तो यह वैल्यू staticDuration के जैसी ही होगी. |
staticDuration |
ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना कुल समय, जिसे टेक्स्ट के तौर पर दिखाया गया है. |
StepsOverview
यहां RouteLegStep
की सूची के बारे में खास जानकारी दी जाती है.
JSON के काेड में दिखाना |
---|
{
"multiModalSegments": [
{
object ( |
फ़ील्ड | |
---|---|
multiModalSegments[] |
|
MultiModalSegment
इससे RouteLeg.steps
के अलग-अलग मल्टी-मॉडल सेगमेंट के बारे में खास जानकारी मिलती है. मल्टी-मॉडल सेगमेंट को एक या उससे जुड़े ऐसे RouteLegStep
के तौर पर तय किया जाता है जो एक जैसे RouteTravelMode
होते हैं. अगर इस तरीके में बताए गए RouteLeg
में कोई मल्टी-मॉडल सेगमेंट नहीं है, तो इस फ़ील्ड में अपने-आप जानकारी नहीं भरती.
JSON के काेड में दिखाना |
---|
{ "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 } }
JSON के काेड में दिखाना |
---|
{ "low": { object ( |
फ़ील्ड | |
---|---|
low |
ज़रूरी है. व्यूपोर्ट का निचला पॉइंट. |
high |
ज़रूरी है. व्यूपोर्ट का सबसे ऊपरी पॉइंट. |
RouteLocalizedValues
कुछ प्रॉपर्टी को टेक्स्ट में दिखाना.
JSON के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी की जानकारी टेक्स्ट के तौर पर दी गई है. |
duration |
ट्रैफ़िक की स्थितियों को ध्यान में रखते हुए, कुल समय को टेक्स्ट के तौर पर दिखाया जाता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू |
staticDuration |
ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना कुल समय, जिसे टेक्स्ट के तौर पर दिखाया गया है. |
transitFare |
बस, मेट्रो वगैरह का किराया, टेक्स्ट फ़ॉर्मैट में दिखाया जाता है. |
GeocodingResults
इसमें ऑरिजिन, डेस्टिनेशन, और इंटरमीडिएट वेपॉइंट के लिए
शामिल होता है. सिर्फ़ अड्रेस वेपॉइंट के लिए जानकारी अपने-आप भर जाती है.GeocodedWaypoints
JSON के काेड में दिखाना |
---|
{ "origin": { object ( |
फ़ील्ड | |
---|---|
origin |
ऑरिजिन जियोकोड किया गया वेपॉइंट. |
destination |
डेस्टिनेशन जियोकोड किया गया वेपॉइंट. |
intermediates[] |
इंटरमीडिएट जियोकोड किए गए वेपॉइंट की सूची जिसमें हर एक इंडेक्स फ़ील्ड होता है जो अनुरोध में बताए गए क्रम में वेपॉइंट की शून्य-आधारित स्थिति से मेल खाता है. |
GeocodedWaypoint
वेपॉइंट के तौर पर इस्तेमाल की जाने वाली जगहों के बारे में जानकारी. सिर्फ़ अड्रेस वेपॉइंट के लिए जानकारी अपने-आप भर जाती है. इसमें जियोकोडिंग नतीजों के बारे में जानकारी शामिल होती है, ताकि यह तय किया जा सके कि पता किस पते पर जियोकोड किया गया था.
JSON के काेड में दिखाना |
---|
{
"geocoderStatus": {
object ( |
फ़ील्ड | |
---|---|
geocoderStatus |
जियोकोडिंग कार्रवाई के नतीजे वाले स्थिति कोड को दिखाता है. |
type[] |
नतीजे के टाइप, शून्य या उससे ज़्यादा टाइप वाले टैग के तौर पर. काम करने वाले टाइप: पते के टाइप और पते के कॉम्पोनेंट के टाइप. |
partialMatch |
इससे पता चलता है कि जियोकोडर ने मूल अनुरोध के लिए एग्ज़ैक्ट मैच नहीं दिया. हालांकि, वह अनुरोध किए गए पते के हिस्से को मैच कर सका था. हो सकता है कि आप गलत स्पेलिंग और/या अधूरे पते के लिए मूल अनुरोध की जांच करना चाहें. |
placeId |
इस नतीजे के लिए जगह का आईडी. |
intermediateWaypointRequestIndex |
अनुरोध में संबंधित इंटरमीडिएट वेपॉइंट का इंडेक्स. जानकारी सिर्फ़ तब अपने-आप भर जाती है, जब इससे जुड़ा वेपॉइंट एक इंटरमीडिएट वेपॉइंट हो. |