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