कार में जगह ब्राउज़ करते समय, सबसे अच्छा उपयोगकर्ता अनुभव देने के लिए सलाह

इस दस्तावेज़ का नया वर्शन उपलब्ध है. इसमें, नए Places API और Routes API के इस्तेमाल के उदाहरण दिए गए हैं.

आम तौर पर, जब कोई उपयोगकर्ता किसी दिलचस्पी की जगह (पीओआई) पर गाड़ी चला रहा होता है, तो उसे आस-पास की किसी जगह पर नेविगेट करने की ज़रूरत होती है. जैसे, पार्किंग या ऐक्सेस पॉइंट. मान लें कि किसी ड्राइवर को एयरपोर्ट या शॉपिंग मॉल जाना है. हवाई अड्डे जाते समय, ड्राइवर हवाई अड्डे के बीच में न जाकर किसी टर्मिनल या ड्रॉप-ऑफ़ पॉइंट पर पहुंचने की कोशिश कर रहा हो. इसी तरह, शॉपिंग सेंटर के बगल में मौजूद पार्किंग की जगह, कार वाले व्यक्ति के लिए ज़्यादा बेहतर विकल्प हो सकती है. इस मामले में, ड्राइवर को दिशा-निर्देश देने के लिए कोई ऐप्लिकेशन या सेवा डेवलप करते समय, सबसे पहले उस जगह की जानकारी ढूंढें जहां ड्राइवर को जाना है. इसके बाद, ड्राइवर को उस जगह के आस-पास की वैकल्पिक मंज़िलों के बारे में बताएं. इस तरीके से, अपने खरीदारों को बेहतर सेवा दी जा सकती है. साथ ही, यह दिखाया जा सकता है कि आपको उनके समय की कद्र है. इसके लिए, आपको Google Maps Platform से मिले जगह की जानकारी के डेटा का इस्तेमाल करके, कम लेकिन स्मार्ट तरीके से डेवलपमेंट करना होगा.

[सिस्टम कॉन्टेक्स्ट] हाई लेवल नेविगेशन सिस्टम
ड्राइवर को कार से किसी जगह पर ले जाने के दौरान इस्तेमाल किए जाने वाले सिस्टम का आसान व्यू
सिस्टम का हाई लेवल डायग्राम

हम आपको बताएंगे कि अपने गंतव्य के पास पार्किंग की सही जगह का पता लगाने के लिए, Places API और Directions API का क्रम से या एक साथ इस्तेमाल कैसे किया जा सकता है. इस सुविधा का मकसद, ड्राइविंग के दौरान पार्किंग की जगह ढूंढने में होने वाली मुश्किलों को कम करना है. साथ ही, मंज़िल के पास पहुंचने पर, पार्किंग की जगह ढूंढने के लिए कई बार इंटरैक्ट करने की ज़रूरत को खत्म करना है. आइए, इन मामलों को लागू करने के दो उदाहरणों के बारे में विस्तार से जानते हैं.

उदाहरण 1 - ऐसी जगह जो पर्यटकों के आकर्षण का केंद्र है, लेकिन वहां पार्किंग की सुविधा नहीं है

आइए, ऐसी जगह चुनते हैं जो सड़क के किनारे से सीधे तौर पर जुड़ी न हो, ताकि रूट को अलग से खोजा जा सके. मंज़िल के तौर पर, पेरिस में नोट्रे डेम को चुनते हैं. साथ ही, शुरुआती जगह के तौर पर, गारे दे ल’एस्त रेलवे स्टेशन (48.87697775149635, 2.3592247806755564) को चुनते हैं.

गार द ल'एस्त

ड्राइवर, नौत्र देम से करीब 16 मिनट की दूरी पर उत्तर की ओर स्टेशन छोड़ता है. नोत्र देम, एक मशहूर टूरिस्ट अट्रैक्शन है. यह एक टापू पर है और यहां पुल से पहुंचा जा सकता है. यहां कुछ सड़कें वन-वे हैं और आस-पास कोई बड़ा पार्किंग लॉट उपलब्ध नहीं है. इसलिए, यह एक दिलचस्प चुनौती होनी चाहिए.

Places API का अनुरोध

Places API के इस उदाहरण में, Notre Dame को खोजने के लिए “टेक्स्ट से खोजें” सुविधा का इस्तेमाल किया जा रहा है. ज़्यादा जानकारी के लिए, डेवलपर दस्तावेज़ देखें. इन उदाहरणों में “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&region=fr&key=YOUR_KEY

