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