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

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

लोकल डिस्कवरी
स्थानीय खोज के अनुभव को बेहतर बनाने के कई तरीके हैं. यहां दिया गया इंटिग्रेशन, उपयोगकर्ता अनुभव का एक कस्टम उदाहरण है. इसमें Google Maps Platform के जाने-माने एपीआई के साथ-साथ कुछ नई सुविधाओं का इस्तेमाल किया गया है. अगर आपको स्थानीय खोज के लिए टेंप्लेट वाला तरीका अपनाना है, तो वेब कॉम्पोनेंट का इस्तेमाल किया जा सकता है.
नमूना एप्लिकेशन
सिलसिलेवार तरीके से दिए गए निर्देशों का सैंपल
नीचे दी गई टेबल में, आपको सैंपल ऐप्लिकेशन के बारे में जानकारी मिलेगी. इसे अलग-अलग चरणों में बांटा गया है. साथ ही, Google Maps Platform के एपीआई के साथ तकनीकी तौर पर लागू करने के बारे में जानकारी दी गई है.
1. ऑटोकंप्लीट की सुविधा के साथ जगह की जानकारी खोजने की सुविधा
- Maps JavaScript API लोड करें.
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाली क्वेरी या मैप पर जगह चुनें.

2. Nearby Search (New) API का इस्तेमाल करके, आस-पास की दिलचस्प जगहों की जानकारी दिखाएं
- लोकप्रियता के हिसाब से रैंकिंग (ज़्यादा काम के नतीजे) या दूरी के हिसाब से रैंकिंग.
includedTypes,excludedTypes; अगर आप होटल हैं, तो “lodging” टाइप को बाहर रखा जा सकता है और सिर्फ़ सही टाइप शामिल किए जा सकते हैं. जैसे: “restaurant, cafe, park, tourist_attraction”.- नतीजों पर ज़्यादा कंट्रोल पाने के लिए,
includedPrimaryTypesऔरexcludedPrimaryTypesका इस्तेमाल करें. - `locationRestriction` का इस्तेमाल करें, ताकि कम नतीजे मिलने या बहुत दूर की जगहों के नतीजे मिलने से बचा जा सके. अगर कोई नतीजा नहीं मिलता है, तो नतीजे दिखाने से पहले सर्कल / रेक्टैंगल का साइज़ बढ़ाएं.

होटल बुक करते समय, अनुरोध किए गए डेटा फ़ील्ड के साथ क्वेरी का सैंपल:
- बेसिक (
displayName,types,openingHours,formattedAddress) - संपर्क (
websiteUri,nationalPhoneNumber,internationalPhoneNumber) - पसंदीदा (
reviews,priceLevel,userRatingCount)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }रीयल एस्टेट खोजने के लिए क्वेरी का सैंपल, जिसमें डेटा फ़ील्ड का अनुरोध किया गया है:
- बेसिक (
displayName,types,openingHours,formattedAddress)
{ "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }3. Dynamic Maps और Directions API की मदद से, इंटरैक्टिविटी जोड़ें
- Directions API से क्वेरी करके, लेग और स्टेप की अप-टू-डेट जानकारी. * अगले सेक्शन में समय का इस्तेमाल करें.

4. इंटरैक्शन करने पर, जगह की ज़्यादा जानकारी दिखाएं
जानकारी:
displayName,types,rating,userRatingCount,priceLevel.समय: यह पिछली Directions API क्वेरी से मिलता है.
समीक्षाएं:
reviews[i].author,reviews[i].rating,reviews[i].text.इमेज: Nearby Search (New) API की बिना पाबंदी वाली झलक के दौरान, आपको Places Details के लिए
place.idके साथ क्वेरी करनी होगी, ताकि आपको photo_reference मिल सके. इसके बाद, आपको अपने अनुभव के हिसाब से एक बार में एक क्वेरी करनी होगी

क्वेरी की संख्या और उनसे जुड़ी लागत
- Maps JavaScript API: अनुभव लोड होने पर एक मैप.
- Places Autocomplete API: टाइप किए गए हर वर्ण के लिए एक क्वेरी (अगर ऑटोकंप्लीट विजेट का इस्तेमाल किया जा रहा है), इसे पसंद के मुताबिक बनाया जा सकता है.
- आस-पास की जगहों की जानकारी (नया) API: दिखाई गई हर 20 जगहों के लिए एक क्वेरी. क्वेरी के जवाब में शामिल जगह की जानकारी वाले डेटा के हिसाब से अलग-अलग बिलिंग.
- Directions API: उपयोगकर्ता की चुनी गई हर जगह के लिए एक क्वेरी.
- Place Photo API: दिखाई गई हर फ़ोटो के लिए एक क्वेरी.
नतीजा
लोकल डिस्कवरी का अनुभव, उपयोगकर्ता को बेहतर वैल्यू देने का एक असरदार तरीका है. इस डेमो में कई ऐसी सुविधाएं शामिल हैं जिन्हें Google Maps Platform पर इस तरह का अनुभव बनाते समय शामिल किया जा सकता है. इसके लिए, आस-पास की जगहों की जानकारी (नया) API की खास सुविधाओं का इस्तेमाल किया जा सकता है.
अगले चरण
इस बारे में और पढ़ें:
- Maps JavaScript API में वेब कॉम्पोनेंट
- किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा को ऑप्टिमाइज़ करना
- Places की अन्य सेवाएं
- यहां सुझाव/राय दें या शिकायत करें.
योगदानकर्ता
मुख्य लेखक:
थॉमस ऐंगलरेट | Google Maps Platform के सलूशन इंजीनियर