अपने SDK टूल का वर्शन चुनें

Android के लिए Places SDK टूल के दो वर्शन 3.4.0 पर काम करते हैं: Android के लिए जगहें SDK टूल मौजूदा SDK टूल है और Android के लिए जगहें SDK टूल (नया), SDK टूल का नेक्स्ट जनरेशन वर्शन है.

Android 3.4.0 के लिए Places SDK टूल रिलीज़ होने के बाद, आपका पहला काम यह तय करना है कि किस SDK टूल का इस्तेमाल करना है. अगर आप नए ग्राहक हैं या मौजूदा ग्राहक हैं, जो पहले से SDK टूल का इस्तेमाल कर रहा है, तो यह बात लागू होगी. दोनों SDK टूल के बीच मुख्य अंतर को समझने के लिए, इस गाइड का इस्तेमाल करें.

SDK टूल का वर्शन चुनने का तरीका

बैकएंड पर, Android के लिए Places SDK, Places API सेवा पर निर्भर करता है, जैसे कि Places API (नया) या Places API. Android के लिए Places SDK टूल का इस्तेमाल करने से पहले, आपको अपने Google Cloud प्रोजेक्ट में जगहें एपीआई सेवा चालू करनी होगी.

ऐप्लिकेशन में किन एपीआई का इस्तेमाल किया जा सकता है, यह तय करने के लिए Android के लिए दो कार्रवाइयां की जाती हैं:

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

  2. अपने ऐप्लिकेशन को शुरू करने के लिए, Places.initializeWithNewPlacesApiEnabled() या Places.initialize() तरीके को कॉल करें.

अपना SDK टूल चुनें

आपकी ओर से चालू की गई Places API सेवा का वर्शन, आपके ऐप्लिकेशन में इस्तेमाल किए जाने वाले SDK टूल के वर्शन को कंट्रोल करता है:

  • दोनों: Android के लिए स्थल SDK और Android के लिए स्थल SDK (नया), दोनों के लिए सभी सुविधाओं को चालू करता है. उपलब्ध सुविधाओं को कंट्रोल करने के लिए, Places.initializeWithNewPlacesApiEnabled() और Places.initialize() तरीके का इस्तेमाल करें.

  • जगहें एपीआई: मौजूदा जगहों के लिए Android के लिए SDK टूल को चालू करता है. आपके पास Android वर्शन 3.4.0 के लिए Places SDK में जोड़ी गई नई सुविधाओं का ऐक्सेस नहीं है.

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

Places API सेवा को चुनने के बारे में ज़्यादा जानकारी के लिए, अपना Google Cloud प्रोजेक्ट सेट अप करना देखें.

अपना ऐप्लिकेशन शुरू करें

अपना ऐप्लिकेशन शुरू करते समय, आपको Places.initializeWithNewPlacesApiEnabled() या Places.initialize() तरीके को कॉल करना होगा.

नीचे दी गई टेबल में, हर SDK टूल को चालू करने और शुरू करने के हर तरीके को लागू करने के असर को दिखाया गया है. उदाहरण के लिए, अगर आपने Places SDK (नया) को चालू किया है और Places.initializeWithNewPlacesApiEnabled() को कॉल किया है, तो सभी नए एपीआई और सभी मौजूदा एपीआई का इस्तेमाल किया जा सकता है.

अगर आपने Places SDK (नया) को चालू करके, Places.initialize() को कॉल किया है, तो जगह की जानकारी और जगह की फ़ोटो की नई सुविधाओं का इस्तेमाल नहीं किया जा सकेगा. हालांकि, नए Text Search को कॉल किया जा सकता है. अगर आपने Places API चालू नहीं किया है, तो जगह की जानकारी के पुराने वर्शन को ऐक्सेस नहीं किया जा सकता. हालांकि, नए Text Search को कॉल किया जा सकता है.

वर्शन API एपीआई पासकोड पर SDK टूल चालू किया गया शुरू करने का तरीका
जगहों का एपीआई जगहें एपीआई (नया) initialize() initializeWithNewPlacesApiEnabled()
v3.3.0 जगहों की जानकारी
जगहों की जानकारी (नई)
फ़ोटो का मेटाडेटा (नया)
टेक्स्ट से खोजें (नया) कोई भी तरीका
v3.4.0 फ़ोटो Uri (नई)
फ़ोटो का बिट मैप कोई भी तरीका
CurrentPlace कोई भी तरीका
ऑटोकंप्लीट कोई भी तरीका

आपने कौनसा SDK टूल चुना है?

