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