जब Routes API किसी रूट का हिसाब लगाता है, तो वह वेपॉइंट लेता है और कॉन्फ़िगरेशन पैरामीटर का इस्तेमाल करें जिन्हें आपने इनपुट के तौर पर दिया है. इसके बाद, एपीआई जवाब दिखाता है जिसमें डिफ़ॉल्ट रास्ता और एक या एक से ज़्यादा वैकल्पिक रास्ते होते हैं.
आपके जवाब में फ़ील्ड, जिनका आप अनुरोध करते हैं:
इसे जवाब में शामिल करने के लिए | यह दस्तावेज़ देखें |
---|---|
वाहन के इंजन टाइप के हिसाब से, ईंधन या ऊर्जा की सबसे ज़्यादा बचत वाला रास्ता. | ईको-फ़्रेंडली रास्ते बनाने का तरीका कॉन्फ़िगर करना |
ज़्यादा से ज़्यादा तीन वैकल्पिक रास्ते | दूसरे रास्तों के लिए अनुरोध करना |
पूरे रास्ते, रास्ते के हर पैर के लिए, और हर कदम के लिए पॉलीलाइन एक पैर से. | रूट पॉलीलाइन के लिए अनुरोध करें |
टोल की अनुमानित कीमत, जो टोल की कीमत पर मिलने वाली छूट को ध्यान में रखती है ड्राइवर या वाहन के पास मौजूद पास. | टोल शुल्क का हिसाब लगाना |
भाषा कोड और मेज़रमेंट यूनिट के हिसाब से स्थानीय जगह के अनुसार जवाब (इंपीरियल या मेट्रिक). | स्थानीय भाषा के मुताबिक वैल्यू का अनुरोध करना |
नेविगेशन निर्देशों को एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर फ़ॉर्मैट करने के लिए, HTML_FORMATTED_NAVIGATION_INSTRUCTIONS को इसमें जोड़ें
extraComputations . |
अतिरिक्त कंप्यूटेशन |
इनपुट के विकल्पों की पूरी सूची देखने के लिए, रास्ते के उपलब्ध विकल्प देखें और अनुरोध का मुख्य हिस्सा.
जवाब का इस्तेमाल करके, अपने ग्राहकों को उनकी जानकारी दी जा सकती है अपनी ज़रूरतों के मुताबिक सही रास्ता चुनना ज़रूरी है.
फ़ील्ड मास्क के बारे में जानकारी
रूट की गणना करने के लिए किसी तरीके को कॉल करते समय, आपको एक फ़ील्ड बताना होगा मास्क जो तय करता है कि आपको रिस्पॉन्स में कौनसे फ़ील्ड लौटाने हैं. कोई नहीं लौटाए गए फ़ील्ड की डिफ़ॉल्ट सूची. अगर इस सूची को छोड़ दिया जाता है, तो यह तरीका नतीजे के तौर पर गड़बड़ी.
इस दस्तावेज़ के उदाहरणों में, बिना जवाब के जवाब के लिए दिया गया ऑब्जेक्ट दिखाया गया है ध्यान दें. प्रोडक्शन एनवायरमेंट में, आपका जवाब सिर्फ़ वे फ़ील्ड शामिल करें जिन्हें आपने फ़ील्ड मास्क में साफ़ तौर पर बताया है.
ज़्यादा जानकारी के लिए, चुनें कि कौनसी जानकारी दी जाए.
कॉपीराइट दिखाने के बारे में जानकारी
अपने उपयोगकर्ताओं को नतीजे दिखाते समय आपको यह कॉपीराइट स्टेटमेंट ज़रूर शामिल करना होगा:
Powered by Google, ©YEAR Google
उदाहरण के लिए:
Powered by Google, ©2023 Google
रास्तों, पैरों, और कदमों के बारे में जानकारी
रूट एपीआई से मिले जवाब को देखने से पहले, आपको को रूट बनाने वाले कॉम्पोनेंट की समझ होनी चाहिए:
आपके जवाब में इन रूट के हर कॉम्पोनेंट के बारे में जानकारी हो सकती है:
रास्ता: शुरुआत के वेपॉइंट से लेकर किसी भी सड़क से होकर जाने वाली पूरी यात्रा गंतव्य वेपॉइंट तक, इंटरमीडिएट वेपॉइंट. एक रास्ता है या ज़्यादा पैर.
लेग: किसी रूट में एक वेपॉइंट से अगले वेपॉइंट तक का रास्ता रूट हर पैर में एक या उससे ज़्यादा अलग-अलग कदम होते हैं.
एक रास्ते में हर वेपॉइंट से अगले तक के रास्ते के लिए एक अलग पैर होता है. उदाहरण के लिए, अगर रास्ते में एक ही ऑरिजिन वेपॉइंट और एक सिंगल ऑरिजिन वेपॉइंट है गंतव्य वेपॉइंट, तो मार्ग में एक ही पैर होता है. हर एक के लिए इसके अलावा, शुरुआत की जगह और मंज़िल के बाद, रूट में आपके जोड़े गए अतिरिक्त वेपॉइंट, इसे इंटरमीडिएट वेपॉइंट कहते हैं, तो एपीआई एक अलग पैर जोड़ता है.
एपीआई पास-थ्रू इंटरमीडिएट वेपॉइंट के लिए कोई चरण नहीं जोड़ता. इसके लिए उदाहरण के लिए, ऐसा रूट जिसमें ऑरिजिन वेपॉइंट, पास-थ्रू शामिल हो. मध्यवर्ती वेपॉइंट, और गंतव्य वेपॉइंट वेपॉइंट से गुज़रते समय गंतव्य तक पहुंचने का रास्ता. ज़्यादा के लिए पास-थ्रू वेपॉइंट के बारे में जानकारी, देखें पास-थ्रू वेपॉइंट तय करें.
चरण: किसी रास्ते पर चलने के लिए एक निर्देश. कोई कदम किसी रूट की ऐटॉमिक यूनिट. उदाहरण के लिए, किसी चरण में यह दिखाया जा सकता है कि "मुख्य विंडो चालू करो" सड़क''.
जवाब में क्या जानकारी मौजूद है
JSON ऑब्जेक्ट एपीआई से मिले रिस्पॉन्स में, ये टॉप-लेवल प्रॉपर्टी शामिल होती हैं:
routes
, एलिमेंट के टाइप का कलेक्शन रास्ता.routes
कलेक्शन में, एपीआई से मिले हर रूट के लिए एक एलिमेंट होता है. इस अरे में ज़्यादा से ज़्यादा पांच एलिमेंट शामिल हो सकते हैं: डिफ़ॉल्ट रूट, और तीन वैकल्पिक रास्ते शामिल किए जा सकते हैं.geocodingResults
, एलिमेंट के टाइप का कलेक्शन GeocodingResults. अनुरोध में शामिल हर जगह के लिए (शुरुआत की जगह, डेस्टिनेशन या इंटरमीडिएट) वेपॉइंट) से साइन इन करके, जिसे आपने पता स्ट्रिंग या प्लस कोड के रूप में बताया है, एपीआई एक स्थान आईडी लुकअप करता है. इस कलेक्शन के हर एलिमेंट में किसी जगह का आईडी. अनुरोध में इन जगहों की जानकारी दी गई है जगह का आईडी या अक्षांश/देशांतर निर्देशांक शामिल नहीं होते. अगर आपने जगह के आईडी या अक्षांश और देशांतर का इस्तेमाल करके सभी जगहों की जानकारी दे दी है निर्देशांक नहीं हैं, तो यह श्रेणी उपलब्ध नहीं है.fallbackInfo
, प्रकार का FallbackInfo. अगर एपीआई सभी इनपुट प्रॉपर्टी से रूट को कैलकुलेट नहीं कर पा रहा है, कंप्यूटेशन के किसी दूसरे तरीके का इस्तेमाल किया जा सकता है. फ़ॉलबैक कब मोड का इस्तेमाल किया जाता है, तो इस फ़ील्ड में फ़ॉलबैक के बारे में पूरी जानकारी होती है जवाब. अगर ऐसा नहीं है, तो यह फ़ील्ड सेट नहीं है.
जवाब का यह फ़ॉर्म होगा:
{ // The routes array. "routes": [ { object (Route) } ], // The place ID lookup results. "geocodingResults": [ { object (GeocodedWaypoint) } ], // The fallback property. "fallbackInfo": { object (FallbackInfo) } }
रूट अरे को समझें
रिस्पॉन्स में routes
अरे शामिल होता है, जहां हर अरे एलिमेंट का टाइप कुछ होता है
रास्ता.
अरे का हर एलिमेंट, ऑरिजिन से डेस्टिनेशन तक के पूरे रूट को दिखाता है. कॉन्टेंट बनाने
एपीआई हमेशा कम से कम एक रूट दिखाता है, जिसे डिफ़ॉल्ट रूट कहा जाता है.
आपके पास दूसरे रास्तों के लिए अनुरोध करने का विकल्प है. अगर आप किसी
ईको-फ़्रेंडली रूट है, तो अरे में दो एलिमेंट हो सकते हैं:
डिफ़ॉल्ट रास्ता और ईको-फ़्रेंडली रास्ता. या computeAlternativeRoutes
को इस पर सेट करें
जवाब में ज़्यादा से ज़्यादा तीन वैकल्पिक रास्ते जोड़ने के अनुरोध में true
.
कैटगरी में मौजूद हर रूट की पहचान, routeLabels
कलेक्शन प्रॉपर्टी की मदद से की जाती है:
मान | ब्यौरा |
---|---|
DEFAULT_ROUTE |
डिफ़ॉल्ट रास्ते की पहचान करता है. |
FUEL_EFFICIENT |
ईको-फ़्रेंडली रास्ते की पहचान करता है. |
DEFAULT_ROUTE_ALTERNATE |
वैकल्पिक रास्ते को दिखाता है. |
legs
कलेक्शन में, रास्ते के हर पैर के बारे में जानकारी होती है. शेष
distanceMeters
, duration
, और polyline,
जैसी प्रॉपर्टी में
रूट के बारे में पूरी जानकारी:
{ "routeLabels": [ enum (RouteLabel) ], "legs": [ { object (RouteLeg) } ], "distanceMeters": integer, "duration": string, "routeLabels": [string], "staticDuration": string, "polyline": { object (Polyline) }, "description": string, "warnings": [ string ], "viewport": { object (Viewport) }, "travelAdvisory": { object (RouteTravelAdvisory) } "routeToken": string }
ड्राइविंग की वर्तमान स्थितियों और अन्य कारकों के कारण डिफ़ॉल्ट रास्ता और
तो ईको-फ़्रेंडली रास्ता एक ही हो सकता है. इस मामले में, routeLabels
कलेक्शन
दोनों लेबल शामिल हैं: DEFAULT_ROUTE
और FUEL_EFFICIENT
.
{ "routes": [ { "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ], … } ] }
लेग अरे को समझें
जवाब के हर route
में एक legs
कलेक्शन होता है, जिसमें हर legs
अरे होता है
तत्व का प्रकार है
RouteLeg.
सरणी में हर पैर एक वेपॉइंट से अगले वेपॉइंट तक पथ को परिभाषित करता है
ट्रैक किया जा सकता है. किसी रास्ते में हमेशा कम से कम एक पैर होता है.
legs
प्रॉपर्टी में, पैर के साथ-साथ हर चरण की परिभाषा होती है
steps
कलेक्शन. बाकी प्रॉपर्टी, जैसे कि distanceMeters
, duration
,
और polyline
में पैर के बारे में जानकारी है.
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object (Polyline) }, "startLocation": { object (Location) }, "endLocation": { object (Location) }, "steps": [ { object (RouteLegStep) } ], "travelAdvisory": { object (RouteLegTravelAdvisory) } }
चरणों की कैटगरी को समझना
जवाब के हर चरण में एक steps
कलेक्शन होता है, जिसमें हर steps
अरे होता है
तत्व का प्रकार है
RouteLegStep.
चरण में पैर पर मौजूद एक निर्देश से मेल खाता है. पैर में हमेशा यह होता है
कम से कम एक चरण पूरा करना होगा.
steps
कलेक्शन के हर एलिमेंट में navigationInstruction
शामिल होता है
प्रॉपर्टी, प्रकार का
NavigationInstruction,
इसमें चरण के लिए निर्देश होता है. उदाहरण के लिए:
"navigationInstruction": { "maneuver": "TURN_LEFT", "instructions": "Turn left toward Frontage Rd" }
instructions
में, इस चरण के बारे में ज़्यादा जानकारी मौजूद हो सकती है. इसके लिए
उदाहरण:
"navigationInstruction": { "maneuver": "TURN_SLIGHT_LEFT", "instructions": "Slight left (signs for I-90 W/Worcester)nParts of this road may be closed at certain times or days" }
चरण की बाकी प्रॉपर्टी, चरण के बारे में जानकारी देती हैं, जैसे
distanceMeters
, duration
, और polyline
के तौर पर:
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object (Polyline) }, "startLocation": { object (Location) }, "endLocation": { object (Location) }, "navigationInstruction": { object (NavigationInstruction) } }
चरण वाले निर्देशों की भाषा तय करें
एपीआई, रूट की जानकारी को स्थानीय भाषा में, अगर ज़रूरी हो, तो उपयोगकर्ता के हिसाब से पढ़ी जा सकने वाली स्क्रिप्ट भाषा. पते के सभी कॉम्पोनेंट उसी भाषा में दिखाए जाते हैं.
इसके
languageCode
पैरामीटर का इस्तेमाल करें इसके लिए अनुरोध करें समर्थित सूची से रूट भाषा पर सेट करें भाषाएँ. Google अक्सर आपके Google Ads खाते की इसलिए, हो सकता है कि यह पूरी सूची न हो.अगर कोई नाम बताई गई भाषा में उपलब्ध नहीं है, तो एपीआई सबसे नज़दीकी मिलान.
चुनी गई भाषा, उन नतीजों के सेट पर असर डाल सकती है जिन्हें एपीआई तय करता है कि वह किस क्रम में दिखेगा और किस क्रम में दिखेगा. कॉन्टेंट बनाने जियोकोडर, भाषा के आधार पर शॉर्ट फ़ॉर्म को अलग-अलग तरीके से समझता है, जैसे सड़कों के लिए संक्षिप्त नाम या समानार्थी शब्द, जो किसी एक भाषा है, लेकिन किसी दूसरी भाषा में नहीं. उदाहरण के लिए, utca और tér के समानार्थी शब्द हंगेरियन में सड़क.
जियोकोडिंग परिणाम अरे को समझें
अनुरोध में शामिल हर जगह के लिए (शुरुआत की जगह, डेस्टिनेशन या इंटरमीडिएट)
वेपॉइंट) को किसी पता स्ट्रिंग या प्लस कोड के रूप में दिखाया जाता था,
एपीआई, सबसे काम की जगह ढूंढने की कोशिश करता है, जिसकी जानकारी मिलती-जुलती हो
आईडी. इसका हर एक एलिमेंट
geocodingResults
अरे में placeID
फ़ील्ड शामिल है
जगह के आईडी के तौर पर जगह की जानकारी होती है और जगह की जानकारी देने वाला type
फ़ील्ड होता है
टाइप करें, जैसे कि street_address
, premise
या airport
.
geocodingResults
कलेक्शन में तीन फ़ील्ड होते हैं:
origin
: अगर इसे किसी पते की स्ट्रिंग या Plus कोड के तौर पर बताया गया था, तो शुरुआत की जगह का आईडी. अगर ऐसा नहीं होता है, तो इस फ़ील्ड को जवाब में शामिल नहीं किया जाएगा.destination
: अगर इसे पते की स्ट्रिंग या Plus Code के तौर पर बताया गया था, गंतव्य का स्थान आईडी. अगर ऐसा नहीं होता है, तो इस फ़ील्ड को जवाब.intermediates
: किसी भी इंटरमीडिएट का स्थान आईडी वाली श्रेणी वेपॉइंट, पते की स्ट्रिंग या प्लस कोड के तौर पर दिए जाते हैं. अगर आप तय करते हैं कि स्थान आईडी या अक्षांश का इस्तेमाल करके एक मध्यवर्ती वेपॉइंट और देशांतर निर्देशांक, इसे जवाब में शामिल नहीं किया जाता. इसका इस्तेमाल करें पता लगाने के लिए, रिस्पॉन्स मेंintermediateWaypointRequestIndex
प्रॉपर्टी मिली अनुरोध का कौन सा इंटरमीडिएट वेपॉइंट इसमें स्थान आईडी से मेल खाता है जवाब को प्राथमिकता दें.
"geocodingResults": { "origin": { "geocoderStatus": {}, "type": [ enum (Type) ], "placeId": string }, "destination": { "geocoderStatus": {}, "type": [ enum (Type) ], "placeId": string }, "intermediates": [ { "geocoderStatus": {}, "intermediateWaypointRequestIndex": integer, "type": [ enum (Type) ], "placeId": string }, { "geocoderStatus": {}, "intermediateWaypointRequestIndex": integer, "type": [ enum (Type) ], "placeId": string } ] }
स्थानीय भाषा में जवाब देने की वैल्यू समझना
स्थानीय जगह के अनुसार दिए गए जवाब की वैल्यू, जवाब देने के लिए अलग से फ़ील्ड होती हैं. दी गई पैरामीटर वैल्यू के लिए, स्थानीय जगह के अनुसार टेक्स्ट. इसके लिए स्थानीय भाषा में टेक्स्ट दिया जाता है यात्रा की अवधि, दूरी, और यूनिट सिस्टम (मेट्रिक या इंपीरियल). आपने अनुरोध किया फ़ील्ड मास्क का इस्तेमाल करके, स्थानीय भाषा के मुताबिक वैल्यू सेट की जा सकती हैं. साथ ही, इनमें भाषा और यूनिट सिस्टम या एपीआई की अनुमानित वैल्यू का इस्तेमाल करें. जानकारी के लिए, यह देखें LocalizedValues.
उदाहरण के लिए, अगर जर्मन (de) और इंपीरियल भाषा का भाषा कोड बताया जाता है
यूनिट का इस्तेमाल करने पर, आपको distanceMeters
के लिए 49889.7 वैल्यू मिलती है,
लेकिन जर्मन भाषा में दूरी की माप देने वाले स्थानीय भाषा के लेख और
इंपीरियल यूनिट, इसलिए "31 मील."
स्थानीय भाषा के मुताबिक वैल्यू के लिए आपको क्या दिखेगा, इसका एक उदाहरण यहां दिया गया है:
{ "localized_values": { "distance": { "text": "31,0 Meile/n" }, "duration": { "text": 38 Minuten}. "static_duration": { "text": 36 Minuten}. } }
अगर भाषा या यूनिट सिस्टम की जानकारी नहीं दी जाती है, तो एपीआई भाषा का ही पता लगाता है और यूनिट का इस्तेमाल करें:
ComputeRoutes
तरीका, जगह और दूरी का अनुमान लगाता है ऑरिजिन वेपॉइंट से मिली इकाइयां. इसलिए, अमेरिका में रूटिंग अनुरोध के लिए, एपीआईen-US
भाषा औरIMPERIAL
यूनिट का अनुमान लगाता है.ComputeRouteMatrix
तरीका डिफ़ॉल्ट रूप से 'en-US' पर सेट होता है भाषा और METRIC इकाइयां.