माइग्रेशन के बारे में खास जानकारी

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

Places SDK for Android (New) बेहतर परफ़ॉर्मेंस देता है. साथ ही, इसमें नया प्राइसिंग मॉडल भी उपलब्ध है. इसलिए, Places SDK for Android (Legacy) का इस्तेमाल करने वाले ऐप्लिकेशन को अपडेट करना फ़ायदेमंद है. सुविधाओं की तुलना करने के बारे में ज़्यादा जानने के लिए, एसडीके चुनें लेख पढ़ें.

इस गाइड का इस्तेमाल करके, Places SDK for Android (नया) और Places SDK for Android (लेगसी) के बीच के मुख्य अंतरों के बारे में जानें. साथ ही, ज़रूरी बदलावों को मैनेज करने का तरीका जानें.

माइग्रेशन के लिए बिलिंग के सबसे सही तरीके

यह दिशा-निर्देश तब लागू होता है, जब आपके एपीआई इस्तेमाल करने की दर इतनी ज़्यादा हो कि आपको दूसरे टियर की कीमत पर जाना पड़े. एपीआई के नए वर्शन पर माइग्रेट करने पर, आपको किसी दूसरे एसकेयू के लिए भी बिल भेजा जाता है. ट्रांज़िशन के दौरान, महीने के आखिर में ज़्यादा शुल्क न लगे, इसके लिए हमारा सुझाव है कि आप महीने की शुरुआत में ही नए एपीआई पर स्विच कर लें. इससे यह पक्का होगा कि माइग्रेशन के महीने में, आपको हर महीने के सबसे किफ़ायती प्राइसिंग टियर मिलें. शुल्क के टियर के बारे में जानकारी पाने के लिए, शुल्क वाला पेज और शुल्क के बारे में अक्सर पूछे जाने वाले सवाल देखें.

Places API (नया प्रॉडक्ट) चालू करना

Places SDK for Android (लेगसी), Places API सेवा पर निर्भर करता है. Places SDK for Android (New) की सुविधाओं का इस्तेमाल करने के लिए, आपको पहले अपने Google Cloud प्रोजेक्ट में Places API (New) चालू करना होगा. ज़्यादा जानकारी के लिए, Google Cloud प्रोजेक्ट सेट अप करना लेख पढ़ें.

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

पक्का करें कि आपके पास Places API (New) का इस्तेमाल करने के लिए, ज़रूरत के मुताबिक कोटा हो

पक्का करें कि Places API (New) में, आपके मौजूदा ट्रैफ़िक को कवर करने के लिए, ज़रूरत के मुताबिक कोटा हो. अपने कोटे और इस्तेमाल की सीमाओं की समीक्षा करने और उन्हें मैनेज करने के लिए, कोटे और कोटे से जुड़ी सूचनाएं लेख पढ़ें.

इनके बीच का अंतर देखें:

  • Places SDK for Android (लेगसी) का कोटा, Places API सेवा के कोटे पर निर्भर करता है. यह Places API के सभी तरीकों का कुल योग होता है.
  • Places SDK for Android (New) का कोटा, Places API (New) सेवा के कोटे पर निर्भर करता है. हर एपीआई तरीके के लिए, एक अलग कोटा होता है.

देखें कि आपके कानूनी समझौते में Places API (नया प्रॉडक्ट) शामिल है या नहीं

अगर आपने कोई कानूनी समझौता किया है, तो पक्का करें कि उसमें Places API (नया वर्शन) शामिल हो और उसकी कीमत भी सही हो. अगर ऐसा नहीं है, तो Google में अपने सेल्स संपर्क व्यक्ति या पार्टनर से संपर्क करें. उनसे इस बारे में बात करें कि इस एपीआई को कैसे शामिल किया जा सकता है.

सामान्य बदलाव

कुछ सामान्य बदलाव ऐसे हैं जो कई एपीआई पर लागू होते हैं. इनमें ये शामिल हैं:

  • कीमत तय करने के नए मॉडल का इस्तेमाल करता है. सभी एपीआई की कीमत के बारे में जानकारी के लिए, Places SDK for Android (नया वर्शन) देखें.

  • आपको Places.initializeWithNewPlacesApiEnabled() तरीके को कॉल करके, अपने ऐप्लिकेशन को शुरू करना होगा. Places API सेवा चुनने के बारे में ज़्यादा जानने के लिए, Google Cloud प्रोजेक्ट सेट अप करना लेख पढ़ें.

  • जगह की जानकारी (नई सुविधा), आस-पास खोजें (नई सुविधा), और टेक्स्ट से खोजें (नई सुविधा) के लिए फ़ील्ड मास्क ज़रूरी होते हैं. इनसे यह तय किया जाता है कि जवाब में कौनसे फ़ील्ड दिखाए जाएं.

  • अनुरोधों को तय करने या जवाब में नए फ़ील्ड जोड़ने के लिए, नई क्लास जोड़ी गई हैं.

  • जवाब Place ऑब्जेक्ट में, नया getReviews() तरीका शामिल होता है. यह तरीका, Review ऑब्जेक्ट की सूची दिखाता है. अगर आपका ऐप्लिकेशन, Place ऑब्जेक्ट से मिली जानकारी दिखाता है, जैसे कि फ़ोटो और समीक्षाएं, तो ऐप्लिकेशन को ज़रूरी एट्रिब्यूशन भी दिखाने होंगे.

    ज़्यादा जानकारी के लिए, एट्रिब्यूशन के बारे में दस्तावेज़ देखें.

एपीआई से जुड़े बदलाव

इस सेक्शन में, हर एपीआई के लिए माइग्रेशन की ये गाइड शामिल हैं: