किसी रास्ते का हिसाब लगाने के लिए, आपको कम से कम रास्ते की जगहें बतानी होंगी शुरुआत की जगह और रास्ते की मंज़िल. आप इन जगहों को वेपॉइंट के तौर पर तय करते हैं रूट
ऑरिजिन और डेस्टिनेशन के अलावा, आपके पास अलग-अलग तरह के वेपॉइंट और किसी रूट के लिए वेपॉइंट को कैसे हैंडल किया जाए. इस बारे में ज़्यादा जानने के लिए, उदाहरण के लिए, ये विषय देखें:
- वाहन का टाइटल और सड़क का हिस्सा बताएं
- मध्यवर्ती वेपॉइंट तय करना
- किसी रास्ते पर स्टॉप सेट करना
- किसी रास्ते से गुज़रने के लिए एक पॉइंट सेट करना
- अपने रास्ते के स्टॉप के क्रम को ऑप्टिमाइज़ करना
किसी रूट के लिए जगहों की जानकारी देना
वेपॉइंट (REST) बनाकर किसी जगह को दिखाया जाता है या Waypoint (gRPC) ऑब्जेक्ट होना चाहिए. इस वेपॉइंट परिभाषा, आप निम्न में से किसी भी तरीके से स्थान को तय कर सकते हैं:
- जगह का आईडी (पसंदीदा)
- अक्षांश/देशांतर निर्देशांक
- पते की स्ट्रिंग ("शिकागो, IL" या "डार्विन, एनटी, ऑस्ट्रेलिया")
- Plus Code
अनुरोध में सभी वेपॉइंट के लिए जगहों की जानकारी एक ही तरह से दी जा सकती है, या इन्हें मिक्स किया जा सकता है. उदाहरण के लिए, आप अक्षांश/देशांतर निर्देशांकों का उपयोग गंतव्य वेपॉइंट के लिए एक स्थान आईडी का उपयोग करें और
बेहतर और सटीक जानकारी के लिए, अक्षांश/देशांतर के बजाय जगह के आईडी का इस्तेमाल करें निर्देशांक या पता स्ट्रिंग. जगह के आईडी खास तौर पर अश्लील हों और उनमें ऐक्सेस पॉइंट और ट्रैफ़िक वैरिएबल जैसे रूटिंग के लिए जियोकोडिंग फ़ायदे. वे नीचे बताई गई स्थितियों से बचने में मदद करने के लिए, स्थान दर्ज करते हुएः
- अक्षांश/देशांतर निर्देशांकों का प्रयोग करने पर स्थान उन निर्देशांकों के निकटतम सड़क पर स्नैप किया गया है - जो प्रॉपर्टी के ऐक्सेस पॉइंट या ऐसी सड़क जो तुरंत या सुरक्षित तरीके से ऐक्सेस की जा सकती हो गंतव्य पर ले जाता है.
- फ़ॉर्मैट बदलने के लिए, पते की स्ट्रिंग को पहले Routes API से जियोकोड करना होगा अक्षांश/देशांतर निर्देशांक का इस्तेमाल करें. इस कन्वर्ज़न से, परफ़ॉर्मेंस पर असर पड़ सकता है.
जगह के आईडी के तौर पर जगह की जानकारी दें
वेपॉइंट की जगह की जानकारी देने के लिए, जगह के आईडी का इस्तेमाल किया जा सकता है. क्योंकि अक्षांश और देशांतर निर्देशांक सड़कों में बदल दिए जाते हैं, तो आपको जगह के आईडी से कुछ मामलों में बेहतर नतीजे मिलते हैं.
Geocoding API से जगह के आईडी वापस पाएं और Places API (जगह की जानकारी के साथ) ऑटोकंप्लीट). जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी के बारे में खास जानकारी.
नीचे दिए गए उदाहरण में, दोनों के लिए जगह का आईडी पास करने के लिए placeId
प्रॉपर्टी का इस्तेमाल किया गया है
origin
और destination
:
{ "origin":{ "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o" }, "destination":{ "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU" }, ... }
किसी जगह के अक्षांश और देशांतर निर्देशांक की जानकारी दें
वेपॉइंट में स्थान परिभाषित करने के लिए, Location (REST) या Location(gRPC) का इस्तेमाल करें अक्षांश/देशांतर निर्देशांक.
उदाहरण के लिए, origin
और destination
रास्ते के लिए वेपॉइंट तय करें
latitude
और longitude
निर्देशांकों का प्रयोग करके:
{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, ... }अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
पते की स्ट्रिंग के तौर पर जगह की जानकारी डालें
पते की स्ट्रिंग लिटरल पते होती हैं. इन्हें स्ट्रिंग के ज़रिए दिखाया जाता है (जैसे कि "1600" एंफ़ीथिएटर पार्कवे, माउंटेन व्यू, कैलिफ़ोर्निया"). जियोकोडिंग एक ऐसी प्रोसेस है किसी पता स्ट्रिंग को अक्षांश और देशांतर निर्देशांकों में बदलना (जैसे कि अक्षांश 37.423021 और देशांतर -122.083739).
जब किसी पते की स्ट्रिंग को वेपॉइंट की लोकेशन के तौर पर पास किया जाता है, तो रूट एपीआई स्ट्रिंग को अक्षांश और देशांतर में बदलने के लिए इसे अंदरूनी तौर पर जियोकोड करता है निर्देशांक.
उदाहरण के लिए, किसी रास्ते की गणना करने के लिए आप origin
रास्ते के लिए वेपॉइंट तय करते हैं और
पता स्ट्रिंग का इस्तेमाल करके destination
:
{ "origin":{ "address": "1600 Amphitheatre Parkway, Mountain View, CA" }, "destination":{ "address": "450 Serra Mall, Stanford, CA 94305, USA" }, ... }
इस उदाहरण में, Routes API दोनों पतों को जियोकोड में बदलने के लिए उन्हें अक्षांश और देशांतर निर्देशांक.
अगर पता मान साफ़ नहीं है, तो Routes API Google से खोज शुरू कर सकता है और मिलते-जुलते ईमेल पतों से साफ़ तौर पर अंतर कर पाते हैं. उदाहरण के लिए, "पहली सड़क" होता है "1st Street NE" के लिए पूरी वैल्यू या आंशिक वैल्यू या "पहला सेंट एसई". यह नतीजा Geocoding API से मिले नतीजे से अलग हो सकता है. इनसे बचा जा सकता है इससे जगह के आईडी का इस्तेमाल करके भी चीज़ों को गलत तरीके से समझा जा सकता है.
पते के लिए क्षेत्र सेट करें
अगर आप वेपॉइंट की लोकेशन के रूप में अधूरी पता स्ट्रिंग पास करते हैं, तो एपीआई गलत जियोकोड किए गए अक्षांश/देशांतर निर्देशांक का इस्तेमाल कर सकते हैं. उदाहरण के लिए, तो आप "Toledo" दर्ज करके अनुरोध करते हैं मूल के तौर पर और "मैड्रिड" क्योंकि ड्राइविंग मार्ग के लिए गंतव्य:
{ "origin":{ "address": "Toledo" }, "destination":{ "address": "Madrid" }, "travelMode": "DRIVE" }
इस उदाहरण में, "टोलेडो" के राज्य में शहर के रूप में समझा जाता है अमेरिका में ओहायो, स्पेन में नहीं. इसलिए, अनुरोध वापस खाली अरे, इसका मतलब है कि कोई रूट मौजूद नहीं है:
{ [] }
एपीआई को इस तरह कॉन्फ़िगर किया जा सकता है कि वह किसी खास क्षेत्र से जुड़े नतीजे दिखा सके
इसमें regionCode
पैरामीटर शामिल है. यह पैरामीटर, क्षेत्र कोड को
ccTLD ("टॉप लेवल डोमेन")
दो वर्ण वाला मान. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड के समान होते हैं. साथ ही,
कुछ अहम अपवाद. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" है
(.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है (तकनीकी तौर पर, "
यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन और नॉदर्न आयरलैंड").
"टोलेडो" के लिए दिशा-निर्देश का अनुरोध "मैड्रिड" के लिए जिसमें regionCode
शामिल है
पैरामीटर सही नतीजे देता है, क्योंकि "Toledo" को ऐसे समझा जाता है
स्पेन का शहर:
{ "origin":{ "address": "Toledo" }, "destination":{ "address": "Madrid" }, "travelMode": "DRIVE", "regionCode": "es" }
इस जवाब में अब टोलेडो, स्पेन से लेकर यात्रा के लिए रास्ता शामिल है मैड्रिड, स्पेन:
{ "routes": [ { "distanceMeters": 75330, "duration": "4137s", ... } ] }
किसी जगह की जानकारी को Plus Code के तौर पर डालें
कई लोगों के पास सटीक पता नहीं होता है, जो उनके लिए यह कठिन हो सकता है डिलीवरी पाने के लिए. या, पते वाले लोग शायद इसे स्वीकार करना चाहें ज़्यादा खास जगहों पर डिलीवरी की सुविधा. जैसे, पीछे का रास्ता या लोडिंग डॉक.
Plus Code उन लोगों या जगहों के मोहल्ले के पते की तरह होते हैं जिनके पास असली पता. मोहल्ले के नाम और नंबर वाले पतों के बजाय, Plus Code अक्षांश/देशांतर निर्देशांक पर आधारित होते हैं और संख्याओं और अंग्रेज़ी वर्णमाला के छोटे अक्षर दिखाएं.
Google ने Plus Code डेवलप किया है सभी को पतों का फ़ायदा देना है. Plus Code को कोड में बदला गया है जगह का रेफ़रंस होता है, जो अक्षांश/देशांतर निर्देशांक से लिया जाता है, क्षेत्र का प्रतिनिधित्व करता है: डिग्री के 1/8000वें हिस्से के लिए डिग्री के 1/8000वें हिस्से के लिए डिग्री (करीब 14 मीटर x) भूमध्य रेखा पर 14 मीटर) या इससे कम. इसकी जगह Plus Code का इस्तेमाल किया जा सकता है उन जगहों के मोहल्ले के पते जहां मौजूद नहीं है या जहां कोई इमारत नहीं है नंबर या सड़कों के नाम नहीं बताए गए हैं.
Plus Code को ग्लोबल कोड या कंपाउंड कोड के तौर पर फ़ॉर्मैट किया जाना चाहिए:
- ग्लोबल कोड, 4 वर्णों वाला क्षेत्र कोड और 6 वर्णों से मिलकर बना होता है
वर्ण या लंबा लोकल कोड.
उदाहरण के लिए, "1600 Amphitheatre Parkway, Mountain View, CA", ग्लोबल कोड "849V" है और स्थानीय कोड है "CWT8+R9". इसके बाद, पूरे 10 वर्णों का Plus Code इस्तेमाल करके यह तय करें कि स्थान मान "849VCWT8+R9".
- कंपाउंड कोड, छह या उससे ज़्यादा वर्णों से मिलकर बनता है
लोकल कोड को किसी अश्लील जगह के साथ जोड़ा जाना चाहिए.
उदाहरण के लिए, पता "450 Serra मॉल, स्टैनफ़ोर्ड, CA 94305, USA" का लोकल कोड "CRHJ+C3" है. कंपाउंड के लिए पता है, तो स्थानीय कोड को शहर, राज्य, पिन कोड और देश के साथ जोड़ें. पते का हिस्सा "CRHJ+C3 Stanford, CA 94305, USA" के रूप में होना चाहिए.
उदाहरण के लिए,
origin
रास्ते के लिए वेपॉइंट तय करके, रूट का हिसाब लगाना और Plus Code का इस्तेमाल करकेdestination
:{ "origin":{ "address": "849VCWC8+R9" }, "destination":{ "address": "CRHJ+C3 Stanford, CA 94305, USA" }, "travelMode": "DRIVE" }
Plus Code, Google Maps Platform एपीआई में काम करते हैं. इनमें ये भी शामिल हैं जगह की जानकारी के अपने-आप पूरे होने की सुविधा, जगह की जानकारी, दिशा-निर्देश एपीआई, और जियोकोडिंग एपीआई. उदाहरण के लिए, जियोकोडिंग एपीआई का इस्तेमाल करके अक्षांश/देशांतर निर्देशांकों से तय की गई जगह की जानकारी जगह का Plus Code.