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