Places API (लेगसी) के बारे में खास जानकारी

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

Places API की मदद से, अलग-अलग तरह की जगहों की जानकारी खोजी और वापस पाई जा सकती है. इसके लिए, टेक्स्ट स्ट्रिंग का इस्तेमाल किया जा सकता है या आस-पास की जगहों को खोजा जा सकता है. Places API (लेगसी), Places API (नया प्रॉडक्ट) का लेगसी वर्शन है.

यहां दी गई टेबल में, दोनों एपीआई के वर्शन दिए गए हैं. इस गाइड का इस्तेमाल करके, दोनों के बीच के मुख्य अंतरों को समझें और Places API (नया) पर माइग्रेट करें.

Places API (लेगसी) Places API (नया प्रॉडक्ट) नोट
जगह ढूंढें (लेगसी) टेक्स्ट खोज (नई सुविधा) 'जगह ढूंढें (लेगसी वर्शन)' का कोई नया वर्शन उपलब्ध नहीं है. इसकी जगह, टेक्स्ट सर्च (नया) सुविधा उपलब्ध है.
आस-पास की खोज (लेगसी) आस-पास की खोज (नया) लेगसी एपीआई का इस्तेमाल करके किए गए ऐसे सभी अनुरोधों में टेक्स्ट से खोजने की सुविधा (नई) का इस्तेमाल किया जाना चाहिए जिनमें टेक्स्ट क्वेरी शामिल है. ऐसा इसलिए, क्योंकि आस-पास खोजने की सुविधा (नई) में टेक्स्ट इनपुट करने की सुविधा काम नहीं करती.
टेक्स्ट खोज (लेगसी) टेक्स्ट खोज (नई सुविधा)
जगह की जानकारी (लेगसी) जगह की जानकारी (नया)
जगह की फ़ोटो (लेगसी) जगह की फ़ोटो (नई)
जगह के नाम के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) ऑटोकंप्लीट (नया)
क्वेरी स्वतः पूर्ण (विरासत) ऑटोकंप्लीट (नया) ऑटोकंप्लीट (नई) सुविधा में जोड़ी गई क्षमताएं.

नए API पर माइग्रेट करें

नए API पर माइग्रेट करने के लिए, निम्नलिखित माइग्रेशन मार्गदर्शिकाएँ देखें:

Places API (नया प्रॉडक्ट) में जोड़ी गई मुख्य सुविधाएं

इस सेक्शन में, Places API (नया) में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है.

Google क्लाउड मानक प्लेटफ़ॉर्म पर कार्यान्वित

Places API (नया) को Google Cloud पर सेवा संरचना पर लागू किया गया है. यह कार्यान्वयन OAuth जैसे उन्नत सुरक्षा विकल्पों के साथ एक अधिक सुरक्षित और विश्वसनीय प्लेटफ़ॉर्म लाता है. यह मानक API डिज़ाइन, API में एकरूपता का स्तर लाता है, जो Places API (नया) के साथ विकास की दक्षता में सुधार करता है.

बेहतर परफ़ॉर्मेंस

स्थान API (नया) बेहतर प्रदर्शन प्रदान करता है, जिससे मौजूदा स्थान API का उपयोग करने वाले ऐप्स को प्रतिस्थापित करना लाभदायक हो जाता है.

आसान कीमत

Places API (नया) की मदद से, कीमत तय करने की प्रोसेस को आसान बनाया गया है, ताकि आप सिर्फ़ उस डेटा के लिए पेमेंट करें जिसका इस्तेमाल किया जाता है. कीमत तय करने की आसान सुविधा को फ़ील्ड मास्क का इस्तेमाल करके लागू किया जाता है.

जगह की जानकारी (नई), आस-पास खोजने की सुविधा (नई), और टेक्स्ट से खोजने की सुविधा (नई) के साथ, फ़ील्ड मास्क का इस्तेमाल करके, जवाब में दिखाए जाने वाले फ़ील्ड की सूची को कंट्रोल किया जाता है. इसके बाद, आपसे सिर्फ़ उस डेटा के लिए शुल्क लिया जाता है जिसका अनुरोध किया गया है. फ़ील्ड मास्किंग का इस्तेमाल करना, डिज़ाइन के लिहाज़ से सबसे सही तरीका है. इससे यह पक्का किया जा सकता है कि आपने बिना ज़रूरत के डेटा का अनुरोध न किया हो. इससे, प्रोसेसिंग में लगने वाले समय और बिलिंग शुल्क को कम करने में मदद मिलती है.

किसी जगह के लिए एक जैसा जवाब देने वाला डेटा

लेगसी एपीआई की मदद से, किसी जगह के लिए Place Details (लेगसी), Nearby Search (लेगसी), और Text Search (लेगसी) एपीआई अलग-अलग रिस्पॉन्स डेटा देते थे. Places API (नया वर्शन) के रिस्पॉन्स को स्टैंडर्ड बनाया गया है, ताकि ये सभी एपीआई किसी जगह के लिए एक जैसा डेटा दिखाएं.

जगह के टाइप की ज़्यादा जानकारी

अब एपीआई के जवाब में, किसी जगह का मुख्य टाइप शामिल किया जा सकता है. हर जगह के लिए, टाइप की एक वैल्यू हो सकती है. इसे जगह के मुख्य टाइप के तौर पर तय किया जाता है. इसकी जानकारी टेबल A में दी गई है.

नए एपीआई में कई नई तरह की सुविधाएं भी शामिल हैं. इन नए टाइप और मौजूदा टाइप का इस्तेमाल, आस-पास की जगहों के बारे में खोजने की नई सुविधा और टेक्स्ट से खोजने की नई सुविधा के साथ किया जा सकता है. नए टाइप, टेबल A में शामिल किए गए हैं.

जगह की जानकारी का डाइनैमिक डेटा

Places API (नया वर्शन), डाइनैमिक रिस्पॉन्स डेटा के साथ काम करता है. जैसे, ईवी चार्जिंग स्टेशन की उपलब्धता या गैस स्टेशन के लिए ईंधन की मौजूदा कीमतें. डाइनैमिक उपयोगकर्ता अनुभव बनाने के लिए, इन जवाब वाले फ़ील्ड का इस्तेमाल करें.