किसी खास जगह या लोकप्रिय जगह के जगह का आईडी का इस्तेमाल करके और जगह की जानकारी (नई) के लिए अनुरोध करके, ज़्यादा जानकारी का अनुरोध किया जा सकता है. जगह की जानकारी (नया) से, बताई गई जगह के बारे में ज़्यादा जानकारी मिलती है. जैसे, जगह का पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.
प्लेस आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
जगह की जानकारी (नए) के अनुरोध
PlacesClient.fetchPlace() पर कॉल करके, जगह की जानकारी का अनुरोध किया जा सकता है. इसके लिए, आपको जगह का आईडी और फ़ील्ड की सूची वाला एक ऑब्जेक्ट FetchPlaceRequest पास करना होगा. इसके अलावा, कोई भी वैकल्पिक पैरामीटर भी पास करना होगा:
// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);
जगह की जानकारी (नए) के जवाब
जगह की जानकारी (नई) सुविधा, Place ऑब्जेक्ट के तौर पर डेटा दिखाती है. इसमें सिर्फ़ वे फ़ील्ड शामिल होते हैं जिनका आपने फ़ील्ड सूची का इस्तेमाल करके अनुरोध किया है. स्थान डेटा परिणाम खाली नहीं हो सकते, इसलिए केवल डेटा वाले स्थान परिणाम लौटाए जाते हैं (उदाहरण के लिए, अगर किसी अनुरोध किए गए स्थान में कोई फ़ोटो नहीं है, तो परिणाम में फ़ोटो फ़ील्ड मौजूद नहीं होगा).
डेटा फ़ील्ड को ऐक्सेस करने के लिए, उससे जुड़े तरीका को चुनें.
उदाहरण के लिए, जगह का नाम ऐक्सेस करने के लिए, getName() पर कॉल करें.
ज़रूरी पैरामीटर
FetchPlaceRequest के लिए ज़रूरी पैरामीटर ये हैं:
-
जगह का आईडी
एक टेक्स्ट आइडेंटिफ़ायर, जो किसी जगह की खास तौर पर पहचान करता है. यह टेक्स्ट सर्च (नया), आस-पास सर्च (नया) या ऑटोकंप्लीट (नया) की मदद से दिखता है. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी की खास जानकारी देखें.
-
फ़ील्ड की सूची
किसी जगह का अनुरोध करते समय, आपको यह बताना होगा कि किस जगह का डेटा दिखाना है. ऐसा करने के लिए,
Place.Fieldवैल्यू की सूची पास करें, जिसमें दिखाया जाने वाला डेटा मौजूद हो. जवाब में, दिखाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं है.फ़ील्ड की सूचियां, डिज़ाइन का एक अच्छा तरीका हैं. इससे यह पक्का किया जाता है कि ग़ैर-ज़रूरी डेटा का अनुरोध न किया जाए. इससे, प्रोसेसिंग में लगने वाले ग़ैर-ज़रूरी समय और बिलिंग शुल्क से बचने में मदद मिलती है. इस सूची को ध्यान में रखना ज़रूरी है, क्योंकि इससे हर अनुरोध की लागत पर असर पड़ता है. ज़्यादा जानकारी के लिए, इस्तेमाल और बिलिंग देखें.
इनमें से एक या ज़्यादा फ़ील्ड चुनें:
ये फ़ील्ड, जगह की जानकारी (सिर्फ़ आईडी के लिए) SKU को ट्रिगर करते हैं:
Place.Field.ID,Place.Field.NAME,Place.Field.PHOTO_METADATASये फ़ील्ड, जगह की जानकारी (सिर्फ़ जगह की जानकारी) SKU को ट्रिगर करते हैं:
Place.Field.ADDRESS_COMPONENTS,Place.Field.ADDRESS,Place.Field.LAT_LNG,Place.Field.PLUS_CODE,Place.Field.TYPES,Place.Field.VIEWPORTये फ़ील्ड, जगह की जानकारी (बेसिक) SKU को ट्रिगर करते हैं:
Place.Field.BUSINESS_STATUS,Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_URL,Place.Field.UTC_OFFSET,Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCEये फ़ील्ड, जगह की जानकारी (बेहतर) SKU को ट्रिगर करते हैं:
Place.Field.CURRENT_OPENING_HOURS,Place.Field.SECONDARY_OPENING_HOURS,Place.Field.PHONE_NUMBER,Place.Field.PRICE_LEVEL,Place.Field.RATING,Place.Field.OPENING_HOURS,Place.Field.USER_RATINGS_TOTAL,Place.Field.WEBSITE_URIये फ़ील्ड, जगह की जानकारी (पसंदीदा) SKU को ट्रिगर करते हैं:
Place.Field.CURBSIDE_PICKUP,Place.Field.DELIVERY,Place.Field.DINE_IN,Place.Field.EDITORIAL_SUMMARY,Place.Field.RESERVABLE,Place.Field.REVIEWS,Place.Field.SERVES_BEER,Place.Field.SERVES_BREAKFAST,Place.Field.SERVES_BRUNCH,Place.Field.SERVES_DINNER,Place.Field.SERVES_LUNCH,Place.Field.SERVES_VEGETARIAN_FOOD,Place.Field.SERVES_WINE,Place.Field.TAKEOUT
ज़रूरी नहीं पैरामीटर
FetchPlaceRequest के लिए वैकल्पिक पैरामीटर ये हैं:
क्षेत्र कोड
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्रीय कोड. इसे दो वर्णों वाले CLDR कोड की वैल्यू के तौर पर बताया जाता है. कोई डिफ़ॉल्ट मान नहीं है.
अगर जवाब में दिए गए
Place.Field.ADDRESSफ़ील्ड का देश का नाम,regionCodeसे मेल खाता है, तो देश का कोडPlace.Field.ADDRESSमें शामिल नहीं किया जाता.ज़्यादातर CLDR कोड, ISO 3166-1 कोड के जैसे होते हैं. हालांकि, इसमें कुछ खास अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन और नॉर्दन आयरलैंड की इकाई के लिए इसका इस्तेमाल किया जा सकता है. पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है.
क्षेत्र का कोड पैरामीटर सेट करने के लिए,
FetchPlaceRequestऑब्जेक्ट बनाते समयsetRegionCode()तरीके को कॉल करें.-
सेशन टोकन
सेशन टोकन, यूज़र जनरेटेड स्ट्रिंग होते हैं जो ऑटोकंप्लीट (नए) कॉल को "सेशन" के तौर पर ट्रैक करते हैं. ऑटोकंप्लीट (नया) सुविधा, सेशन टोकन का इस्तेमाल करके क्वेरी को ग्रुप करने और उपयोगकर्ता के ऑटोकंप्लीट खोज के चरणों को अलग-अलग सेशन में बिलिंग के मकसद से सेट करती है. ऑटोकंप्लीट (नया) कॉल के बाद, सेशन टोकन को जगह की जानकारी (नए) कॉल में पास किया जाता है. ज़्यादा जानकारी के लिए, सेशन टोकन देखें.
सेशन टोकन पैरामीटर सेट करने के लिए,
FetchPlaceRequestऑब्जेक्ट बनाते समयsetSessionToken()तरीके को कॉल करें.
जगह की जानकारी का उदाहरण
नीचे दिए गए उदाहरण में, न्यूयॉर्क शहर में एंपायर स्टेट बिल्डिंग के लिए ID, NAME, और ADDRESS फ़ील्ड का अनुरोध किया गया है.
// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";
// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);
// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);