परिचय
Places API एक ऐसी सेवा है जो अलग-अलग तरीकों से, जगह की जानकारी के डेटा के लिए एचटीटीपी अनुरोध स्वीकार करती है. यह फ़ॉर्मैट किया गया जगह की जानकारी का डेटा दिखाता है. साथ ही, यह कारोबारों, भौगोलिक जगहों या दिलचस्पी की खास जगहों की इमेज दिखाता है.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 (New) का इस्तेमाल करके किसी जगह या लोकप्रिय जगह के बारे में ज़्यादा जानकारी का अनुरोध किया जा सकता है. जैसे, उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता की रेटिंग, और समीक्षाएं.
Places API (नया प्रॉडक्ट) कैसे काम करता है
Places API (New), अनुरोधों को स्टैंडर्ड यूआरएल के तौर पर स्वीकार करता है. इसमें /places या places:searchText जैसे किसी खास सेवा एंडपॉइंट का इस्तेमाल किया जाता है. साथ ही, यह JSON फ़ॉर्मैट में जवाब देता है.
Places API (नया प्रॉडक्ट), एपीआई पासकोड और OAuth टोकन से पुष्टि करने की सुविधा के साथ काम करता है.
यहां दिए गए उदाहरण में, एपीआई पासकोड का इस्तेमाल करके किसी जगह के आईडी के लिए, पता कॉम्पोनेंट वापस पाने का अनुरोध किया गया है. इसके लिए, जगह के बारे में ज़्यादा जानकारी (नया) का इस्तेमाल किया गया है:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API (नया प्रॉडक्ट) का इस्तेमाल कैसे करें
यहां दिए गए तरीके में, Places API सेवा के इस्तेमाल का एक सामान्य उदाहरण दिया गया है. अपना समाधान बनाते समय, Nearby Search (नया) और Place Photos (नया) जैसे अतिरिक्त एंडपॉइंट इस्तेमाल किए जा सकते हैं.| 1 | सेट अप करना | बिलिंग सेट अप करें, Places API (नया वर्शन) चालू करें, और पहला अनुरोध करें. |
| 2 | टेक्स्ट की बुनियादी खोज करके देखें | टेक्स्ट खोज (नया) का इस्तेमाल करके, टेक्स्ट खोजें. |
| 3 | ज़्यादा जानकारी के लिए, जगह के आईडी का इस्तेमाल करना | Google Maps Platform के कई एपीआई, रिस्पॉन्स के तौर पर जगह का आईडी दिखाते हैं. जगह की जानकारी (नई) पाने के लिए, जगह के आईडी का इस्तेमाल करें. |
| 4 | किसी जगह की फ़ोटो पाना | Place Photos (नया) की मदद से, Places डेटाबेस में सेव की गई लाखों फ़ोटो ऐक्सेस की जा सकती हैं. किसी जगह की फ़ोटो ऐक्सेस करने के लिए, जगह की फ़ोटो (नई) का इस्तेमाल करें. |