Nearby Search (नया) एपीआई की मदद से, आस-पास की जगहें खोजने की सुविधा को बेहतर बनाएं

इस दस्तावेज़ में, आस-पास खोजने की सुविधा (नया) एपीआई का इस्तेमाल करने का तरीका बताया गया है. इससे, आसान और कम खर्चीली

स्थानीय खोज के अनुभव को बेहतर बनाता है.

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

उपयोग के उदाहरण

अब यह समझते हैं कि लोकल डिस्कवरी इंटिग्रेशन के कौनसे एलिमेंट, उपयोगकर्ता के लिए फ़ायदेमंद हैं:

• डिस्कवरी - उपयोगकर्ताओं को किसी एक जगह के आस-पास मौजूद जगहों की खास जानकारी दें. इसके लिए, अलग-अलग तरह की काम की जगहें दिखाएं.

• इंटरैक्टिविटी - उपयोगकर्ताओं को कोई जगह चुनने और डेटा को डाइनैमिक रीफ़्रेश करने की सुविधा देना

  की जानकारी मिलती है.

• विज़ुअलाइज़ेशन - जगहों की समीक्षाएं, फ़ोटो दें

  और पैदल चलने में लगने वाला समय और दूरी की जानकारी दी जाती है, ताकि उपयोगकर्ता तुरंत समझ सकें कि यह जगह उनकी ज़रूरतों के हिसाब से है या नहीं.

रेफ़रंस आर्किटेक्चर

लोकल डिस्कवरी

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

नमूना एप्लिकेशन

सिलसिलेवार निर्देश का सैंपल

यहां दी गई टेबल में, आपको ऐप्लिकेशन का सैंपल मिलेगा. इसे चरणों में बांटा गया है. साथ ही, इसमें Google Maps Platform के एपीआई के साथ तकनीकी तरीके से लागू करने के बारे में जानकारी भी दी गई है.

1. ऑटोकंप्लीट की सुविधा के साथ जगह की खोज करना

• Maps JavaScript API लोड करें.
• जगहों के नाम अपने-आप पूरे होने की सुविधा का इस्तेमाल करके क्वेरी डालें या मैप पर जगह चुनें.

2. Nearby Search (नया) एपीआई का इस्तेमाल करके, आस-पास की लोकप्रिय जगहों की जानकारी दिखाना

• लोकप्रियता के हिसाब से रैंकिंग (ज़्यादा काम के नतीजे) या दूरी के हिसाब से रैंकिंग.
• includedTypes, excludedTypes ; अगर आपका कारोबार होटल है, तो आपके पास “lodging” टाइप को बाहर रखने का विकल्प है. साथ ही, सिर्फ़ अपने कारोबार के हिसाब से टाइप शामिल किए जा सकते हैं, जैसे कि “restaurant, cafe, park, tourit_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. डाइनैमिक Maps और Directions API की मदद से, इंटरैक्टिविटी जोड़ना

• Directions API से क्वेरी करके, अप-टू-डेट पैर और चरण की जानकारी पाएं. * अगले सेक्शन में समय का इस्तेमाल करें.

4. इंटरैक्शन करने पर, जगह की पूरी जानकारी दिखाना

1. ब्यौरा: displayName, types, rating, userRatingCount, priceLevel.

   समय: यह Directions API की पिछली क्वेरी से मिलता है.

2. समीक्षाएं: reviews[i].author, reviews[i].rating,reviews[i].text.

3. इमेज: Nearby Search (नया) API की बिना पाबंदी वाली झलक के दौरान, आपको photo_reference पाने के लिए, place.id के साथ जगहों की जानकारी के लिए क्वेरी करनी होगी. इसके बाद, एक बार में एक क्वेरी की जा सकती है

क्वेरी की संख्या और उससे जुड़ी लागत

• Maps JavaScript API: इस्तेमाल करने के दौरान एक मैप लोड होता है.
• Places Autocomplete API: टाइप किए गए हर वर्ण के लिए एक क्वेरी (अगर ऑटोकंप्लीट विजेट का इस्तेमाल किया जा रहा है), इसे पसंद के मुताबिक बनाया जा सकता है.
• आस-पास की जगहें खोजने की सुविधा (नया) का एपीआई: दिखाई गई हर 20 जगहों के लिए एक क्वेरी. क्वेरी के जवाब में शामिल जगह के डेटा के हिसाब से अलग-अलग बिलिंग.
• Directions API: उपयोगकर्ता की चुनी गई हर जगह के लिए एक क्वेरी.
• Place Photo API: दिखाई गई हर फ़ोटो के लिए एक क्वेरी.

नतीजा

लोकल डिस्कवरी का अनुभव, उपयोगकर्ताओं को बेहतर अनुभव देने का एक बेहतरीन तरीका है. इस उदाहरण में कई ऐसी सुविधाएं हैं जिन्हें Google Maps Platform पर इस तरह का अनुभव बनाने के लिए शामिल किया जा सकता है. इसके लिए, आस-पास खोजने की सुविधा (नया) एपीआई की खास सुविधाओं का इस्तेमाल किया जा सकता है.

अगले चरण

इसके बारे में और पढ़ने के लिए:

• Maps JavaScript API में वेब कॉम्पोनेंट
• जगहों के लिए ऑटोकंप्लीट की सुविधा को ऑप्टिमाइज़ करना
• Places की अन्य सेवाएं
• नीचे सुझाव/राय दें या शिकायत करें.

योगदानकर्ता

मुख्य लेखक:

थॉमस ऐंगलरेट | Google Maps Platform के समाधान इंजीनियर