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