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