इस दस्तावेज़ का नया वर्शन उपलब्ध है. इसमें, Places API और Routes API के नए वर्शन का इस्तेमाल करने के उदाहरण दिए गए हैं.
आम तौर पर, जब कोई उपयोगकर्ता किसी लोकप्रिय जगह (पीओआई) पर ड्राइव कर रहा होता है, तो उसे आस-पास की किसी जगह, जैसे कि पार्किंग या ऐक्सेस पॉइंट पर नेविगेट करने की ज़रूरत होती है. किसी ऐसे ड्राइवर की कल्पना करें जिसे एयरपोर्ट या शॉपिंग मॉल जाना है. हवाई अड्डे पर जाते समय, ड्राइवर हवाई अड्डे के बीचोंबीच के बजाय, टर्मिनल या छोड़ने की जगह पर पहुंचने की कोशिश कर रहा हो. इसी तरह, कार से आने वाले उपयोगकर्ता के लिए, शॉपिंग सेंटर के बगल में मौजूद पार्किंग का विकल्प बेहतर हो सकता है. इस मामले में, ड्राइवर को गाइड करने के लिए कोई ऐप्लिकेशन या सेवा बनाते समय, पहले यह पता लगाएं कि वह कहां जा रहा है. इसके बाद, ड्राइवर को उस जगह के आस-पास मौजूद अन्य जगहों के विकल्प दें. इस तरीके से, अपने ग्राहकों को बेहतर सेवा दी जा सकती है. साथ ही, यह भी दिखाया जा सकता है कि आप उनके समय की अहमियत समझते हैं. इसके लिए, आपको Google Maps Platform से मिले जगह की जानकारी के डेटा का इस्तेमाल करके, ऐप्लिकेशन को बेहतर बनाने के लिए थोड़ा सा, लेकिन स्मार्ट काम करना होगा.
हम आपको बताएंगे कि अपने डेस्टिनेशन के पास कार पार्क करने के लिए सही जगह की पहचान करने के लिए, Places API और Directions API का इस्तेमाल कैसे किया जा सकता है. इस समाधान का मकसद, मंज़िल के करीब पहुंचने पर पार्किंग की जगह ढूंढने के लिए, कई इंटरैक्शन और अनिश्चितता को खत्म करना है. आइए, दो उदाहरणों की मदद से जानें कि इन मामलों को पूरी जानकारी के साथ कैसे लागू किया जा सकता है.
पहला उदाहरण - पर्यटकों की पसंदीदा ऐसी जगह जहां पार्किंग की सुविधा नहीं है
आइए, ऐसी जगह चुनें जो सीधे सड़क से नहीं जुड़ी है, ताकि रास्ता अलग से खोजा जा सके. डेस्टिनेशन, पेरिस में नोट्रे डेम है और स्टार्टिंग पॉइंट के तौर पर, Gare de l’Est रेलवे स्टेशन (48.87697775149635, 2.3592247806755564) का इस्तेमाल करें.
ड्राइवर, नॉट्रे डेम से 16 मिनट उत्तर में स्टेशन छोड़ता है. नोट्रे डेम, एक टापू पर बना पर्यटकों का एक लोकप्रिय आकर्षण है. यहां पहुंचने के लिए, एक पुल का इस्तेमाल किया जाता है. इसके आस-पास कुछ एकतरफ़ा सड़कें हैं और कोई बड़ी पार्किंग नहीं है. इसलिए, यह एक दिलचस्प चैलेंज हो सकता है.
Places API का अनुरोध
इस उदाहरण में, Places API के अनुरोध में “टेक्स्ट से खोजने” की सुविधा का इस्तेमाल करके, नोट्रे डेम को ढूंढा जा रहा है. ज़्यादा जानकारी के लिए, डेवलपर दस्तावेज़ देखें. इन उदाहरणों में “YOUR_KEY” वह एपीआई पासकोड है जो आपके पास Google Cloud Console में चालू किए गए Google Maps Platform के Places और Directions API के लिए है. ज़्यादा जानकारी के लिए, कृपया Google Maps Platform का इस्तेमाल शुरू करने के बारे में दस्तावेज़ देखें.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
ऊपर दिए गए अनुरोध के जवाब में, अक्षांश और देशांतर के ये निर्देशांक दिए गए हैं:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
जैसा कि आपको दिख रहा है, कॉर्डिनेट में नोट्रे-डेम की जगह की सटीक जानकारी दी गई है.
|
|
डेवलपर या सेवा देने वाली कंपनी के तौर पर, ड्राइवर को अपने-आप यह मैसेज भेजना एक अच्छा आइडिया है कि “क्या आपको नोट्रे डेम के पास पार्किंग चाहिए?”. डिवाइस और स्क्रीन के हिसाब से, उपयोगकर्ता अनुभव अलग-अलग होगा. हालांकि, इस मामले में, कुछ समय बाद अपने-आप गायब होने वाला एक छोटा पॉप-अप टेक्स्ट दिखाया जा सकता है. नोट्रे डेम के पास पार्किंग की जगह ढूंढने के लिए, Places API की टेक्स्ट खोज की सुविधा का इस्तेमाल करें. इसके लिए, “पार्किंग” टाइप और त्रिज्या “300” पैरामीटर सेट करें. इस उदाहरण में, नतीजों में नॉट्रे डेम से 300 मीटर के दायरे में मौजूद पार्किंग की जगहों को प्राथमिकता दी जाएगी.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
पहला नतीजा, “Parking Saemes Maubert-Lagrange” है, जो 48.850591, 2.3486436 पर है. अगले हिस्से में, इस जगह का इस्तेमाल Directions API के अनुरोध के लिए करते हैं.
Directions API का अनुरोध
स्टेशन से नोट्रे डेम के पास मौजूद पार्किंग की जगह का रास्ता ढूंढने के लिए, आपको Directions API का अनुरोध करना होगा. सिर्फ़ ऑरिजिन और डेस्टिनेशन पैरामीटर सेट करें. ज़्यादा विकल्पों के लिए, डेवलपर के लिए दस्तावेज़ देखें.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
Direction API के रिस्पॉन्स में, आम तौर पर रास्ते के कई सुझाव होते हैं. हर रास्ते में कई “लेग” होते हैं. साथ ही, उनमें कई “चरण” होते हैं, जिनमें यात्रा की दूरी और निर्देशांक दिखते हैं. कार से पहुंचने वाले आखिरी निर्देशांक ढूंढने के लिए, चुने गए रास्ते के आखिरी चरण के आखिरी चरण के “end_location” फ़ील्ड का इस्तेमाल करें.
ऐसा हो सकता है कि यह जगह पहली पसंद न लगे, लेकिन मैप या Google Street View पर देखने पर, आपको पता चलेगा कि यह जगह नॉट्रे डेम से बहुत कम दूरी पर है. पैदल जाने में करीब 6-7 मिनट लगते हैं.
पार्किंग से नॉट्रे डेम तक पैदल जाने का रास्ता
पहले उदाहरण की खास जानकारी
जैसा कि आप देख सकते हैं, कार के लिए पार्किंग की जगह ढूंढने के लिए, सिर्फ़ कुछ एपीआई कॉल की ज़रूरत होती है और ड्राइवर को सुझाव दिखाना होता है. इससे आपके उपयोगकर्ताओं का समय बचता है, क्योंकि वे एकतरफ़ा सड़कों पर ड्राइव नहीं कर रहे हैं या पर्यटकों की भीड़-भाड़ वाली जगहों पर कार पार्क करने की जगह ढूंढने की कोशिश नहीं कर रहे हैं. खास जानकारी के तौर पर, हमने ये एपीआई अनुरोध किए हैं:
- नोट्रे डेम के निर्देशांक ढूंढने के लिए, Places API का अनुरोध
- उन निर्देशांकों के 300 मीटर के दायरे में पार्किंग की जगह ढूंढने के लिए, Places API का अनुरोध
- पार्किंग की जगह का रास्ता खोजने के लिए, Directions API का अनुरोध
दूसरा उदाहरण - किसी बड़े हवाई अड्डे के टर्मिनल तक ले जाने वाली गाइड
"types" : [ "airport", "point_of_interest", "establishment" ],
हालांकि, किसी भी बड़े हवाई अड्डे पर जाकर, यह पता चलता है कि अगर आप गलत जगह पर पहुंच जाते हैं, तो टर्मिनल के बीच ट्रांसफ़र करने में काफ़ी समय लगता है. इस मामले में, खोज के नतीजे का टाइप “हवाई अड्डा” है. इसलिए, लंदन हीथ्रो हवाई अड्डे (51.47016927594547, -0.45432767852489075) की जगह की जानकारी का इस्तेमाल करके, “टर्मिनल” खोजने के लिए, क्वेरी को अपने-आप फ़ॉलो अप करना मददगार होता है. उदाहरण में, खोज के दायरे को 3,000 मीटर तक सीमित करने की वैकल्पिक पाबंदी भी देखी जा सकती है.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
ऊपर दी गई क्वेरी से, हमें उन टर्मिनल और उन टर्मिनल पर मौजूद अलग-अलग ड्रॉप-ऑफ़ पॉइंट की सूची मिलती है. नतीजों की सूची में, हमें “लंदन हीथ्रो एयरपोर्ट टर्मिनल 5” और उसका प्लेस आईडी दिखेगा:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
“place_id” पैरामीटर का इस्तेमाल करके, Directions API को यह बताया जा सकता है कि हमें किसी जगह पर जाना है, न कि किसी मनमुताबिक निर्देशांक पर.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
पिछले उदाहरण की तरह ही, JSON जवाब में सभी चरणों को पढ़कर, आपको यात्रा का आखिरी हिस्सा और आखिरी जगहों के अक्षांश और देशांतर के निर्देशांक (51.47079979999999,-0.4896765) मिलेंगे.
दूसरे उदाहरण की खास जानकारी
पिछले उदाहरण की तरह, ड्राइवर को बेहतर दिशा-निर्देश देने के लिए, डेवलपमेंट में बहुत कम मेहनत लगती है. साथ ही, ड्राइवर के समय की बचत के फ़ायदों को आसानी से मेज़र किया जा सकता है. हमने ये अनुरोध किए हैं:
- हीथ्रो एयरपोर्ट ढूंढने के लिए Places API का अनुरोध
- हीथ्रो एयरपोर्ट के निर्देशांक के आस-पास मौजूद सभी टर्मिनल ढूंढने के लिए, Places API का अनुरोध
- टर्मिनल 5 तक का रास्ता पाने के लिए, Directions API का अनुरोध
नतीजा
जैसा कि आप देख सकते हैं, कार से यात्रा करने वाले अपने ग्राहकों को प्रीमियम सेवा देने के लिए, डेवलपमेंट में ज़्यादा मेहनत नहीं करनी पड़ती. साथ ही, इससे आपको यह आसानी से दिखाने में मदद मिलती है कि आपके ग्राहकों की ज़रूरतों को किस तरह ध्यान में रखा जा रहा है.
डेवलपमेंट के लिए, कई लाइब्रेरी और टूल का इस्तेमाल किया जा सकता है. इससे आपको अपने ग्राहकों के लिए सेवाएं बनाने में मदद मिलेगी. Google Maps Platform के लिए, GitHub पर मौजूद डेटा स्टोर करने की जगह पर जाएं. यह सार्वजनिक तौर पर उपलब्ध है.
अगली कार्रवाइयां
मुख्य लेखक
मिको टोइवानेन | Google Maps Platform के सलूशन इंजीनियर