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