किसी जगह के आईडी का इस्तेमाल करके, किसी खास जगह या दिलचस्पी की जगह के बारे में ज़्यादा जानकारी का अनुरोध किया जा सकता है. इसके लिए, Place Details (नया) अनुरोध करें. Place Details (नया) से, चुनी गई जगह के बारे में ज़्यादा जानकारी मिलती है. जैसे, उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.
किसी जगह का आईडी पाने के कई तरीके हैं. इनका इस्तेमाल किया जा सकता है:
Place Details (नया) के अनुरोध
PlacesClient.fetchPlace()
`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 Details (नया) के जवाब
Place Details (नया) से,
Place
ऑब्जेक्ट के तौर पर डेटा मिलता है. इसमें सिर्फ़ वे फ़ील्ड शामिल होते हैं जिनका अनुरोध, फ़ील्ड
की सूचीका इस्तेमाल करके किया गया है. जगह की जानकारी के नतीजे खाली नहीं हो सकते. इसलिए, सिर्फ़ वे नतीजे दिखाए जाते हैं जिनमें डेटा मौजूद होता है. उदाहरण के लिए, अगर अनुरोध की गई जगह की कोई फ़ोटो नहीं है, तो नतीजे में फ़ोटो वाला फ़ील्ड मौजूद नहीं होगा.
डेटा फ़ील्ड ऐक्सेस करने के लिए, उससे जुड़ा
तरीकाकॉल करें.
उदाहरण के लिए, जगह का नाम ऐक्सेस करने के लिए, getName() को कॉल करें.
ज़रूरी पैरामीटर
FetchPlaceRequest
के लिए ये पैरामीटर ज़रूरी हैं:
-
जगह का आईडी
यह टेक्स्ट वाला आइडेंटिफ़ायर होता है, जो किसी जगह की खास तौर पर पहचान करता है. यह टेक्स्ट से खोजें (नया), आस-पास की जगहों की जानकारी (नया) या ऑटोकंप्लीट (नया) से मिलता है. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी की खास जानकारी देखें.
-
फ़ील्ड की सूची
किसी जगह की जानकारी का अनुरोध करते समय, आपको यह बताना होगा कि जगह का कौनसा डेटा दिखाना है. इसके लिए,
Place.Fieldवैल्यू की सूची पास करें. इसमें वह डेटा शामिल होना चाहिए जो आपको दिखाना है. जवाब में, दिखाए जाने वाले फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती.फ़ील्ड की सूची, डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने ज़रूरत से ज़्यादा डेटा का अनुरोध न किया हो. इससे, ज़रूरत से ज़्यादा प्रोसेसिंग में लगने वाले समय और बिलिंग शुल्क से बचा जा सकता है. यह सूची अहम होती है, क्योंकि इससे हर अनुरोध की लागत पर असर पड़ता है. ज़्यादा जानकारी के लिए, इस्तेमाल और बिलिंग लेख पढ़ें.
इनमें से एक या उससे ज़्यादा फ़ील्ड तय करें:
इन फ़ील्ड से, Place Details Essentials IDs Only SKU ट्रिगर होता है:
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
फ़ील्ड और उनसे जुड़े SKU की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
इन फ़ील्ड से, Place Details Essentials SKU ट्रिगर होता है:
Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
*Place.Field.ADDRESS(अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
Place.Field.LOCATION*
*Place.Field.LAT_LNG(अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORTफ़ील्ड और उनसे जुड़े SKU की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
इन फ़ील्ड से, Place Details Pro SKU ट्रिगर होता है:
Place.Field.ACCESSIBILITY_OPTIONS*
*Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE(अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
*Place.Field.NAME(अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
*Place.Field.ICON_URL(अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSETफ़ील्ड और उनसे जुड़े SKU की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
इन फ़ील्ड से, Place Details Enterprise SKU ट्रिगर होता है:
Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
*Place.Field.PHONE_NUMBER(अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT*
*Place.Field.USER_RATINGS_TOTAL(अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
Place.Field.WEBSITE_URIफ़ील्ड और उनसे जुड़े SKU की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
इन फ़ील्ड से, Place Details Enterprise Plus SKU ट्रिगर होता है:
Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUTफ़ील्ड और उनसे जुड़े SKU की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
ज़रूरी नहीं पैरामीटर
के लिए
FetchPlaceRequest
ये पैरामीटर ज़रूरी नहीं हैं:
क्षेत्र कोड
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया गया क्षेत्र कोड. इसे दो वर्णों वाली CLDR कोड वैल्यू के तौर पर तय किया जाता है. इसकी कोई डिफ़ॉल्ट वैल्यू नहीं होती.
अगर जवाब में
Place.Field.FORMATTED_ADDRESSफ़ील्ड में मौजूद देश का नाम,regionCodeसे मेल खाता है, तोPlace.Field.FORMATTED_ADDRESSसे देश का कोड हटा दिया जाता है.ज़्यादातर CLDR कोड, ISO 3166-1 कोड के जैसे होते हैं, हालांकि, कुछ अहम अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "The United Kingdom of Great Britain and Northern Ireland" के लिए है. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है.
क्षेत्र कोड पैरामीटर सेट करने के लिए,
setRegionCode()तरीके को कॉल करें जबFetchPlaceRequestऑब्जेक्ट बनाते समय.-
सेशन टोकन
सेशन टोकन, उपयोगकर्ता जनरेट की गई स्ट्रिंग होती हैं. इनसे Autocomplete (नया) के कॉल को "सेशन" के तौर पर ट्रैक किया जाता है. Autocomplete (नया), सेशन टोकन का इस्तेमाल करके, बिलिंग के मकसद से, उपयोगकर्ता के ऑटोकंप्लीट खोज के क्वेरी और जगह चुनने के चरणों को अलग-अलग सेशन में ग्रुप करता है. सेशन टोकन, Place Details (नया) के उन कॉल में पास किए जाते हैं जो Autocomplete (नया) के कॉल के बाद किए जाते हैं. ज़्यादा जानकारी के लिए, सेशन टोकन लेख पढ़ें.
सेशन टोकन पैरामीटर सेट करने के लिए,
setSessionToken()तरीके को कॉल करें जबFetchPlaceRequestऑब्जेक्ट बनाते हैं.
Place Details का उदाहरण
इस उदाहरण में, न्यूयॉर्क शहर में मौजूद Empire State Building के लिए, ID, DISPLAY_NAME, और FORMATTED_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.DISPLAY_NAME, Place.Field.FORMATTED_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);