Places API का इस्तेमाल क्यों करना चाहिए
अपने उपयोगकर्ताओं को जगह की ज़्यादा जानकारी वाला डेटा आसानी से उपलब्ध कराने के लिए, जगह के बारे में जानकारी देने वाली सुविधाएं बनाएं. Places API की मदद से जो डेटा उपलब्ध होता है उसे असल दुनिया के सबसे सटीक, अप-टू-डेट, और जगह की पूरी जानकारी वाले मॉडल में से एक के आधार पर बनाया गया है. यहां ऐप्लिकेशन के इस्तेमाल के उदाहरण दिए गए हैं:
- प्रमुख महानगरीय क्षेत्रों में ख़ास तौर पर शहरों को लक्षित परिणामों के साथ कोंडो रेंटल दिखाएं.
- पिकअप या डिलीवरी की स्थिति के अपडेट में जगह की जानकारी शामिल करें.
- किसी इलाके में पार्क की सूची दिखाएं. साथ ही, उपयोगकर्ताओं की सबमिट की गई फ़ोटो और समीक्षाओं को भी दिखाएं.
- यात्रा का प्लान बनाने वाले लोगों को संपर्क जानकारी, समीक्षाएं, और यात्रा के दौरान उपलब्ध सुविधाओं के लिए कीमत के लेवल की जानकारी दें.
Places API की मदद से क्या-क्या किया जा सकता है
अपने ऐप्लिकेशन में ये सुविधाएं शामिल करने के लिए, Places API का इस्तेमाल किया जा सकता है:
- उपयोगकर्ताओं की अलग-अलग तरह की क्वेरी से जगह के हिसाब से खोज के नतीजे देना. जैसे: टेक्स्ट इनपुट, आस-पास की जगहें, और उपयोगकर्ता की साफ़ तौर पर जानकारी देने वाली या कैटगरी से जुड़ी क्वेरी.
- अलग-अलग तरह की खोज के लिए, ऑटोकंप्लीट की सुविधाएं चालू करें. जैसे, खास टेक्स्ट क्वेरी या कैटगरी से जुड़ी क्वेरी.
- किसी जगह के खुले होने का समय, खास जानकारी, उपयोगकर्ता की समीक्षाएं, और फ़ोटो जैसी जानकारी को बेहतर बनाएं.
- उन स्थानों में अच्छी-क्वालिटी वाली फ़ोटो जोड़ें, जिन्हें आपका ऐप्लिकेशन उपलब्ध कराता है.
कई Google Maps Platform एपीआई जगह के आईडी का इस्तेमाल करते हैं, जहां जगह का आईडी, Google Places डेटाबेस और Google Maps पर किसी जगह की खास तौर पर पहचान करता है. जगह का आईडी पाने के कई तरीके हैं. इनमें Places API से भी आईडी मिल सकता है. हालांकि, Geocoding API, Routes API, और Address Validation API का इस्तेमाल किया जा सकता है.
जगह का आईडी मिलने के बाद, किसी खास जगह या पसंदीदा जगह के बारे में ज़्यादा जानकारी का अनुरोध करने के लिए, Places API का इस्तेमाल किया जा सकता है. जैसे, उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.
Places API का अपना वर्शन चुनें
Places API, एपीआई के दो वर्शन के साथ काम करता है: places API, मौजूदा एपीआई हैं और Place API (नया), एपीआई के अगली-पीढ़ी की टेक्नोलॉजी वाले वर्शन हैं.
Places 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 (नया प्रॉडक्ट) | ध्यान दें |
|---|---|---|
| जगह ढूंढें | टेक्स्ट खोज (नई सुविधा) | जगह ढूंढें का कोई नया वर्शन उपलब्ध नहीं है. टेक्स्ट सर्च (नया) ने इसकी जगह ले ली है. |
| आस-पास खोज | आस-पास खोजने की सुविधा (नया) | मौजूदा एपीआई का इस्तेमाल करने वाले ऐसे सभी अनुरोधों में Text Search (नया) का इस्तेमाल करना चाहिए जिनमें टेक्स्ट क्वेरी शामिल हो. इसकी वजह यह है कि आस-पास सर्च (नया) में टेक्स्ट इनपुट की सुविधा काम नहीं करती. |
| टेक्स्ट से खोजें | टेक्स्ट खोज (नई सुविधा) | |
| जगह की जानकारी | जगह की जानकारी (नई) | |
| जगह की फ़ोटो | जगह की फ़ोटो (नई) | |
| जगह की जानकारी के अपने-आप पूरे होने की सुविधा | ऑटोकंप्लीट की सुविधा (नई सुविधा) | |
| क्वेरी के लिए ऑटोकंप्लीट की सुविधा | ऑटोकंप्लीट की सुविधा (नई सुविधा) | ऑटोकंप्लीट की सुविधा में जोड़ी गई सुविधाएं (नई) |
Places API का इस्तेमाल कैसे करें
नीचे दिए गए चरण, Places API सेवा का इस्तेमाल करने के आम उदाहरण के बारे में बताते हैं. अपना समाधान बनाते समय, अतिरिक्त एंडपॉइंट का इस्तेमाल किया जा सकता है. जैसे, Nearby Search और जगह की फ़ोटो.| 1 | सेट अप करें | अपना Google Cloud प्रोजेक्ट सेट अप करें और दिए गए निर्देशों का पालन करें. इसके बाद, एपीआई पासकोड को इस्तेमाल करने का तरीका जानें. Places API (नए) के लिए, OAuth टोकन भी इस्तेमाल किया जा सकता है. |
| 2 | टेक्स्ट की मदद से सामान्य जानकारी खोजें | टेक्स्ट सर्च (नया) या टेक्स्ट सर्च का इस्तेमाल करके, सामान्य टेक्स्ट खोजने की सुविधा जारी करें. |
| 3 | ज़्यादा जानकारी के लिए, जगह के आईडी का इस्तेमाल करें | कई Google Maps Platform एपीआई जवाब के तौर पर एक जगह का आईडी दिखाते हैं. किसी जगह की जानकारी पाने के लिए, जगह का आईडी इस्तेमाल करें. जगह की जानकारी (नई) और जगह की जानकारी देखें. |
| 4 | किसी जगह की फ़ोटो पाना | स्थान फ़ोटो सेवा आपको जगहें डेटाबेस में संग्रहित लाखों फ़ोटो की ऐक्सेस देती है. किसी जगह की फ़ोटो ऐक्सेस करने के लिए, जगह की फ़ोटो (नई) या जगह की जानकारी का इस्तेमाल करें. |