खास जानकारी

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा
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 का इस्तेमाल किया जा सकता है. जैसे, उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.

Places API का अपना वर्शन चुनना

Places API, एपीआई के दो वर्शन के साथ काम करता है: Places API, एपीआई के मौजूदा वर्शन हैं और Places 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 या एक्सएमएल. सेवा का अनुरोध, दिखाए गए डेटा को बेहतर बनाने के लिए, उस एंडपॉइंट से जुड़े पैरामीटर का इस्तेमाल करता है. यहां दिए गए उदाहरण में, जगह की जानकारी का अनुरोध किया गया है, ताकि किसी जगह के आईडी के लिए पते के कॉम्पोनेंट को 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 (नया प्रॉडक्ट) ध्यान दें
जगह ढूंढना टेक्स्ट खोज (नया) 'जगह ढूंढें' सुविधा का कोई नया वर्शन उपलब्ध नहीं है. इसकी जगह, टेक्स्ट खोज (नया) सुविधा उपलब्ध है.
आस-पास की जगहों की जानकारी आस-पास की जगहों की जानकारी (नया) मौजूदा एपीआई का इस्तेमाल करके किए जाने वाले उन सभी अनुरोधों में, टेक्स्ट क्वेरी के लिए टेक्स्ट से खोजने की सुविधा (नया वर्शन) का इस्तेमाल किया जाना चाहिए, क्योंकि आस-पास खोजने की सुविधा (नया वर्शन) में टेक्स्ट इनपुट काम नहीं करता.
टेक्स्ट खोज टेक्स्ट खोज (नया)
जगह की जानकारी जगह की जानकारी (नया)
फ़ोटो जोड़ना Place Photo (नया)
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा ऑटोकंप्लीट (नया)
क्वेरी ऑटोकंप्लीट ऑटोकंप्लीट (नया) ऑटोकंप्लीट की सुविधा में जोड़ी गई नई सुविधाएं

Places API का इस्तेमाल करने का तरीका

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