Places API का इस्तेमाल क्यों करना चाहिए
अपने उपयोगकर्ताओं को जगह की ज़्यादा जानकारी वाला डेटा आसानी से उपलब्ध कराने के लिए, जगह के बारे में जानकारी देने वाली सुविधाएं बनाएं. Places API के ज़रिए उपलब्ध डेटा को सबसे सटीक, अप-टू-डेट, और वास्तविक दुनिया के व्यापक स्थान मॉडल हैं. यहां ऐप्लिकेशन के इस्तेमाल के उदाहरण दिए गए हैं:
- प्रमुख महानगरीय क्षेत्रों में ख़ास तौर पर शहरों को लक्षित परिणामों के साथ कोंडो रेंटल दिखाएं.
- पिकअप या डिलीवरी की स्थिति के अपडेट में जगह की जानकारी शामिल करें.
- किसी इलाके में पार्क की सूची दिखाएं. साथ ही, उपयोगकर्ताओं की सबमिट की गई फ़ोटो और समीक्षाओं को भी दिखाएं.
- यात्रा का प्लान बनाने वाले लोगों को संपर्क जानकारी, समीक्षाएं, और यात्रा के दौरान उपलब्ध सुविधाओं के लिए कीमत के लेवल की जानकारी दें.
Places API की मदद से क्या-क्या किया जा सकता है
आप अपने इसमें निम्न सुविधाओं को शामिल करने के लिए Places API का उपयोग कर सकते हैं ऐप्लिकेशन:
- उपयोगकर्ताओं की अलग-अलग तरह की क्वेरी के लिए, जगह के हिसाब से खोज के नतीजे उपलब्ध कराएं. जैसे: टेक्स्ट इनपुट, आस-पास की जगहों की जानकारी, और उपयोगकर्ता की अस्पष्ट या कैटगरी वाली क्वेरी.
- अलग-अलग तरह की सर्च क्वेरी के लिए, ऑटोकंप्लीट की सुविधा चालू करें या कैटगरी से जुड़ी क्वेरी होती हैं.
- किसी जगह के बारे में मिलने वाली जानकारी को बेहतर बनाता है. जैसे, कारोबार के खुले होने का समय, खास जानकारी, उपयोगकर्ता समीक्षाएं, और एक फ़ोटो.
- उन स्थानों में अच्छी-क्वालिटी वाली फ़ोटो जोड़ें, जिन्हें आपका ऐप्लिकेशन उपलब्ध कराता है.
Google Maps Platform के कई एपीआई पर जगह का आईडी, जहां जगह का खास आईडी मौजूद हो Google स्थल डेटाबेस और Google मैप पर किसी स्थान की पहचान करता है. जगह का आईडी पाने के कई तरीके हैं. इनमें Places API से भी आईडी मिल सकता है. हालांकि, Geocoding API, Routes API, और Address Validation API का इस्तेमाल किया जा सकता है.
स्थान आईडी मिलने के बाद, आप इसके बारे में अधिक विवरण का अनुरोध करने के लिए Places API का उपयोग कर सकते हैं कोई विशेष संस्थान या पसंदीदा स्थान, जैसे कि उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं शामिल हैं.
Places API का अपना वर्शन चुनें
Places API दो एपीआई वर्शन के साथ काम करता है: place API मौजूदा API और Place API (नया) एपीआई के अगली-पीढ़ी की टेक्नोलॉजी वाले वर्शन हैं.
Places API (नया वर्शन) के रिलीज़ होने के बाद, आपको सबसे पहले यह तय करना होगा कि सेट अप करना है. अगर आप नए ग्राहक हैं या मौजूदा ग्राहक पहले से ही API का उपयोग कर रहा है. इस्तेमाल की जाने वाली चीज़ें इस गाइड में बताया गया है कि दो एपीआई के बीच अंतर.
Places API कैसे काम करता है
Places API (नया प्रॉडक्ट)
Places API (नया वर्शन), किसी खास यूआरएल के साथ स्टैंडर्ड यूआरएल के तौर पर अनुरोधों को स्वीकार करता है
सेवा एंडपॉइंट, जैसे कि /places
या places:searchText
और JSON रिस्पॉन्स देता है. Places API (नया) इसके द्वारा प्राधिकरण का समर्थन करता है
एपीआई कुंजी और OAuth टोकन.
नीचे दिए गए उदाहरण में, एक जगह के लिए पते के कॉम्पोनेंट दिखाने का अनुरोध किया गया है
जगह का आईडी:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API, अनुरोधों को स्टैंडर्ड यूआरएल के तौर पर स्वीकार करता है. इसमें,
सेवा एंडपॉइंट, जैसे कि /place
या /photo
. एंडपॉइंट भी
अनुरोध में तय किए गए फ़ॉर्मैट के टाइप को स्वीकार करें, जैसे कि JSON या XML. सेवा
अनुरोध भेजे गए डेटा को बेहतर बनाने के लिए, उस खास एंडपॉइंट से जुड़े पैरामीटर का इस्तेमाल करता है.
नीचे दिए गए उदाहरण में, एक जगह के लिए पते के कॉम्पोनेंट दिखाने का अनुरोध किया गया है
JSON फ़ॉर्मैट में जगह का आईडी:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
इस मामले में, अनुरोध की गई जगह को ढूंढने के लिए, सेवा दिए गए जगह के आईडी का इस्तेमाल करती है और JSON फ़ॉर्मैट में पते के कॉम्पोनेंट दिखाता है.
संसाधन
यहां दी गई टेबल में, Places API.
Places API | Places API (नया प्रॉडक्ट) | ध्यान दें |
---|---|---|
जगह ढूंढें | टेक्स्ट खोज (नई सुविधा) | जगह ढूंढें का कोई नया वर्शन उपलब्ध नहीं है. टेक्स्ट सर्च (नया) ने इसकी जगह ले ली है. |
आस-पास खोज | आस-पास खोजने की सुविधा (नया) | टेक्स्ट क्वेरी वाले मौजूदा एपीआई का इस्तेमाल करने वाले सभी अनुरोधों को टेक्स्ट खोज (नई सुविधा) क्योंकि Nearby Search (नया) में टेक्स्ट इनपुट काम नहीं करता. |
टेक्स्ट से खोजें | टेक्स्ट खोज (नई सुविधा) | |
जगह की जानकारी | जगह की जानकारी (नई) | |
जगह की फ़ोटो | जगह की फ़ोटो (नई) | |
जगह की जानकारी के अपने-आप पूरे होने की सुविधा | ऑटोकंप्लीट की सुविधा (नई सुविधा) | |
क्वेरी के लिए ऑटोकंप्लीट की सुविधा | ऑटोकंप्लीट की सुविधा (नई सुविधा) | ऑटोकंप्लीट की सुविधा में जोड़ी गई सुविधाएं (नई) |
Places API का इस्तेमाल कैसे करें
नीचे दिए गए चरण, Places API सेवा का इस्तेमाल करने के आम उदाहरण के बारे में बताते हैं. जैसे-जैसे आप टास्क तैयार करते हैं समाधान के लिए, अतिरिक्त एंडपॉइंट का इस्तेमाल किया जा सकता है. जैसे, Nearby Search और जगह की फ़ोटो.1 | सेट अप करना | सबसे पहले अपना Google Cloud प्रोजेक्ट पर जाएं और सेटअप के निर्देशों को पूरा करें. इसके बाद, एपीआई पासकोड इस्तेमाल करने का तरीका जानें. Places API (नया वर्शन) के लिए, इस्तेमाल किया जा सकता है OAuth टोकन. |
2 | टेक्स्ट की मदद से सामान्य जानकारी खोजें | टेक्स्ट खोज (नया) का इस्तेमाल करके आसान टेक्स्ट खोज जारी करें या टेक्स्ट खोजें. |
3 | ज़्यादा जानकारी के लिए, जगह के आईडी का इस्तेमाल करें | कई Google Maps Platform एपीआई जवाब के तौर पर एक जगह का आईडी दिखाते हैं. इसका इस्तेमाल करें स्थान आईडी का उपयोग करें. जगह की जानकारी (नई) और जगह की जानकारी देखें. |
4 | किसी जगह की फ़ोटो पाना | स्थान फ़ोटो सेवा आपको Places में संग्रहित लाखों फ़ोटो की ऐक्सेस देती है डेटाबेस. जगह की फ़ोटो (नई) का इस्तेमाल करें या जगह की जानकारी किसी जगह की फ़ोटो ऐक्सेस करने के लिए. |