ऊपर दिए गए अनुरोध के जवाब में, अक्षांश और देशांतर के ये निर्देशांक दिए गए हैं:

  "results" : [
      {
        "formatted_address" : "Notre Dame, Paris",
        "geometry" : {
           "location" : {
               "lat" : 48.8527288,
                },
  ...

जैसा कि आपको दिख रहा है, निर्देशांकों से नोट्रा-डेम का पता चलता है.

नोट्र डाम की फ़ोटो
मैप पर नोट्र डाम

डेवलपर या सेवा देने वाली कंपनी के तौर पर, ड्राइवर को अपने-आप यह प्रॉम्प्ट दिखाना एक अच्छा विचार है कि “क्या आपको Notre Dame के आस-पास पार्किंग की जगह चाहिए?”. डिवाइस और स्क्रीन के हिसाब से, उपयोगकर्ता अनुभव अलग-अलग होगा. हालांकि, इस मामले में कुछ समय बाद गायब होने वाला छोटा पॉप-अप टेक्स्ट इस्तेमाल किया जा सकता है. नोट्रे डेम के आस-पास पार्किंग की जगहें ढूंढने के लिए, Places API की टेक्स्ट सर्च सुविधा का इस्तेमाल करें. इसमें “parking” टाइप और “300” रेडियस पैरामीटर सेट करें. इस उदाहरण में, नतीजों को नौट्रे डैम से 300 मीटर के दायरे में मौजूद पार्किंग की जगहों के हिसाब से पक्षपातपूर्ण बनाया जाएगा.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635&region=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 मिनट लगते हैं.

पार्किंग से नौत्र डेम तक पैदल जाने का रास्ता

पार्किंग एरिया से नौट्रे डैम तक पैदल चलने का रास्ता

उदाहरण 1 के लिए खास जानकारी

जैसा कि आप देख सकते हैं, कार के लिए पार्किंग की जगह ढूंढने के लिए, सिर्फ़ कुछ एपीआई कॉल की ज़रूरत होती है. साथ ही, ड्राइवर को सुझाव दिखाया जाता है. इससे उपयोगकर्ताओं का समय बचता है, क्योंकि उन्हें एकतरफ़ा सड़कों पर ड्राइव नहीं करना पड़ता. साथ ही, उन्हें भीड़-भाड़ वाली जगहों पर कार पार्क करने के लिए जगह नहीं ढूंढनी पड़ती. खास जानकारी के तौर पर, हमने ये एपीआई अनुरोध किए हैं:

  • नोट्रे डेम के निर्देशांक ढूंढने के लिए, Places API का अनुरोध
  • Places API का अनुरोध, ताकि उन निर्देशांकों से 300 मीटर के दायरे में पार्किंग की जगह का पता लगाया जा सके
  • पार्किंग की जगह तक जाने का रास्ता ढूंढने के लिए, Directions API का अनुरोध

उदाहरण 2 - बड़े हवाई अड्डे में किसी टर्मिनल तक पहुंचने का रास्ता दिखाना

मैप पर हीथ्रो एयरपोर्ट
आइए, एक और उदाहरण देखते हैं. इसमें ड्राइवर को एक बड़े इलाके में जाना है. इस इलाके में कई जगहें, दिलचस्पी की जगहें या संभावित ड्रॉप-ऑफ़ पॉइंट हैं. ड्राइवर, यूके के वेम्बली स्टेडियम (51.557263604707224, -0.2794575145680608) से निकल रहा है और उसे लंदन हीथ्रो एयरपोर्ट के टर्मिनल 5 पर पहुंचना है. आम तौर पर, उपयोगकर्ता “Heathrow” टाइप करना शुरू करता है. अगर पहले दो या तीन नतीजे सही लगते हैं, तो ज़्यादातर लोग उनमें से किसी एक को चुनते हैं. चुने गए नतीजे से, “टाइप” फ़ील्ड की वैल्यू पढ़कर यह पता लगाया जा सकता है कि जगह एक हवाई अड्डा है. टाइप की पूरी सूची यहां देखी जा सकती है.

  "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&region=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) मिल जाएंगे.

हीथ्रो टर्मिनल 5

उदाहरण 2 के लिए खास जानकारी

पिछले उदाहरण की तरह, ड्राइवर को बेहतर दिशा-निर्देश देने के लिए, डेवलपमेंट में बहुत कम मेहनत लगती है. साथ ही, ड्राइवर के समय की बचत के फ़ायदों को आसानी से मापा जा सकता है. हमने ये अनुरोध किए हैं:

  • हीथ्रो एयरपोर्ट को खोजने के लिए, Places API का अनुरोध
  • हीथ्रो एयरपोर्ट के आस-पास मौजूद सभी टर्मिनल ढूंढने के लिए, Places API का अनुरोध
  • टर्मिनल 5 तक पहुंचने का रास्ता पाने के लिए, Directions API का अनुरोध

नतीजा

जैसा कि आप देख सकते हैं, कार से यात्रा करने वाले खरीदारों को प्रीमियम सेवा देने के लिए, आपको ज़्यादा मेहनत करने की ज़रूरत नहीं है. इससे आपको यह आसानी से दिखाने में मदद मिलती है कि आप खरीदारों की ज़रूरतों के बारे में सोच रहे हैं.

डेवलपमेंट के लिए, कई लाइब्रेरी और टूल उपलब्ध हैं. इनका इस्तेमाल करके, अपने ग्राहकों के लिए सेवाएं बनाई जा सकती हैं. Google Maps Platform के लिए, GitHub पर मौजूद हमारी सार्वजनिक रिपॉज़िटरी देखें.

अगली कार्रवाइयां

मुख्य लेखक

मिक्को तोइवानन | Google Maps Platform Solutions Engineer