कौनसा वर्शन चुनना है, यह तय करने के लिए:

  1. अगर आप नए ग्राहक हैं, तो हमने Android के लिए स्थल SDK टूल का इस्तेमाल शुरू किया है, तो Locations API (नया) और नए SDK टूल से शुरुआत करें.

  2. अगर आप Kotlin डेवलपर हैं, तो SDK टूल का इस्तेमाल करें. हालांकि, Android के लिए जगहें SDK टूल (नया) की नई सुविधाएं, सिर्फ़ Java में 3.4.0 वर्शन में उपलब्ध हैं.

  3. अगर आप मौजूदा ग्राहक हैं और सेशन टोकन इस्तेमाल कर रहे हैं, तो मौजूदा SDK टूल का इस्तेमाल जारी रखें. Android के लिए Places SDK टूल (नया) फ़िलहाल, सेशन टोकन के साथ काम नहीं करता है.

  4. अगर आप मौजूदा ग्राहक हैं, तो मौजूदा SDK टूल का इस्तेमाल करना जारी रखा जा सकता है. हालांकि, Android के लिए स्थल SDK (नया) की परफ़ॉर्मेंस में किए गए सुधारों और सुविधाओं में सुधार का फ़ायदा लेने के लिए, नए SDK टूल का इस्तेमाल किया जा सकता है.

    नए SDK टूल पर ले जाने के लिए, डेटा को माइग्रेट करने की ज़रूरत नहीं है. आपको सिर्फ़ ये काम करने होंगे:

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

    2. अपने मॉड्यूल-लेवल की build.gradle फ़ाइल के dependencies सेक्शन में, places डिपेंडेंसी अपडेट करें और kotlin-bom डिपेंडेंसी जोड़ें:

        dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.3.0'
  }

      kotlin-bom डिपेंडेंसी के बारे में ज़्यादा जानकारी के लिए, ट्रांज़िट डिपेंडेंसी में kotlin-stdlib के सबसे नए वर्शन का इस्तेमाल देखें.

    3. अपने मौजूदा ऐप्लिकेशन को अपडेट करें, ताकि ऐप्लिकेशन को शुरू करने के लिए, Places.initializeWithNewPlacesApiEnabled() नए तरीके का इस्तेमाल किया जा सके. ज़्यादा जानकारी के लिए, Places API क्लाइंट को शुरू करना देखें.

    आपके मौजूदा ऐप्लिकेशन में कोई बदलाव नहीं होगा. हालांकि, अब SDK टूल की सभी नई सुविधाओं का फ़ायदा लिया जा सकता है.

Android के लिए स्थल SDK में मुख्य सुविधाएं जोड़ी गईं (नई)

इस सेक्शन में Android के लिए Places SDK में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है (नया).

Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू किया गया

Android (नया) के लिए Places SDK टूल को Google Cloud के सेवा इन्फ़्रास्ट्रक्चर में लागू किया गया है. इसे लागू करने से यह ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म उपलब्ध कराता है. इस स्टैंडर्ड डिज़ाइन में, सभी SDK टूल में एक जैसा अनुभव मिलता है. इससे Android के लिए Places SDK टूल के साथ डेवलपमेंट की क्षमता बेहतर होती है (नया).

बेहतर परफ़ॉर्मेंस

Android के लिए Places SDK (नया) बेहतर परफ़ॉर्मेंस देता है. इससे मौजूदा SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन की जगह इस्तेमाल करना फ़ायदेमंद हो जाता है.

नई टेक्स्ट खोज सेवा

टेक्स्ट खोज स्ट्रिंग के आधार पर जगहों के सेट के बारे में जानकारी दिखाती है — उदाहरण के लिए, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के आस-पास के जूतों की दुकानें" या "123 मेन स्ट्रीट". सेवा, टेक्स्ट स्ट्रिंग से मेल खाने वाली जगहों और सेट की गई जगह से जुड़े किसी भी तरह के पूर्वाग्रह के बारे में जवाब देती है.

जगह की जानकारी और फ़ोटो में, जवाब का नया डेटा जोड़ा गया है

  • जगह की जानकारी में, अब रिस्पॉन्स Place ऑब्जेक्ट में, नई समीक्षा क्लास शामिल है. इस फ़ील्ड के साथ काम करने के लिए, Place क्लास में नया getReviews() तरीका शामिल है. किसी जगह की पांच समीक्षाओं तक जवाब देने के लिए, getReviews() को कॉल करें.

  • जगह की फ़ोटो, AuthorAttributions को PhotoMetadata क्लास में जोड़ती है. AuthorAttributions में List AuthorAttribution ऑब्जेक्ट मौजूद हैं.

जगह की फ़ोटो में नया यूआरआई जवाब जोड़ा गया

अब आप इमेज बिटमैप पर यूआरआई दिखाने के लिए 'जगह की फ़ोटो' का इस्तेमाल कर सकते हैं. पहले, सिर्फ़ इमेज का बिट मैप ही दिखाया जा सकता था.

आसान कीमत

Android (नए) के लिए Places SDK टूल की मदद से, कीमतों को आसान बनाया गया है, ताकि आपको सिर्फ़ उस डेटा के लिए पैसे चुकाने हों जिसका इस्तेमाल किया गया है. आसान कीमत तय करने के लिए, फ़ील्ड सूचियों का इस्तेमाल किया जाता है. इन्हें फ़ील्ड मास्क भी कहा जाता है.

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

दोनों SDK टूल की कीमत के बारे में ज़्यादा जानने के लिए, इस्तेमाल और बिलिंग देखें.

विस्तृत स्थान प्रकार

नए SDK टूल में, नीचे दी गई टेबल में दिखाए गए प्लेस टाइप जोड़े गए हैं. इन टाइप को जगह की जानकारी और टेक्स्ट खोज के रिस्पॉन्स के तौर पर दिखाया जाता है. आप चाहें, तो इन नए टाइप और मौजूदा टाइप को भी Text Search वाली खोज में इस्तेमाल करें. नए टाइप टेबल A में शामिल किए गए हैं.

टाइप
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant खेत korean_restaurant sporting_goods_store
barber_shop फ़ार्मस्टे lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal बाज़ार steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant दर्जी
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant मोटल thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
सलाहकार हेलीपोर्ट playground vegetarian_restaurant
convention_center hiking_area प्रीस्कूल vietnamese_restaurant
कॉटेज historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center होस्टल resort_hotel थोक कारोबार
dental_clinic होटल rest_stop
इन नए टाइप के साथ ही, Places API (नया) ने इन टाइप को टेबल B से टेबल A से हटा दिया है. इसका मतलब है कि अब खोज के लिए, इन टाइप का इस्तेमाल किया जा सकता है:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality