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

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

लोकल डिस्कवरी अनुभव.

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

लोकल डिस्कवरी का सैंपल

इस्तेमाल के उदाहरण

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

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

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

    उस स्थान से संबंधित होता है.

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

    साथ ही, पैदल चलने में लगने वाला समय और दूरी की जानकारी दी जा सकती है.

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

alt_text

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

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

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

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

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

1. ऑटोकंप्लीट Search की मदद से, जगह की जानकारी खोजें

  • Maps JavaScript API लोड करें.
  • ऑटोकंप्लीट सुविधा के लिए क्वेरी या मैप पर जगह चुनें.

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

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

  • लोकप्रियता की रैंकिंग (ज़्यादा काम के नतीजे) या दूरी के लिए रैंकिंग.
  • includedTypes, excludedTypes ; अगर आप कोई होटल हैं, तो “ठहरने की जगह” टाइप को बाहर रखा जा सकता है और सिर्फ़ ज़रूरत के हिसाब से विकल्प शामिल किए जा सकते हैं. उदाहरण के लिए, “रेस्टोरेंट, कैफ़े, पार्क, टूरिट_आश्रय”.
  • नतीजों को और ज़्यादा कंट्रोल करने के लिए, includedPrimaryTypes, excludedPrimaryTypes का इस्तेमाल करें.
  • `जगह की जानकारी पर पाबंदी लगाना, ताकि बहुत कम नतीजों या बहुत दूर की जगहों से बचा जा सके. अगर कोई नतीजा नहीं मिला, तो नतीजे दिखाने से पहले, सर्कल / रेक्टैंगल के साइज़ को बड़ा कर दें.

आस-पास की जगहों के नमूने

डेटा फ़ील्ड के साथ होटल बुक करते समय क्वेरी का सैंपल:

  • सामान्य (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. डाइनैमिक मैप और निर्देश एपीआई की मदद से इंटरैक्टिविटी जोड़ना

  • दिशा-निर्देश एपीआई पर क्वेरी करके, लेग और कदमों की अप-टू-डेट जानकारी पाएं. * अगले सेक्शन में दिए गए समय का इस्तेमाल करें.

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

4. इंटरैक्शन होने पर स्थान की विस्तृत जानकारी दिखाएं

  1. जानकारी: displayName, types, rating, userRatingCount, priceLevel.

    समय: पिछली 'दिशा-निर्देश' एपीआई क्वेरी से मिला है.

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

  3. इमेज: आस-पास खोज की सुविधा (नया) एपीआई की बिना पाबंदी के झलक दिखाने की सुविधा के दौरान, आपको जगह की जानकारी के लिए place.id की मदद से क्वेरी करनी होगी, ताकि आप photo_reference को पा सकें. इसके बाद, अपने अनुभव के हिसाब से एक-एक करके क्वेरी करें

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

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

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

नतीजा

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

अगले चरण

आगे पढ़ने के लिए सुझाव:

योगदानकर्ता

मुख्य लेखक:

थॉमस एंगलरेट | Google Maps प्लैटफ़ॉर्म सलूशन इंजीनियर