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

इस दस्तावेज़ में, Nearby Search (New) API का इस्तेमाल करके, आसान और किफ़ायती

स्थानीय खोज की सुविधा चालू करें.

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

स्थानीय खोज का सैंपल

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

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

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

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

    उस जगह के हिसाब से.

  • विज़ुअलाइज़ेशन - जगहों की समीक्षाएं और फ़ोटो उपलब्ध कराएं

    साथ ही, पैदल चलने का समय और दूरी भी दिखानी चाहिए, ताकि लोग यह तुरंत समझ सकें कि यह उनके लिए सही है या नहीं.

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

alt_text

आस-पास की जगहों की खोज

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

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

सिलसिलेवार तरीके से दिए गए निर्देशों का सैंपल

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

1. जगह के नाम के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के साथ जगह की जानकारी खोजना

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

ऑटोकंप्लीट का सैंपल

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

  • लोकप्रियता के हिसाब से रैंकिंग (ज़्यादा काम के नतीजे) या दूरी के हिसाब से रैंकिंग.
  • includedTypes, excludedTypes ; अगर आप होटल हैं, तो “lodging” टाइप को बाहर रखा जा सकता है. साथ ही, सिर्फ़ सही टाइप शामिल किए जा सकते हैं. जैसे: “restaurant, cafe, park, tourit_attraction”.
  • नतीजों पर ज़्यादा कंट्रोल पाने के लिए, includedPrimaryTypes, excludedPrimaryTypes का इस्तेमाल करें.
  • `locationRestriction to avoid insufficient number of results or too far away places ; in case of ZERO results, broaden the circle / rectangle size prior to display results.

आस-पास की जगहों का सैंपल

डेटा फ़ील्ड के लिए अनुरोध करते समय, होटल बुक करने के लिए क्वेरी का सैंपल:

  • बेसिक (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. इंटरैक्शन करने पर, जगह की ज़्यादा जानकारी दिखाना

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

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

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

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

जगहों की जानकारी

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

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

नतीजा

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

अगले चरण

इस बारे में और पढ़ें:

योगदानकर्ता

मुख्य लेखक:

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