परिचय
Places API की मदद से, अलग-अलग तरह की जगहों की जानकारी खोजी और वापस पाई जा सकती है. इसके लिए, टेक्स्ट स्ट्रिंग का इस्तेमाल किया जा सकता है या आस-पास की जगहों को खोजा जा सकता है. Places API (लेगसी), Places API (नया प्रॉडक्ट) का लेगसी वर्शन है.
यहां दी गई टेबल में, दोनों एपीआई के वर्शन दिए गए हैं. इस गाइड का इस्तेमाल करके, दोनों के बीच के मुख्य अंतरों को समझें और Places API (नया) पर माइग्रेट करें.
| Places API (लेगसी) | Places API (नया प्रॉडक्ट) | नोट |
|---|---|---|
| जगह ढूंढें (लेगसी) | टेक्स्ट खोज (नई सुविधा) | 'जगह ढूंढें (लेगसी वर्शन)' का कोई नया वर्शन उपलब्ध नहीं है. इसकी जगह, टेक्स्ट सर्च (नया) सुविधा उपलब्ध है. |
| आस-पास की जगहों की जानकारी (लेगसी) | आस-पास की जगहों की जानकारी (नई सुविधा) | लेगसी एपीआई का इस्तेमाल करके किए गए ऐसे सभी अनुरोधों में टेक्स्ट से खोजने की सुविधा (नई) का इस्तेमाल किया जाना चाहिए जिनमें टेक्स्ट क्वेरी शामिल है. ऐसा इसलिए, क्योंकि आस-पास खोजने की सुविधा (नई) में टेक्स्ट इनपुट करने की सुविधा काम नहीं करती. |
| टेक्स्ट खोज (लेगसी) | टेक्स्ट खोज (नई सुविधा) | |
| जगह की जानकारी (लेगसी) | जगह की जानकारी (नया) | |
| जगह की फ़ोटो (लेगसी) | जगह की फ़ोटो (नई) | |
| जगह के नाम के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) | ऑटोकंप्लीट (न��ा) | |
| ��्��ेरी ��पने-आप पूरी होने की सुविधा (लेगसी) | ऑटोकंप्लीट (नया) | ऑटोकंप्लीट (नई) सुविधा में जोड़ी गई क्षमताएं. |
नए एपीआई पर माइग्रेट करना
नए एपीआई पर माइग्रेट करने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी ये गाइड देखें:
- आस-पास की जगहों की जानकारी (नया) पर माइग्रेट करना
- टेक्स्ट खोज (नया) पर माइग्रेट करना
- जगह की जानकारी (नई) पर माइग्रेट करें
- जगह की फ़ोटो (नई) पर माइग्रेट करना
- ऑटोकंप्लीट (नया) पर माइग्रेट करना
Places API (नया प्रॉडक्ट) में जोड़ी गई मुख्य सुविधाएं
इस सेक्शन में, Places API (New) में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है.
Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू किया गया
Places API (नया वर्शन), Google Cloud पर सेवा के इंफ़्रास्ट्रक्चर पर लागू किया जाता है. इस बदलाव के बाद, आपको ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म मिलेगा. साथ ही, आपको OAuth जैसे बेहतर सुरक्षा विकल्प भी मिलेंगे. इस स्टैंडर्ड एपीआई डिज़ाइन से, सभी एपीआई में एक जैसा अनुभव मिलता है. इससे Places API (नया) की मदद से डेवलपमेंट की प्रोसेस को बेहतर बनाया जा सकता है.
बेहतर परफ़ॉर्मेंस
Places API (नया) बेहतर परफ़ॉर्मेंस देता है. इसलिए, मौजूदा Places API का इस्तेमाल करने वाले ऐप्लिकेशन को इससे बदलना फ़ायदेमंद है.
आसान कीमत
Places API (नया) की मदद से, कीमत तय करने की प्रोसेस को आसान बनाया गया है, ताकि आप सिर्फ़ उस डेटा के लिए पेमेंट करें जिसका इस्तेमाल किया जाता है. कीमत तय करने की आसान सुविधा को field mask का इस्तेमाल करके लागू किया जाता है.
जगह की जानकारी (नई), आस-पास खोजने की सुविधा (नई), और टेक्स्ट से खोजने की सुविधा (नई) के साथ, फ़ील्ड मास्क का इस्तेमाल करके, जवाब में ��िखाए जाने वाले फ़ील्ड की सूची को कंट्रोल किया जाता है. इसके बाद, आपसे सिर्फ़ उस डेटा के लिए शुल्क लिया जाता है जिसका अनुरोध किया गया है. फ़ील्ड मास्किंग का इस्तेमाल करना, डिज़ाइन के लिहाज़ से सबसे सही तरीका है. इससे यह पक्का किया जा सकता है कि आपने बिना ज़रूरत के डेटा का अनुरोध न किया हो. इससे, प्रोसेसिंग में लगने वाले समय और बिलिंग के शुल्क को कम करने में मदद मिलती है.
किसी जगह के लिए एक जैसा जवाब देने वाला डेटा
लेगसी एपीआई की मदद से, किसी जगह के लिए Place Details (लेगसी), Nearby Search (लेगसी), और Text Search (लेगसी) एपीआई अलग-अलग रिस्पॉन्स डेटा देते थे. Places API (नया वर्शन) रिस्पॉन्स को स्टैंडर्ड बनाता है, ताकि ये सभी एपीआई किसी जगह के लिए एक जैसा डेटा दिखाएं.
जगह के टाइप की ज़्यादा जानकारी
अब एपीआई के जवाब में, किसी जगह का मुख्य टाइप शामिल हो सकता है. हर जगह के लिए, टाइप की एक वैल्यू हो सकती है. इसे जगह के मुख्य टाइप के तौर पर तय किया जाता है. इसकी जानकारी टेबल A में दी गई है.
नए एपीआई में कई नई तरह की सुविधाएं भी शामिल हैं. इन नए टाइप और मौजूदा टाइप का इस्तेमाल, आस-पास की जगहों के लिए खोज (नया) और टेक्स्ट से खोजने (नया) की सुविधा के साथ किया जा सकता है. नए टाइप, टेबल A में शामिल किए गए हैं.
डाइनैमिक प्लेस डेटा
Places API (नया वर्शन), डाइनैमिक रिस्पॉन्स डेटा के साथ काम करता है. जैसे, ईवी चार्जिंग स्टेशन की उपलब्धता या गैस स्टेशन के लिए ईंधन की नई कीमतें. उपयोगकर्ताओं को डाइनैमिक अनुभव देने के लिए, जवाब के इन फ़ील्ड का इस्तेमाल करें.