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

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

परिचय

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

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

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