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