Places SDK for Android के लिए क्विक रेफ़रंस

Places SDK for Android की मदद से, Android ऐप्लिकेशन, Google के डेटाबेस में मौजूद जगहों और कारोबारों की जानकारी को ऐक्सेस कर सकते हैं. इसके लिए, वे किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा, जगह की जानकारी, आस-पास की जगहों की जानकारी, टेक्स्ट से खोजने की सुविधा, और जगह की फ़ोटो का इस्तेमाल कर सकते हैं. Places SDK for Android (नया) मौजूदा वर्शन है और यह Places API (नया) पर निर्भर करता है.

Places SDK for Android: मुख्य बातें

  • प्रॉडक्ट: Places SDK for Android
  • इसे इस नाम से भी जाना जाता है: Places SDK for Android (New)
  • कैटगरी: जगहें
  • प्लैटफ़ॉर्म: Android
  • इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Places SDK for Android के बारे में खास जानकारी

Places SDK for Android: इसका इस्तेमाल कब करना चाहिए

Places SDK for Android का इस्तेमाल तब करें, जब:

  • आपको नेटिव Android ऐप्लिकेशन में जगह की जानकारी, फ़ोटो, आस-पास की जगहों की जानकारी या टेक्स्ट से खोज के नतीजे चाहिए.
  • आपको पहले से तैयार ऑटोकंप्लीट विजेट या जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट की ज़रूरत है. इनकी मदद से, Android ऐप्लिकेशन में उपयोगकर्ताओं के टाइप करते ही, जगहों के सुझाव मिलते हैं.
  • आपको उपयोगकर्ता के डिवाइस के आस-पास मौजूद कारोबारों और लोकप्रिय जगहों के आधार पर, जगह की जानकारी का पता लगाने वाली Android सुविधाएं बनानी हों.

Places SDK for Android का इस्तेमाल तब न करें, जब:

  • आपको Places को किसी Android ऐप्लिकेशन के बजाय, एचटीटीपी पर किसी सर्वर या बैकएंड से कॉल करना होगा. इसके बजाय, Places API (नया वर्शन) का इस्तेमाल करें.
  • नेटिव iOS ऐप्लिकेशन बनाया जा रहा है. इसके बजाय, Places SDK for iOS का इस्तेमाल करें.
  • ब्राउज़र में कोई वेब पेज बनाया जा रहा हो. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.

Places SDK for Android: सेटअप

Places SDK for Android के आधिकारिक पैकेज:

  • maven: com.google.android.libraries.places:places

Places SDK for Android: आम तौर पर होने वाली गलतियां

  • समस्या: आस-पास की जगहों की जानकारी के लिए किए गए ऐसे अनुरोधों में गड़बड़ी होती है जिनमें फ़ील्ड की सूची (फ़ील्ड मास्क) मौजूद नहीं होती या खाली होती है. समस्या हल करने का तरीका: SearchNearbyRequest फ़ील्ड की सूची में कम से कम एक Place.Field पास करें. /maps/documentation/places/android-sdk/nearby-search देखें.
  • समस्या: अगर एपीआई पासकोड में Places API (नया) शामिल नहीं है, तो जगह की जानकारी (नया), आस-पास की जगहों की जानकारी (नया), और ऑटोकंप्लीट (नया) की सुविधा काम नहीं करती. इसके अलावा, एसडीके 5.x और इससे पहले के वर्शन पर, ऐप्लिकेशन के Places.initialize() को कॉल करने पर भी यह समस्या आती है. वर्शन 6.0.2 में Places.initialize() को हटा दिया गया है. इसलिए, अपग्रेड करने के बाद, इसे कॉल करने वाला कोड कंपाइल नहीं होता. ठीक करने का तरीका: Places API (नया) को चालू करें और इसे एपीआई पासकोड के लिए अनुमति वाले एपीआई में जोड़ें. इसके बाद, Places.initializeWithNewPlacesApiEnabled() का इस्तेमाल करके इसे शुरू करें. /maps/documentation/places/android-sdk/legacy/migrate-overview देखें.
  • समस्या: जब फ़ील्ड की सूची में PHOTO_METADATAS को शामिल नहीं किया जाता है, तो fetchPlace() से मिले Place में कोई PhotoMetadata नहीं होता है. इसलिए, हल करने के लिए कुछ भी नहीं होता है. समस्या हल करने का तरीका: फ़ील्ड की सूची में Place.Field.PHOTO_METADATAS शामिल करें. fetchResolvedPhotoUri() अब काम नहीं करता. इसलिए, फ़ोटो दिखाने के लिए, जगहों की जानकारी देने वाली यूआई किट के Place Details कॉम्पोनेंट का इस्तेमाल करें. /maps/documentation/places/android-sdk/place-photos देखें.
  • समस्या: ऐसे ऐप्लिकेशन जो तीसरे पक्ष और लेखक के एट्रिब्यूशन के बिना, जगह की जानकारी, फ़ोटो या समीक्षाएं दिखाते हैं वे नीतियों का उल्लंघन करते हैं. ठीक करने का तरीका: Place, PhotoMetadata, और Review ऑब्जेक्ट के साथ दिखाए गए एट्रिब्यूशन दिखाएं. /maps/documentation/places/android-sdk/policies देखें.

