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