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

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

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

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

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

जगह की जानकारी का अनुरोध करने के लिए, 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
    

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

    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
    

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

    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 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ कोड अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का सीसीटीएलडी "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);