Places SDK for Android: लेगसी और अब काम न करने वाली सुविधाएं

  • Places SDK for Android (लेगसी) / Places API (लेगसी) की सुविधाएं (ऑटोकंप्लीट, मौजूदा जगह, जगह की जानकारी, और Place Photos लेगसी): लेगसी 1 मार्च, 2025 से. बदलाव: Places SDK for Android (नया) की सुविधाएं, Places API (नया) के साथ काम करती हैं. इसे Places.initializeWithNewPlacesApiEnabled() के साथ शुरू किया जाता है. असर: अक्टूबर 2026 से, नए क्लाउड प्रोजेक्ट में Places API (लेगसी) को चालू नहीं किया जा सकेगा. हालांकि, मौजूदा प्रोजेक्ट में यह काम करता रहेगा. SDK टूल के 6.0.2 वर्शन में, लेगसी तरीके हटा दिए गए हैं. ये तरीके सिर्फ़ 5.x और इससे पहले के वर्शन में मौजूद हैं. माइग्रेट करने से जुड़ी गाइड देखें.
  • Places.initialize(): Decommissioned since 2026-09-30. बदले में मिलने वाला आइटम: Places.initializeWithNewPlacesApiEnabled(). समस्या: SDK टूल के 6.0.2 वर्शन से, इस तरीके को हटा दिया गया है. इसे कॉल करने वाला कोड अब कंपाइल नहीं होता. माइग्रेट करने से जुड़ी गाइड देखें.
  • PlacesClient.findCurrentPlace() और awaitFindCurrentPlace() (मौजूदा जगह, लेगसी): 30-09-2026 से बंद कर दिया गया है. बदलाव: PlacesClient.searchNearby() (आस-पास की जगहों की जानकारी (नया)). समस्या का ब्यौरा: 6.0.2 में, तरीके और FindCurrentPlaceRequest/FindCurrentPlaceResponse क्लास हटा दी गई हैं. माइग्रेट करने से जुड़ी गाइड देखें.
  • PlacesClient.fetchPhoto() और awaitFetchPhoto(): 30-09-2026 से इस्तेमाल नहीं किया जा सकता. इसकी जगह इस्तेमाल करें: जगहों की जानकारी देने वाली यूआई किट का Place Details कॉम्पोनेंट (PlacesClient.fetchResolvedPhotoUri() अब काम नहीं करता). समस्या का ब्यौरा: 6.0.2 में, तरीके और FetchPhotoRequest/FetchPhotoResponse क्लास हटा दी गई हैं. माइग्रेट करने से जुड़ी गाइड देखें.
  • Places API (लेगसी) ऑटोकंप्लीट विजेट (Autocomplete, AutocompleteSupportFragment, AutocompleteActivityMode): बंद कर दिया गया है. यह 30-09-2026 से काम नहीं करेगा. इसकी जगह इस्तेमाल करें: किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (नया) वाला विजेट (PlaceAutocomplete) या PlacesClient.findAutocompletePredictions(). समस्या: 6.0.2 में SDK टूल से क्लास हटा दी गई हैं. माइग्रेट करने से जुड़ी गाइड देखें.
  • Places compatibility library (com.google.android.libraries.places:places-compat): अब सेवा में नहीं है. इसे 31-03-2022 को बंद कर दिया गया था. इसकी जगह इस्तेमाल करें: Places SDK for Android (com.google.android.libraries.places:places). नतीजा: v2.6.0 पर फ़्रीज़ हो गया है. इसमें न तो नई सुविधाएं जोड़ी जाएंगी और न ही गड़बड़ियां ठीक की जाएंगी.
  • AutocompleteFragment क्लास: 25-09-2025 से इस्तेमाल नहीं की जा सकती. इसकी जगह इस्तेमाल करें: किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (नया) विजेट (PlaceAutocomplete). समस्या: SDK टूल के 5.0.0 वर्शन से क्लास को हटा दिया गया है. साथ ही, 6.0.2 वर्शन से AutocompleteSupportFragment को भी हटा दिया गया है.

Places SDK for Android की मदद से क्या-क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.

Places SDK for Android: जनरेटिव एआई

Places SDK for Android: Places

Places SDK for Android: जगहों की जानकारी देने वाली यूआई किट