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