जगह की जानकारी (नई)

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

प्लेस आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:

• टेक्स्ट खोज (नया)
• आस-पास की जगहों की जानकारी (नया)
• ऑटोकंप्लीट (नया)

जगह की जानकारी (नया) के अनुरोध

जगह की जानकारी का अनुरोध करने के लिए, 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.DISPLAY_NAME, Place.Field.ID, Place.Field.PHOTO_METADATAS, Place.Field.RESOURCE_NAME
    

  • ये फ़ील्ड, जगह की जानकारी (सिर्फ़ जगह) एसकेयू को ट्रिगर करते हैं:

    Place.Field.ADDRESS_COMPONENTS, ADR_FORMAT_ADDRESS, Place.Field.FORMATTED_ADDRESS, Place.Field.LOCATION, Place.Field.PLUS_CODE, Place.Field.SHORT_FORMATTED_ADDRESS, Place.Field.TYPES, Place.Field.VIEWPORT
    

  • ये फ़ील्ड, जगह की जानकारी (बुनियादी) SKU को ट्रिगर करते हैं:

    Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.BUSINESS_STATUS, Place.Field.GOOGLE_MAPS_URI, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.PRIMARY_TYPE, Place.Field.PRIMARY_TYPE_DISPLAY_NAME, Place.Field.SUB_DESTINATIONS, Place.Field.UTC_OFFSET
    

  • ये फ़ील्ड, जगह की जानकारी (बेहतर) SKU को ट्रिगर करते हैं:

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.CURRENT_SECONDARY_OPENING_HOURS Place.Field.INTERNATIONAL_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.WEBSITE_URI
    

  • यहां दिए गए फ़ील्ड, जगह की जानकारी (प्राथमिक) 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
  लेख पढ़ें.

ज़रूरी नहीं पैरामीटर

FetchPlaceRequest के लिए ये पैरामीटर ज़रूरी नहीं हैं:

• क्षेत्र कोड

  रिस्पॉन्स को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्र कोड. इसे दो वर्णों वाले CLDR कोड की वैल्यू के तौर पर तय किया जाता है. कोई डिफ़ॉल्ट वैल्यू नहीं है.

  अगर रिस्पॉन्स में Place.Field.FORMATTED_ADDRESS फ़ील्ड में मौजूद देश का नाम, regionCode से मेल खाता है, तो Place.Field.FORMATTED_ADDRESS से देश का कोड हटा दिया जाता है.

  ज़्यादातर CLDR कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ कोड अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि उसका आईएसओ 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दन आयरलैंड" इकाई के लिए है. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है.

  क्षेत्र कोड पैरामीटर सेट करने के लिए, FetchPlaceRequest ऑब्जेक्ट बनाते समय setRegionCode() तरीके को कॉल करें.

• सेशन टोकन

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

  सेशन टोकन पैरामीटर सेट करने के लिए, FetchPlaceRequest ऑब्जेक्ट बनाते समय setSessionToken() तरीके को कॉल करें.

जगह की जानकारी का उदाहरण

इस उदाहरण में, न्यूयॉर्क शहर में एम्पायर स्टेट बिल्डिंग के लिए 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);