Places API (लेगसी) के बारे में खास जानकारी

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

Places API की मदद से, टेक्स्ट स्ट्रिंग या आस-पास की जगहों के आधार पर, अलग-अलग तरह की जगहों को खोजा जा सकता है और उनकी जानकारी हासिल की जा सकती है. Places API (लेगसी), Places API (नया) का लेगसी वर्शन है.

यहां दी गई टेबल में, दोनों एपीआई के मिलते-जुलते वर्शन की सूची दी गई है. इस गाइड का इस्तेमाल करके, दोनों के बीच के मुख्य अंतर को समझें और Places API (नया) पर माइग्रेट करें.

Places API (लेगसी) Places API (नया प्रॉडक्ट) नोट
Find Place (लेगसी) टेक्स्ट से खोजें (नया) Find Place (लेगसी) का कोई नया वर्शन नहीं है. इसकी जगह, टेक्स्ट से खोजें (नया) सुविधा का इस्तेमाल किया जा रहा है.
आस-पास की जगहों की जानकारी (लेगसी) आस-पास की जगहों की जानकारी (नया वर्शन) लेगसी एपीआई का इस्तेमाल करने वाले उन सभी अनुरोधों में टेक्स्ट से खोजें (नया वर्शन) का इस्तेमाल किया जाना चाहिए जिनमें टेक्स्ट क्वेरी शामिल होती है. ऐसा इसलिए, क्योंकि आस-पास की जगहों की जानकारी (नया वर्शन) में टेक्स्ट इनपुट का इस्तेमाल नहीं किया जा सकता.
टेक्स्ट से खोजें (लेगसी) टेक्स्ट से खोजें (नया)
जगह की जानकारी (लेगसी) Place Details (New)
Place Photos (लेगसी) Place Photos (नया)
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) ऑटोकंप्लीट (नया)
Query Autocomplete (लेगसी) ऑटोकंप्लीट (नया) ऑटोकंप्लीट (नया) में जोड़ी गई सुविधाएं.

नए एपीआई पर माइग्रेट करना

नए एपीआई पर माइग्रेट करने के लिए, माइग्रेट करने से जुड़ी ये गाइड देखें:

Places API (नया वर्शन) में जोड़ी गई मुख्य सुविधाएं

इस सेक्शन में, Places API (नया) में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है.

Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू किया गया

Places API (नया) को Google Cloud पर सेवा के इन्फ़्रास्ट्रक्चर पर लागू किया गया है. इस बदलाव से, आपको ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म मिलेगा. साथ ही, आपको OAuth जैसी बेहतर सुरक्षा सुविधाएं भी मिलेंगी. यह स्टैंडर्ड एपीआई डिज़ाइन, सभी एपीआई में एक जैसा अनुभव देता है. इससे Places API (नया) की मदद से डेवलपमेंट की प्रोसेस को बेहतर बनाने में मदद मिलती है.

बेहतर परफ़ॉर्मेंस

Places API (नया) बेहतर परफ़ॉर्मेंस देता है. इसलिए, मौजूदा Places API का इस्तेमाल करने वाले ऐप्लिकेशन को नए वर्शन पर माइग्रेट करना फ़ायदेमंद है.

कीमत तय करने का आसान तरीका

Places API (नया) की मदद से, कीमत तय करने की प्रोसेस को आसान बनाया गया है. इससे आपको सिर्फ़ उस डेटा के लिए पैसे चुकाने होंगे जिसका इस्तेमाल किया जाता है. आसान कीमत तय करने की सुविधा को फ़ील्ड मास्क का इस्तेमाल करके लागू किया जाता है.

Place Details (New), आस-पास की जगहों की जानकारी (New), और टेक्स्ट से खोजें (New) की मदद से, फ़ील्ड मास्क का इस्तेमाल करके, जवाब में दिखाए जाने वाले फ़ील्ड की सूची को कंट्रोल किया जा सकता है. इसके बाद, आपसे सिर्फ़ अनुरोध किए गए डेटा के लिए शुल्क लिया जाता है. फ़ील्ड मास्किंग का इस्तेमाल करना, डिज़ाइन करने का एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने ग़ैर-ज़रूरी डेटा का अनुरोध न किया हो. इससे, प्रोसेसिंग में लगने वाले ग़ैर-ज़रूरी समय और बिलिंग शुल्क से बचने में मदद मिलती है.

किसी जगह के लिए, एक जैसा रिस्पॉन्स डेटा

लेगसी एपीआई के साथ, जगह के बारे में ज़्यादा जानकारी (लेगसी), आस-पास की जगहों की जानकारी (लेगसी), और टेक्स्ट से खोजें (लेगसी) एपीआई, किसी जगह के लिए अलग-अलग रिस्पॉन्स डेटा दिखाते थे. Places API (नया) रिस्पॉन्स को स्टैंडर्ड बनाता है, ताकि ये सभी एपीआई किसी जगह के लिए एक जैसा डेटा दिखाएं.

जगहों के टाइप की ज़्यादा जानकारी

एपीआई से मिली जानकारी में अब किसी जगह का मुख्य टाइप शामिल हो सकता है. हर जगह के लिए, टाइप की एक वैल्यू हो सकती है. इसे जगह के प्राइमरी टाइप के तौर पर तय किया जाता है. इसके बारे में टेबल A में बताया गया है.

एपीआई के नए वर्शन में कई नए टाइप भी शामिल हैं. आस-पास की जगहों की जानकारी (नया वर्शन) और टेक्स्ट से खोजें (नया वर्शन) सुविधा का इस्तेमाल करके, इन नए टाइप और मौजूदा टाइप को खोजा जा सकता है. सभी नए टाइप, टेबल A में शामिल हैं.

जगह की जानकारी का डाइनैमिक डेटा

Places API (New) में डाइनैमिक रिस्पॉन्स डेटा की सुविधा काम करती है. जैसे, ईवी चार्जिंग स्टेशन की उपलब्धता या किसी पेट्रोल पंप पर ईंधन की मौजूदा कीमतें. इन रिस्पॉन्स फ़ील्ड का इस्तेमाल करके, उपयोगकर्ताओं को डाइनैमिक अनुभव दें.