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