परिचय
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 सेवा के इस्तेमाल का एक सामान्य उदाहरण दिया गया है. अपना समाधान बनाते समय, आस-पास की जगहों की जानकारी (नया) और Place Photos (नया) जैसे अतिरिक्त एंडपॉइंट इस्तेमाल किए जा सकते हैं.| 1 | सेट अप करना | बिलिंग सेट अप करें, Places API (नया वर्शन) चालू करें, और पहला अनुरोध करें. |
| 2 | टेक्स्ट की बुनियादी खोज करके देखें | टेक्स्ट से खोजें (नई सुविधा) का इस्तेमाल करके, टेक्स्ट से खोजें. |
| 3 | ज़्यादा जानकारी के लिए, जगह के आईडी का इस्तेमाल करना | Google Maps Platform के कई एपीआई, रिस्पॉन्स के तौर पर जगह का आईडी दिखाते हैं. जगह की जानकारी (नया) पाने के लिए, जगह के आईडी का इस्तेमाल करें. |
| 4 | किसी जगह की फ़ोटो पाना | Place Photos (नया) की मदद से, Places डेटाबेस में सेव की गई लाखों फ़ोटो ऐक्सेस की जा सकती हैं. किसी जगह की फ़ोटो ऐक्सेस करने के लिए, जगह की फ़ोटो (नई) का इस्तेमाल करें. |