इस दस्तावेज़ का नया वर्शन उपलब्ध है. इसमें, नए 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®ion=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®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 मिनट लगते हैं.

पार्किंग से नौत्र डेम तक पैदल जाने का रास्ता
उदाहरण 1 के लिए जवाब
जैसा कि आप देख सकते हैं, कार के लिए पार्किंग की जगह खोजने के लिए, सिर्फ़ कुछ एपीआई कॉल की ज़रूरत होती है. इसके बाद, ड्राइवर को सुझाव दिखाया जाता है. इससे आपके उपयोगकर्ताओं का समय बचता है, क्योंकि उन्हें एकतरफ़ा सड़कों पर ड्राइव नहीं करना पड़ता या किसी लोकप्रिय पर्यटन स्थल पर कार पार्क करने के लिए जगह नहीं ढूंढनी पड़ती. खास जानकारी के तौर पर, हमने ये एपीआई अनुरोध किए हैं:
- नोट्रे डेम के निर्देशांक ढूंढने के लिए, 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) मिल जाएंगे.

उदाहरण 2 के लिए जवाब
पिछले उदाहरण की तरह, ड्राइवर को बेहतर दिशा-निर्देश देने के लिए, डेवलपमेंट में बहुत कम मेहनत लगती है. साथ ही, ड्राइवर के समय की बचत के फ़ायदों का आसानी से आकलन किया जा सकता है. हमने ये अनुरोध किए हैं:
- हीथ्रो एयरपोर्ट को खोजने के लिए Places API का अनुरोध
- हीथ्रो एयरपोर्ट के आस-पास मौजूद सभी टर्मिनल ढूंढने के लिए, Places API का अनुरोध
- टर्मिनल 5 तक पहुंचने का रास्ता पाने के लिए, Directions API का अनुरोध
नतीजा
जैसा कि आप देख सकते हैं, कार से यात्रा करने वाले अपने ग्राहकों को प्रीमियम सेवा देने के लिए, आपको ज़्यादा मेहनत करने की ज़रूरत नहीं है. इससे आपको यह आसानी से दिखाने में मदद मिलती है कि आप अपने ग्राहकों की ज़रूरतों के बारे में सोच रहे हैं.
डेवलपमेंट के लिए, कई लाइब्रेरी और टूल उपलब्ध हैं. इनका इस्तेमाल करके, अपने ग्राहकों के लिए सेवाएं बनाई जा सकती हैं. Google Maps Platform के लिए, GitHub के सार्वजनिक तौर पर उपलब्ध डेटा स्टोर करने की जगह देखें.
अगली कार्रवाइयां
मुख्य लेखक
मिक्को तोइवानन | Google Maps Platform Solutions Engineer