- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- रास्ता
- RouteLabel
- RouteLeg
- पॉलीलाइन
- RouteLegStep
- NavigationInstruction
- मैन्युवर
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- व्यूपोर्ट
- RouteLocalizedValues
- PolylineDetails
- FlyoverInfo
- RoadFeatureState
- PolylinePointIndex
- NarrowRoadInfo
- 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 इंटरमीडिएट वेपॉइंट जोड़े जा सकते हैं. |
travel |
ज़रूरी नहीं. यात्रा के साधन के बारे में बताता है. |
routing |
ज़रूरी नहीं. यह बताता है कि रूट का हिसाब कैसे लगाया जाए. सर्वर, रास्ते का हिसाब लगाने के लिए, चुनी गई रूटिंग प्राथमिकता का इस्तेमाल करने की कोशिश करता है. अगर रूटिंग की प्राथमिकता से कोई गड़बड़ी होती है या इंतज़ार का समय बहुत ज़्यादा हो जाता है, तो गड़बड़ी का मैसेज दिखता है. यह विकल्प सिर्फ़ तब तय किया जा सकता है, जब |
polyline |
ज़रूरी नहीं. पॉलीलाइन की क्वालिटी के लिए आपकी प्राथमिकता बताता है. |
polyline |
ज़रूरी नहीं. पॉलीलाइन के लिए पसंदीदा एन्कोडिंग तय करता है. |
departure |
ज़रूरी नहीं. फ़्लाइट के जाने का समय. अगर इस वैल्यू को सेट नहीं किया जाता है, तो यह वैल्यू डिफ़ॉल्ट रूप से उस समय पर सेट हो जाती है जब आपने अनुरोध किया था. ध्यान दें: आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: |
arrival |
ज़रूरी नहीं. पहुंचने का समय. ध्यान दें: यह सेटिंग सिर्फ़ तब सेट की जा सकती है, जब आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: |
compute |
ज़रूरी नहीं. इससे यह तय होता है कि रास्ते के साथ-साथ, वैकल्पिक रास्तों का हिसाब भी लगाया जाए या नहीं. जिन अनुरोधों में बीच में पड़ने वाले रास्ते के विकल्प शामिल होते हैं उनके लिए कोई दूसरा रास्ता नहीं दिखाया जाता. |
route |
ज़रूरी नहीं. ऐसी शर्तों का सेट जो रास्तों का हिसाब लगाने के तरीके पर असर डालती हैं. |
language |
ज़रूरी नहीं. BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, यूनिकोड लोकल आइडेंटिफ़ायर देखें. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, भाषा से जुड़ी सहायता देखें. अगर आपने यह वैल्यू नहीं दी है, तो डिसप्ले भाषा का अनुमान, रास्ते के अनुरोध की जगह से लगाया जाता है. |
region |
ज़रूरी नहीं. क्षेत्र कोड, जो सीसीटीएलडी ("टॉप लेवल डोमेन") के तौर पर दो वर्णों की वैल्यू के तौर पर तय किया गया है. ज़्यादा जानकारी के लिए, देश के कोड के हिसाब से टॉप लेवल डोमेन देखें. |
units |
ज़रूरी नहीं. डिसप्ले फ़ील्ड के लिए, मेज़रमेंट की इकाइयों की जानकारी देता है. इन फ़ील्ड में, |
optimize |
ज़रूरी नहीं. अगर इसकी वैल्यू 'सही है' पर सेट है, तो सेवा, तय किए गए इंटरमीडिएट वेपॉइंट का क्रम बदलकर, रास्ते की कुल लागत को कम करने की कोशिश करती है. अगर किसी भी बीच के रास्ते पर |
requested |
ज़रूरी नहीं. यह बताता है कि डिफ़ॉल्ट रूट के अलावा, अनुरोध के हिस्से के तौर पर किन रेफ़रंस रूट का हिसाब लगाना है. रेफ़रंस रूट, ऐसा रूट होता है जिसे कैलकुलेट करने का मकसद, डिफ़ॉल्ट रूट से अलग होता है. उदाहरण के लिए, |
extra |
ज़रूरी नहीं. अतिरिक्त कैलकुलेशन की सूची, जिसका इस्तेमाल अनुरोध पूरा करने के लिए किया जा सकता है. ध्यान दें: इन अतिरिक्त कैलकुलेशन की वजह से, रिस्पॉन्स में अतिरिक्त फ़ील्ड दिख सकते हैं. इन अतिरिक्त फ़ील्ड को फ़ील्ड मास्क में भी शामिल करना होगा, ताकि उन्हें रिस्पॉन्स में दिखाया जा सके. |
traffic |
ज़रूरी नहीं. ट्रैफ़िक में लगने वाले समय का हिसाब लगाते समय, इस्तेमाल की जाने वाली मान्यताओं के बारे में बताता है. इस सेटिंग का असर, |
transit |
ज़रूरी नहीं. ऐसी प्राथमिकताएं बताता है जिनका असर |
जवाब का मुख्य भाग
v2.computeRoutes, जवाब का मैसेज भेजता है.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "routes": [ { object ( |
फ़ील्ड | |
---|---|
routes[] |
|
fallback |
कुछ मामलों में, जब सर्वर सभी इनपुट प्राथमिकताओं के साथ रास्ते के नतीजों का हिसाब नहीं लगा पाता है, तो हो सकता है कि वह हिसाब लगाने के लिए किसी दूसरे तरीके का इस्तेमाल करे. फ़ॉलबैक मोड का इस्तेमाल करने पर, इस फ़ील्ड में फ़ॉलबैक रिस्पॉन्स के बारे में पूरी जानकारी होती है. अगर ऐसा नहीं है, तो यह फ़ील्ड सेट नहीं किया जाता. |
geocoding |
इसमें पते के तौर पर बताए गए वे रास्ते शामिल होते हैं जिनके लिए जियोकोडिंग का जवाब दिया गया है. |
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 |
ईंधन की कम खपत वाला रास्ता. |
SHORTER_DISTANCE |
यात्रा की कम दूरी वाला रास्ता. इस सुविधा को प्रयोग के तौर पर दिया जा रहा है.
यह सुविधा, यात्रा के किसी दूसरे तरीके, बीच में पड़ने वाले वेपॉइंट या |
ExtraComputation
अनुरोध पूरा करते समय किए जाने वाले अतिरिक्त कैलकुलेशन.
Enums | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
इस्तेमाल नहीं किया जाता. इस वैल्यू वाले अनुरोध पूरे नहीं होंगे. |
TOLLS |
रास्ते के लिए टोल की जानकारी. |
FUEL_CONSUMPTION |
रास्ते के लिए ईंधन की अनुमानित खपत. |
TRAFFIC_ON_POLYLINE |
रास्ते के लिए, ट्रैफ़िक की जानकारी देने वाली पॉलीलाइन. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions को फ़ॉर्मैट की गई एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया जाता है. इस कॉन्टेंट को बिना किसी बदलाव के पढ़ा जाना चाहिए. यह कॉन्टेंट सिर्फ़ दिखाने के लिए है. इसे प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए पार्स न करें. |
FLYOVER_INFO_ON_POLYLINE |
रास्ते के लिए फ़्लायओवर की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.flyover_info फ़ील्डमास्क की जानकारी देना ज़रूरी है. फ़िलहाल, यह डेटा सिर्फ़ भारत के कुछ मेट्रो शहरों के लिए पॉप्युलेट किया जाएगा. यह सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, SKU/शुल्क में बदलाव हो सकता है. |
NARROW_ROAD_INFO_ON_POLYLINE |
रास्ते के लिए सड़क की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.narrow_road_info फ़ील्डमास्क की जानकारी देना ज़रूरी है. फ़िलहाल, यह डेटा सिर्फ़ भारत के कुछ मेट्रो शहरों के लिए पॉप्युलेट किया जाएगा. यह सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, SKU/शुल्क में बदलाव हो सकता है. |
रास्ता
इसमें एक ऐसा रास्ता होता है जिसमें सड़क के कनेक्ट किए गए सेगमेंट की एक सीरीज़ होती है. यह सेगमेंट, शुरुआत, आखिर, और बीच के वेपॉइंट से जुड़े होते हैं.
JSON के काेड में दिखाना |
---|
{ "routeLabels": [ enum ( |
फ़ील्ड | |
---|---|
route |
|
legs[] |
रास्ते का हिस्सा बनाने वाले लेग (वे रास्ते के सेगमेंट होते हैं जो एक वॉयपॉइंट से दूसरे वॉयपॉइंट तक जाते हैं). हर चरण, दो ऐसे स्टेशनों के बीच की यात्रा से जुड़ा होता है जो |
distance |
मीटर में, रास्ते की दूरी. |
duration |
रास्ते पर जाने में लगने वाला समय. अगर सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
static |
ट्रैफ़िक के हाल को ध्यान में रखे बिना, रास्ते से यात्रा में लगने वाला समय. सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
polyline |
पूरे रास्ते की पॉलीलाइन. यह पॉलीलाइन, सभी |
description |
रूट के बारे में जानकारी. |
warnings[] |
रास्ता दिखाते समय दिखने वाली चेतावनियों का ऐरे. |
viewport |
पॉलीलाइन का व्यूपोर्ट बाउंडिंग बॉक्स. |
travel |
रास्ते के बारे में ज़्यादा जानकारी. |
optimized |
|
localized |
|
route |
यह एक ऐसा टोक़न है जिसे नेविगेशन के दौरान रास्ते को फिर से बनाने के लिए, Navigation SDK को पास किया जा सकता है. साथ ही, रास्ते को फिर से बनाने की स्थिति में, रास्ता बनाने के मूल मकसद का सम्मान किया जाता है. इस टोकन को एक ओपेक ब्लॉब के तौर पर इस्तेमाल करें. अलग-अलग अनुरोधों में इसकी वैल्यू की तुलना न करें. ऐसा इसलिए, क्योंकि सेवा का वही रास्ता दिखाने पर भी इसकी वैल्यू बदल सकती है. ध्यान दें: |
polyline |
इसमें पॉलीलाइन के साथ-साथ मौजूद जानकारी की जानकारी होती है. |
RouteLabel
के लिए लेबल, जो किसी रूट की खास प्रॉपर्टी की पहचान करने के लिए काम के होते हैं, ताकि उनकी तुलना दूसरे रूट से की जा सके.Route
Enums | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
डिफ़ॉल्ट - इसका इस्तेमाल नहीं किया जाता. |
DEFAULT_ROUTE |
रूट का हिसाब लगाने के लिए, डिफ़ॉल्ट "सबसे अच्छा" रूट दिखाया जाता है. |
DEFAULT_ROUTE_ALTERNATE |
डिफ़ॉल्ट "सबसे अच्छा" रास्ते का विकल्प. की वैल्यू तय करने पर, इस तरह के रास्ते दिखाए जाएंगे. |
FUEL_EFFICIENT |
ईंधन की कम खपत वाला रास्ता. इस वैल्यू से लेबल किए गए रास्तों को ईको पैरामीटर के लिए ऑप्टिमाइज़ किया जाता है. जैसे, ईंधन की खपत. |
SHORTER_DISTANCE |
यात्रा की कम दूरी वाला रास्ता. इस सुविधा को प्रयोग के तौर पर दिया जा रहा है. |
RouteLeg
इसमें via
के अलावा अन्य वेपॉइंट के बीच का सेगमेंट शामिल है.
JSON के काेड में दिखाना |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
फ़ील्ड | |
---|---|
distance |
रास्ते के हिस्से की दूरी, मीटर में. |
duration |
लेग को नेविगेट करने में लगने वाला समय. अगर सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
static |
यात्रा की कुल अवधि, जिसे ट्रैफ़िक की स्थिति को ध्यान में रखे बिना कैलकुलेट किया जाता है. सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
polyline |
इस लेग की पूरी पॉलीलाइन, जिसमें हर |
start |
इस लेग की शुरुआत की जगह. यह जगह, दी गई |
end |
इस लेग की आखिरी जगह. यह जगह, दी गई |
steps[] |
इस लेग में सेगमेंट दिखाने वाले चरणों की कैटगरी. हर चरण, नेविगेशन से जुड़ा एक निर्देश दिखाता है. |
travel |
इसमें ऐसी अतिरिक्त जानकारी होती है जिसके बारे में उपयोगकर्ता को बताया जाना चाहिए. जैसे, रास्ते के किसी हिस्से पर ट्रैफ़िक ज़ोन से जुड़ी पाबंदियां. |
localized |
|
steps |
इस |
पॉलीलाइन
कोड में बदली गई पॉलीलाइन को एन्कैप्सुलेट करता है.
JSON के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड polyline_type . पॉलीलाइन का टाइप बताता है. डिफ़ॉल्ट रूप से, encoded_polyline पर सेट होता है. polyline_type इनमें से कोई एक हो सकता है: |
|
encoded |
पॉलीलाइन को कोड में बदलने वाले एल्गोरिदम का इस्तेमाल करके, पॉलीलाइन की स्ट्रिंग को कोड में बदलना |
geo |
GeoJSON लाइनस्ट्रिंग फ़ॉर्मैट का इस्तेमाल करके, पॉलीलाइन की जानकारी देता है. |
RouteLegStep
इसमें
का एक सेगमेंट शामिल है. एक चरण, नेविगेशन के एक निर्देश से जुड़ा होता है. रास्ते के चरण, चरणों से बने होते हैं.RouteLeg
JSON के काेड में दिखाना |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
फ़ील्ड | |
---|---|
distance |
इस चरण में तय की गई दूरी, मीटर में. कुछ मामलों में, हो सकता है कि इस फ़ील्ड में कोई वैल्यू न हो. |
static |
ट्रैफ़िक की स्थिति को ध्यान में रखे बिना, इस चरण में यात्रा करने में लगने वाला समय. कुछ मामलों में, हो सकता है कि इस फ़ील्ड में कोई वैल्यू न हो. सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
polyline |
इस चरण से जुड़ी पॉलीलाइन. |
start |
इस चरण की शुरुआत की जगह. |
end |
इस चरण के खत्म होने की जगह. |
navigation |
नेविगेशन के निर्देश. |
travel |
इसमें अतिरिक्त जानकारी होती है, जिसकी जानकारी उपयोगकर्ता को दी जानी चाहिए. जैसे, किसी लेग के चरण में ट्रैफ़िक ज़ोन से जुड़ी संभावित पाबंदियां. |
localized |
|
transit |
अगर यात्रा का मोड |
travel |
इस चरण के लिए इस्तेमाल किया गया यात्रा मोड. |
मैन्युवर
वैल्यू का एक सेट, जो मौजूदा चरण के लिए नेविगेशन ऐक्शन तय करता है. उदाहरण के लिए, बाईं ओर मुड़ें, मर्ज करें या सीधे जाएं.
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 ( |
फ़ील्ड | |
---|---|
speed |
ध्यान दें: फ़िलहाल, इस फ़ील्ड में कोई जानकारी नहीं है. |
RouteLegStepLocalizedValues
कुछ प्रॉपर्टी के टेक्स्ट वर्शन.
JSON के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी, टेक्स्ट फ़ॉर्मैट में दिखाई गई. |
static |
ट्रैफ़िक की स्थिति को ध्यान में रखे बिना, यात्रा में लगने वाला समय. इसे टेक्स्ट फ़ॉर्मैट में दिखाया जाता है. |
RouteLegStepTransitDetails
TRANSIT
रास्तों से जुड़े RouteLegStep
के बारे में ज़्यादा जानकारी.
JSON के काेड में दिखाना |
---|
{ "stopDetails": { object ( |
फ़ील्ड | |
---|---|
stop |
उस चरण के लिए, पहुंचने और वहां से निकलने के स्टॉप की जानकारी. |
localized |
|
headsign |
इस लाइन पर यात्रा की दिशा बताता है. यह दिशा, वाहन पर या स्टॉप से जाने के लिए मार्क की गई होती है. आम तौर पर, यह दिशा टर्मिनस स्टेशन की होती है. |
headway |
इस समय, एक ही स्टॉप से बसों के जाने के बीच के अनुमानित समय को कुल समय के तौर पर दिखाता है. उदाहरण के लिए, अगर हेडवे की वैल्यू 600 सेकंड है, तो बस छूटने पर आपको 10 मिनट इंतज़ार करना पड़ सकता है. सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
transit |
इस चरण में इस्तेमाल की गई बस, मेट्रो वगैरह की लाइन के बारे में जानकारी. |
stop |
बस के सफ़र में पड़ने वाले स्टॉप की संख्या. इस गिनती में, बस के पहुंचने का स्टॉप शामिल होता है, लेकिन बस के जाने का स्टॉप शामिल नहीं होता. उदाहरण के लिए, अगर आपका रूट स्टॉप A से शुरू होकर, स्टॉप B और C से होकर स्टॉप D पर पहुंचता है, तो
3 दिखाता है. |
trip |
यह शेड्यूल और साइन बोर्ड में दिखने वाला टेक्स्ट होता है. इससे यात्रियों को सार्वजनिक परिवहन की यात्रा की पहचान करने में मदद मिलती है. टेक्स्ट से, सेवा के दिन की अवधि में यात्रा की खास तौर पर पहचान होनी चाहिए. उदाहरण के लिए, "538", Amtrak ट्रेन का |
TransitStopDetails
RouteLegStep
के लिए, बस, मेट्रो वगैरह के स्टॉप की जानकारी.
JSON के काेड में दिखाना |
---|
{ "arrivalStop": { object ( |
फ़ील्ड | |
---|---|
arrival |
उस चरण के लिए, पहुंचने वाले स्टॉप की जानकारी. |
arrival |
उस चरण के पूरा होने में लगने वाला अनुमानित समय. आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: |
departure |
उस चरण के लिए, बस या मेट्रो के स्टॉप की जानकारी. |
departure |
चरण के लिए, रवाना होने का अनुमानित समय. आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: |
TransitStop
बस, मेट्रो वगैरह के स्टॉप के बारे में जानकारी.
JSON के काेड में दिखाना |
---|
{
"name": string,
"location": {
object ( |
फ़ील्ड | |
---|---|
name |
बस, मेट्रो वगैरह के स्टॉप का नाम. |
location |
स्टॉप की जगह की जानकारी, अक्षांश/देशांतर निर्देशांक में दी गई हो. |
TransitDetailsLocalizedValues
RouteTransitDetails
के लिए वैल्यू के स्थानीय ब्यौरे.
JSON के काेड में दिखाना |
---|
{ "arrivalTime": { object ( |
फ़ील्ड | |
---|---|
arrival |
समय को फ़ॉर्मैट किए गए टेक्स्ट के तौर पर दिखाया गया है. साथ ही, उसमें टाइम ज़ोन भी शामिल है. |
departure |
समय को फ़ॉर्मैट किए गए टेक्स्ट के तौर पर दिखाया गया है. साथ ही, उसमें टाइम ज़ोन भी शामिल है. |
LocalizedTime
समय की स्थानीय जानकारी.
JSON के काेड में दिखाना |
---|
{
"time": {
object ( |
फ़ील्ड | |
---|---|
time |
किसी टाइम ज़ोन में स्ट्रिंग के तौर पर दिया गया समय. |
time |
इसमें टाइम ज़ोन शामिल होता है. वैल्यू, टाइम ज़ोन का नाम है, जैसा कि आईएएनए टाइम ज़ोन डेटाबेस में बताया गया है. उदाहरण के लिए, "America/New_York". |
TransitLine
इसमें इस चरण में इस्तेमाल की गई बस, मेट्रो वगैरह की लाइन की जानकारी होती है.
JSON के काेड में दिखाना |
---|
{ "agencies": [ { object ( |
फ़ील्ड | |
---|---|
agencies[] |
वह सार्वजनिक परिवहन एजेंसी (या एजेंसियां) जो इस बस, मेट्रो वगैरह की लाइन को चलाती है. |
name |
बस, मेट्रो वगैरह की इस लाइन का पूरा नाम. उदाहरण के लिए, "8 Avenue Local". |
uri |
सार्वजनिक परिवहन एजेंसी की ओर से दी गई, इस बस, मेट्रो वगैरह की लाइन का यूआरआई. |
color |
इस लाइन के साइनेज में आम तौर पर इस्तेमाल किया जाने वाला रंग. हेक्साडेसिमल में दिखाया जाता है. |
icon |
इस लाइन से जुड़े आइकॉन का यूआरआई. |
name |
बस, मेट्रो वगैरह की इस लाइन का छोटा नाम. आम तौर पर, यह नाम कोई लाइन नंबर होता है, जैसे कि "M7" या "355". |
text |
इस लाइन के साइनेज पर टेक्स्ट के लिए आम तौर पर इस्तेमाल किया जाने वाला रंग. हेक्साडेसिमल में दिखाया जाता है. |
vehicle |
इस बस, मेट्रो वगैरह की लाइन पर चलने वाले वाहन का टाइप. |
TransitAgency
सार्वजनिक परिवहन एजेंसी, जो बस, मेट्रो वगैरह की लाइनों को चलाती है.
JSON के काेड में दिखाना |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
फ़ील्ड | |
---|---|
name |
सार्वजनिक परिवहन एजेंसी का नाम. |
phone |
स्थानीय भाषा के हिसाब से फ़ॉर्मैट किया गया, बस, मेट्रो वगैरह चलाने वाली एजेंसी का फ़ोन नंबर. |
uri |
सार्वजनिक परिवहन एजेंसी का यूआरआई. |
TransitVehicle
सार्वजनिक परिवहन के रास्तों पर इस्तेमाल किए जाने वाले वाहन के बारे में जानकारी.
JSON के काेड में दिखाना |
---|
{ "name": { object ( |
फ़ील्ड | |
---|---|
name |
इस वाहन का नाम, कैपिटल लेटर में. |
type |
इस्तेमाल किया गया वाहन किस तरह का है. |
icon |
इस तरह के वाहन से जुड़े आइकॉन का यूआरआई. |
local |
स्थानीय परिवहन के साइनेज के आधार पर, इस तरह के वाहन से जुड़े आइकॉन का यूआरआई. |
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 ( |
फ़ील्ड | |
---|---|
toll |
इसमें किसी खास |
speed |
ट्रैफ़िक की घनत्व की जानकारी देने वाले, स्पीड रीडिंग इंटरवल. यह उदाहरण:
|
RouteLegLocalizedValues
कुछ प्रॉपर्टी के टेक्स्ट वर्शन.
JSON के काेड में दिखाना |
---|
{ "distance": { object ( |
फ़ील्ड | |
---|---|
distance |
यात्रा की दूरी, टेक्स्ट फ़ॉर्मैट में दिखाई गई. |
duration |
अवधि, जिसे टेक्स्ट फ़ॉर्म में दिखाया जाता है और जिसे क्वेरी के इलाके के हिसाब से स्थानीय भाषा में दिखाया जाता है. ट्रैफ़िक के हाल को ध्यान में रखता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू, staticDuration की वैल्यू जैसी ही होगी. |
static |
ट्रैफ़िक की स्थिति को ध्यान में रखे बिना यात्रा में लगने वाला समय, टेक्स्ट फ़ॉर्मैट में दिखाया जाता है. |
StepsOverview
RouteLegStep
की सूची के बारे में खास जानकारी देता है.
JSON के काेड में दिखाना |
---|
{
"multiModalSegments": [
{
object ( |
फ़ील्ड | |
---|---|
multi |
|
MultiModalSegment
RouteLeg.steps
के अलग-अलग मल्टी-मोडल सेगमेंट के बारे में खास जानकारी देता है. मल्टी-मोडल सेगमेंट को एक या एक से ज़्यादा आस-पास मौजूद RouteLegStep
के तौर पर परिभाषित किया जाता है, जिनका RouteTravelMode
एक ही होता है. अगर RouteLeg
में चरणों में कोई मल्टी-मोडल सेगमेंट नहीं है, तो इस फ़ील्ड में अपने-आप जानकारी नहीं भरती.
JSON के काेड में दिखाना |
---|
{ "navigationInstruction": { object ( |
फ़ील्ड | |
---|---|
navigation |
एक से ज़्यादा मोड वाले सेगमेंट के लिए NavigationInstruction. |
travel |
मल्टी-मोडल सेगमेंट के लिए यात्रा का मोड. |
step |
मल्टी-मोडल सेगमेंट की शुरुआत वाला |
step |
मिलते-जुलते |
व्यूपोर्ट
अक्षांश-देशांतर व्यूपोर्ट, जिसे डायगनल के दो विपरीत 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 |
अवधि, जिसे टेक्स्ट फ़ॉर्म में दिखाया जाता है और जिसे क्वेरी के इलाके के हिसाब से स्थानीय भाषा में दिखाया जाता है. ट्रैफ़िक के हाल को ध्यान में रखता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू |
static |
ट्रैफ़िक की स्थिति को ध्यान में रखे बिना यात्रा में लगने वाला समय, टेक्स्ट फ़ॉर्मैट में दिखाया जाता है. |
transit |
बस, मेट्रो वगैरह का किराया, टेक्स्ट फ़ॉर्मैट में दिखाया गया. |
PolylineDetails
किसी इंडेक्स या पॉलीलाइन के आस-पास के सेगमेंट से जुड़ी जानकारी. P_0, P_1, ... , P_N (शून्य पर आधारित इंडेक्स) पॉइंट वाली पॉलीलाइन के लिए, PolylineDetails
एक इंटरवल और उससे जुड़े मेटाडेटा की जानकारी देता है.
JSON के काेड में दिखाना |
---|
{ "flyoverInfo": [ { object ( |
फ़ील्ड | |
---|---|
flyover |
पॉलीलाइन के साथ फ़्लायओवर की जानकारी. |
narrow |
पॉलीलाइन के साथ सड़क की जानकारी. |
FlyoverInfo
पॉलीलाइन के साथ-साथ फ़्लायोवर की जानकारी शामिल करता है.
JSON के काेड में दिखाना |
---|
{ "flyoverPresence": enum ( |
फ़ील्ड | |
---|---|
flyover |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए फ़्लायओवर मौजूद है या नहीं. |
polyline |
पॉलीलाइन के साथ फ़्लायओवर से जुड़ी जानकारी की जगह. |
RoadFeatureState
पॉलीलाइन के स्ट्रेच पर सड़क की सुविधाओं की स्थितियों को शामिल करता है.
Enums | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
सड़क की स्थिति का हिसाब नहीं लगाया गया था (डिफ़ॉल्ट वैल्यू). |
EXISTS |
सड़क की जानकारी मौजूद हो. |
DOES_NOT_EXIST |
सड़क की सुविधा मौजूद नहीं है. |
PolylinePointIndex
पॉलीलाइन की जानकारी के लिए, शुरू और खत्म होने के इंडेक्स को शामिल करता है. जिन मामलों में डेटा एक पॉइंट से जुड़ा होता है उनमें startIndex
और endIndex
बराबर होंगे.
JSON के काेड में दिखाना |
---|
{ "startIndex": integer, "endIndex": integer } |
फ़ील्ड | |
---|---|
start |
पॉलीलाइन में इस जानकारी का शुरुआती इंडेक्स. |
end |
पॉलीलाइन में इस जानकारी का आखिरी इंडेक्स. |
NarrowRoadInfo
पॉलीलाइन के साथ-साथ, सड़क की चौड़ाई के बारे में जानकारी देता है.
JSON के काेड में दिखाना |
---|
{ "narrowRoadPresence": enum ( |
फ़ील्ड | |
---|---|
narrow |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पॉलीलाइन के किसी हिस्से में सड़क की चौड़ाई कम है या नहीं. |
polyline |
पॉलीलाइन के साथ, सकरी सड़क से जुड़ी जानकारी की जगह. |
GeocodingResults
इसमें ऑरिजिन, डेस्टिनेशन, और रास्ते में रुकने के लिए जगहों के लिए
शामिल है. सिर्फ़ पते के वे पॉइंट जिन पर रुकना है उनके लिए जानकारी अपने-आप भर जाती है.GeocodedWaypoints
JSON के काेड में दिखाना |
---|
{ "origin": { object ( |
फ़ील्ड | |
---|---|
origin |
ऑरिजिन का जियोकोड किया गया वेपॉइंट. |
destination |
मंज़िल के लिए जियोकोड किया गया रास्ते में रुकने का पॉइंट. |
intermediates[] |
बीच में मौजूद, जियोकोड किए गए वे रास्ते जिनमें हर एक में एक इंडेक्स फ़ील्ड होता है. यह फ़ील्ड, अनुरोध में बताए गए क्रम में वे रास्ते की शून्य-आधारित पोज़िशन से जुड़ा होता है. |
GeocodedWaypoint
वे पॉइंट जिनका इस्तेमाल वॉइसओवर के लिए किया गया है. सिर्फ़ पते के वे पॉइंट जिन पर रुकना है उनके लिए जानकारी अपने-आप भर जाती है. इसमें, पते को किस जगह के हिसाब से जियोकोड किया गया है, यह पता लगाने के लिए जियोकोडिंग के नतीजों की जानकारी शामिल होती है.
JSON के काेड में दिखाना |
---|
{
"geocoderStatus": {
object ( |
फ़ील्ड | |
---|---|
geocoder |
यह जियोकोडिंग की प्रोसेस के बाद दिखने वाला स्टेटस कोड दिखाता है. |
type[] |
नतीजे का टाइप, शून्य या एक से ज़्यादा टाइप टैग के तौर पर. इस्तेमाल किए जा सकने वाले टाइप: पते के टाइप और पते के कॉम्पोनेंट के टाइप. |
partial |
इससे पता चलता है कि जियोकोडर ने मूल अनुरोध के लिए, एग्ज़ैक्ट मैच नहीं दिया. हालांकि, वह अनुरोध किए गए पते के कुछ हिस्से से मैच कर पाया. आपके पास, मूल अनुरोध की जांच करने का विकल्प है. इससे आपको पता चलेगा कि उसमें वर्तनी की गड़बड़ियां हैं या/और पता अधूरा है. |
place |
इस नतीजे का प्लेस आईडी. |
intermediate |
अनुरोध में मौजूद उस इंटरमीडिएट वेपॉइंट का इंडेक्स. यह सिर्फ़ तब पॉप्युलेट होता है, जब उससे जुड़ा वेपॉइंट, बीच का वेपॉइंट हो. |