खास जानकारी

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 या places:searchText के साथ स्टैंडर्ड यूआरएल के तौर पर अनुरोध स्वीकार करता है और JSON रिस्पॉन्स दिखाता है. Places API (नया वर्शन), एपीआई पासकोड और OAuth टोकन की मदद से अनुमति देता है. यहां दिए गए उदाहरण में, एपीआई पासकोड का इस्तेमाल करके किसी जगह के आईडी के लिए पते के कॉम्पोनेंट दिखाने के लिए, जगह की जानकारी (नया) का अनुरोध किया गया है:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

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