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.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- इस्तेमाल का एट्रिब्यूशन: इस्तेमाल का एट्रिब्यूशन आईडी भेजने के लिए, SDK टूल को शुरू करते समय
Places.addInternalUsageAttributionId(String)को कॉल करें. ऑप्ट आउट करने के लिए, कॉल को मिटाएं या खाली स्ट्रिंग पास करें. - शुरू करें: Android के लिए Places SDK टूल सेट अप करना
- रेफ़रंस: Places SDK for Android का रेफ़रंस
- कीमत: Places SDK for Android के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: Places SDK for Android की नीतियां
- रिलीज़ नोट: Places SDK for Android के रिलीज़ नोट
Places SDK for Android के आधिकारिक पैकेज:
- maven:
com.google.android.libraries.places:places
Places SDK for Android: इससे जुड़े प्रॉडक्ट
- आम तौर पर, इसके साथ इस्तेमाल किया जाता है: Android के लिए Maps SDK
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: जनरेटिव एआई
- Google Place के किसी आइडेंटिफ़ायर के लिए, उपयोगकर्ताओं की समीक्षाओं की एआई से जनरेट की गई खास जानकारी दिखाता है.
- इलेक्ट्रिक वाहन के चार्जिंग स्टेशन के लिए, Google Place के किसी आइडेंटिफ़ायर के आस-पास की जगह और सुविधाओं के बारे में, एआई की मदद से खास जानकारी पाना.
Places SDK for Android: Places
- क्वेरी स्ट्रिंग के आधार पर, जगहों की सूची और उनकी जानकारी दिखाएं.
- किसी जगह के आस-पास मौजूद जगहों की सूची और उनकी जानकारी पाएं.
- क्वेरी स्ट्रिंग के आधार पर, जगहों के बारे में ऑटोकंप्लीट के नतीजे पाना.
- किसी खास जगह के बारे में ज़्यादा जानकारी पाना.
- किसी खास जगह की फ़ोटो दिखाएं. ध्यान दें: हर फ़ोटो के साथ, उसके लेखक का एट्रिब्यूशन (लेखक का नाम, जो उसकी प्रोफ़ाइल के यूआरआई से लिंक हो) दिखाएं. हर प्लैटफ़ॉर्म के लिए Places की नीतियों के तहत ऐसा करना ज़रूरी है. उदाहरण के लिए, /maps/documentation/javascript/policies#photo-attributions और /maps/documentation/places/web-service/policies#photos-and-review.
- जगह की फ़ोटो का साइज़ बदलना.
- किसी जगह के लिए रेटिंग और समीक्षाएं देखना. ध्यान दें: Places API (नया) वेब सेवा में, Place Details, X-Goog-FieldMask (उदाहरण के लिए, रेटिंग, userRatingCount, समीक्षाएं) के साथ https://places.googleapis.com/v1/places/{placeId} पर किया जाने वाला एचटीटीपी जीईटी अनुरोध है. टेक्स्ट से खोजने, आस-पास की जगहों की जानकारी, और ऑटोकंप्लीट की सुविधा, POST का इस्तेमाल करती है. Android पर, PlacesClient.fetchPlace() में Place.Field.RATING, USER_RATING_COUNT, और REVIEWS पास करें. iOS पर, GMSFetchPlaceRequest में GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, और GMSPlacePropertyReviews पास करें.
- किसी वेब पेज या ऐप्लिकेशन में, ऑटोकंप्लीट विजेट जोड़ें. यह विजेट, क्वेरी स्ट्रिंग के आधार पर जगहों के बारे में नतीजे दिखाता है.
- जगह की जानकारी के रिस्पॉन्स में शामिल डेटा फ़ील्ड तय करना.
- जगह की जानकारी के जवाबों में शामिल करने के लिए, जगह के टाइप तय करें.
- Google Maps में किसी जगह का ज़्यादा जानकारी वाला पेज खोलने के लिए, यूआरआई दिखाता है.
- उपयोगकर्ता के डिवाइस की मौजूदा जगह की जानकारी दिखाता है. ध्यान दें: Places SDK for Android के 6.0 और इसके बाद के वर्शन और Places SDK for iOS के 11.0 और इसके बाद के वर्शन से, मौजूदा जगह की जानकारी देने वाले लेगसी तरीके हटा दिए गए हैं. डिवाइस के कोऑर्डिनेट की जानकारी पाने के लिए, प्लैटफ़ॉर्म की जगह की जानकारी का डेटा इस्तेमाल करने वाली सेवाओं का इस्तेमाल करें और आस-पास की जगहों की जानकारी देने वाली सेवा को कॉल करें.
- किसी जगह के बारे में, एआई की मदद से जनरेट की गई खास जानकारी पाना.
- एआई की मदद से, किसी जगह के आस-पास की जगहों की खास जानकारी पाना.
- पहले से तय किए गए रास्ते पर मौजूद जगहों की जानकारी, क्वेरी स्ट्रिंग के आधार पर पाएं.
- अक्षांश/देशांतर निर्देशांकों के सेट से, टेक्स्ट से खोजी गई जगहों की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के सेट से, आस-पास की जगहों की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है.
- पहले से तय किए गए रास्ते के लिए, शुरुआत की जगह और क्वेरी स्ट्रिंग के आधार पर मिली हर जगह के बीच की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है. ये जगहें, रास्ते में भी मौजूद होती हैं.
- क्वेरी स्ट्रिंग के आधार पर मिली हर जगह के बीच की दूरी, यात्रा में लगने वाला समय, और निर्देश यूआरआई दिखाएं. ये जगहें, पहले से तय किए गए रास्ते और रास्ते के डेस्टिनेशन पर भी मौजूद होती हैं.
Places SDK for Android: जगहों की जानकारी देने वाली यूआई किट
- जगह की जानकारी वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट पर सीएसएस स्टाइल लागू करना. ध्यान दें: सीएसएस कस्टम प्रॉपर्टी, Maps JavaScript API की जगहों की जानकारी देने वाली यूआई किट के एलिमेंट पर लागू होती हैं. Android के लिए Places SDK और iOS के लिए Places SDK, थीम और स्टाइल एट्रिब्यूट का इस्तेमाल करके, जगहों की जानकारी देने वाली यूआई किट के व्यू को प्रोग्राम के हिसाब से स्टाइल करते हैं. ईईए के नियमों का पालन करने की ज़रूरी शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- यूज़र इंटरफ़ेस (यूआई) एलिमेंट को पसंद के मुताबिक बनाने वाले टूल की मदद से, जगह के डेटा से जुड़े यूज़र इंटरफ़ेस (यूआई) एलिमेंट की स्टाइल और कॉन्फ़िगरेशन को पसंद के मुताबिक बनाएं. ध्यान दें: ईईए के नियमों का पालन करने की शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज या मोबाइल ऐप्लिकेशन में ऐसा यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ें जो किसी जगह की जानकारी दिखाता हो. ध्यान दें: ईईए के नियमों का पालन करने की शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज पर, क्वेरी स्ट्रिंग के आधार पर जगहों की सूची दिखाने वाला यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ना. ध्यान दें: यह सुविधा, वेब पेजों (Maps JavaScript API) और मोबाइल ऐप्लिकेशन (Places SDK for Android और Places SDK for iOS), दोनों पर काम करती है. ईईए के नियमों का पालन करने की ज़रूरी शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज पर ऐसा यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ना जो किसी जगह के आस-पास मौजूद जगहों की सूची दिखाता हो. ध्यान दें: यह सुविधा, वेब पेजों (Maps JavaScript API) और मोबाइल ऐप्लिकेशन (Places SDK for Android और Places SDK for iOS), दोनों पर काम करती है. ईईए के नियमों का पालन करने की ज़रूरी शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq
- किसी वेब पेज या ऐप्लिकेशन में, अपने-आप पूरा होने वाला बुनियादी यूज़र इंटरफ़ेस (यूआई) एलिमेंट जोड़ें. यह एलिमेंट, क्वेरी स्ट्रिंग के आधार पर Google प्लेस आइडेंटिफ़ायर दिखाता है. ध्यान दें: ईईए के नियमों का पालन करने की शर्त: यूरोपियन इकनॉमिक एरिया (ईईए) में किसी मैप पर जगह का डेटा दिखाने के लिए, बैकएंड सर्वर से Places API की वेब सेवाओं को कॉल न करें. टारगेट किए गए प्लैटफ़ॉर्म पर, क्लाइंट-साइड जगहों की जानकारी देने वाली यूआई किट के कॉम्पोनेंट इस्तेमाल करें. जैसे, वेब पर Maps JavaScript API, Android पर Places SDK for Android या iOS पर Places SDK for iOS. सभी ज़रूरी शर्तें और अक्सर पूछे जाने वाले सवाल: https://developers.google.com/maps/comms/eea/faq