इस दस्तावेज़ में, Nearby Search (नया) एपीआई इस्तेमाल करने का तरीका बताया गया है में इसे आसान और किफ़ायती टूल उपलब्ध कराएं
स्थानीय खोज के अनुभव को बेहतर बनाता है.
लोकल डिस्कवरी अनुभव, किसी जगह के आस-पास मौजूद उपयोगकर्ताओं की पसंदीदा जगहों को दिखाता है किसी होटल या रीयल एस्टेट के लिए खोज करते समय आपके तय किए गए विकल्प को दिखाता है. इसमें अक्सर एक इंटरैक्टिव मैप, जिसमें एक अतिरिक्त पैनल होता है. इसमें जगह चुनने का विकल्प और फ़ोटो की गैलरी में से चुनें. आपको Google Maps Platform के अलग-अलग विकल्प दिखाए जाएंगे इंटरैक्टिविटी के साथ अनुभव को बेहतर बनाने के लिए प्रॉडक्ट और सुविधाएं दी गई हैं.
उपयोग के उदाहरण
आइए, अब जानते हैं कि लोकल डिस्कवरी इंटिग्रेशन के कौनसे एलिमेंट, उपयोगकर्ता को बढ़ावा देते हैं मान:
खोज - उपयोगकर्ताओं को किसी एक जगह के आस-पास की चीज़ों की खास जानकारी दें इसके लिए, अलग-अलग तरह की काम की जगहों को दिखाया जा सकता है.
इंटरैक्टिविटी - उपयोगकर्ताओं को कोई जगह चुनने और डेटा को डाइनैमिक रीफ़्रेश करने की सुविधा देना
की जानकारी मिलती है.
विज़ुअलाइज़ेशन - जगहों की समीक्षाएं, फ़ोटो दें
और पैदल चलने में लगने वाला समय और दूरी की जानकारी दी जाती है, ताकि उपयोगकर्ता तुरंत समझ सकें कि यह जगह उनकी ज़रूरतों के हिसाब से है या नहीं.
रेफ़रंस आर्किटेक्चर
लोकल डिस्कवरी
स्थानीय खोज अनुभव बनाने के कई तरीके हैं. नीचे दिए गए इंटिग्रेशन, उपयोगकर्ता अनुभव का पसंद के मुताबिक बनाया गया उदाहरण है, जो अच्छी तरह से काम करता है साथ ही, कुछ दिलचस्प नई सुविधाएं भी दी हैं. अगर आपको स्थानीय खोज के लिए एक टेम्प्लेट वाला तरीका चाहते हैं तो आप वेब कॉम्पोनेंट.
नमूना एप्लिकेशन
सिलसिलेवार निर्देश का सैंपल
नीचे दी गई टेबल में, आपको ऐप्लिकेशन का सैंपल मिलेगा. इसमें, Google Maps Platform के एपीआई के साथ तकनीकी तरीके से लागू करने के बारे में जानकारी के साथ-साथ, चरणों के हिसाब से ऐप्लिकेशन का सैंपल भी मिलेगा.
1. ऑटोकंप्लीट की सुविधा के साथ जगह की खोज करना
- Maps JavaScript API लोड करें.
- ऑटोकंप्लीट सुविधा के लिए क्वेरी या मैप पर जगह चुनें.
2. Nearby Search (नया) एपीआई का इस्तेमाल करके, आस-पास की लोकप्रिय जगहों की जानकारी दिखाना
- लोकप्रियता के हिसाब से रैंकिंग (ज़्यादा काम के नतीजे) या दूरी के हिसाब से रैंकिंग.
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. डाइनैमिक Maps और Directions API की मदद से, इंटरैक्टिविटी जोड़ना
- दिशा-निर्देशों की क्वेरी करके, अप-टू-डेट लेग और कदम API. * अगले सेक्शन में दिए गए समय का इस्तेमाल करें.
4. इंटरैक्शन होने पर स्थान की विस्तृत जानकारी दिखाएं
ब्यौरा:
displayName
,types
,rating
,userRatingCount
,priceLevel
.समय: पिछली 'दिशा-निर्देश' एपीआई क्वेरी से मिला है.
समीक्षाएं:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.इमेज: Nearby Search (नया) API की बिना पाबंदी वाली झलक के दौरान, आपको photo_reference पाने के लिए,
place.id
के साथ जगहों की जानकारी के लिए क्वेरी करनी होगी. इसके बाद, एक बार में एक क्वेरी की जा सकती है
क्वेरी की संख्या और उनसे जुड़ी लागत
- Maps JavaScript API: ऐप्लिकेशन लोड होने पर एक मैप.
- Places ऑटोकंप्लीट एपीआई: टाइप किए गए हर वर्ण के लिए 1 क्वेरी (अगर एपीआई का इस्तेमाल किया जा रहा है ऑटोकंप्लीट विजेट), उसे कस्टमाइज़ किया जा सकता है.
- आस-पास की जगहें खोजने की सुविधा (नया) का एपीआई: दिखाई गई हर 20 जगहों के लिए एक क्वेरी. जगह के मुताबिक अलग-अलग बिलिंग डेटा जो क्वेरी के जवाब का हिस्सा हों.
- Directions API: उपयोगकर्ता की चुनी गई हर जगह के लिए एक क्वेरी.
- जगह की फ़ोटो एपीआई: दिखाई जाने वाली हर फ़ोटो के लिए 1 क्वेरी.
नतीजा
लोकल डिस्कवरी अनुभव, उपयोगकर्ताओं की ज़रूरतों को पूरा करने का एक बेहतरीन तरीका है. इस उदाहरण में कई ऐसी सुविधाएं हैं जिन्हें आस-पास खोजने की सुविधा (नया) एपीआई की खास सुविधाओं के साथ, Google Maps Platform पर ऐसा अनुभव बनाते समय शामिल किया जा सकता है.
अगले चरण
आगे पढ़ने के लिए सुझाव:
- Maps JavaScript API में वेब कॉम्पोनेंट
- जगहों के नाम के लिए ऑटोकंप्लीट की सुविधा को ऑप्टिमाइज़ करना
- Places की अन्य सेवाएं
- यहां सुझाव/राय दें या शिकायत करें.
योगदानकर्ता
मुख्य लेखक:
थॉमस एंगलरेट | Google मैप प्लैटफ़ॉर्म सलूशन इंजीनियर