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

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

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

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

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

ध्यान दें: जगह की जानकारी (नया) सुविधा, Android 3.3.0 और इसके बाद के वर्शन के लिए, Places SDK टूल में उपलब्ध है. ज़्यादा जानकारी के लिए, SDK टूल का वर्शन चुनना लेख पढ़ें. 4.0.0 वर्शन में जोड़े गए Kotlin एपीआई इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, रेफ़रंस की खास जानकारी देखें.

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

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

ध्यान दें: PlacesClient को शुरू करने के बारे में ज़्यादा जानकारी के लिए, Places API क्लाइंट को शुरू करना देखें.

किसी भी अनुरोध क्लास (उदाहरण के लिए, FetchPlaceRequest) के अनुरोध को रद्द करने के लिए, CancellationToken का इस्तेमाल किया जा सकता है. अनुरोध को रद्द करने की कोशिश पूरी तरह से सफल नहीं हो सकती. सदस्यता रद्द करने का अनुरोध करने के बाद, आपको कोई जवाब नहीं मिलेगा. रद्द करने का टोकन जारी करने से, यह गारंटी नहीं मिलती कि कोई अनुरोध रद्द हो जाएगा. साथ ही, अगर कोई जवाब नहीं मिलता है, तब भी आपसे अनुरोध के लिए शुल्क लिया जा सकता है.

जगह की जानकारी (नया) से जुड़े जवाब

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

डेटा फ़ील्ड ऐक्सेस करने के लिए, उससे जुड़े तरीके को कॉल करें. उदाहरण के लिए, जगह का नाम ऐक्सेस करने के लिए, getName() को कॉल करें.

ज़रूरी पैरामीटर

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

• जगह का आईडी

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

• फ़ील्ड की सूची

  किसी जगह का अनुरोध करते समय, आपको यह बताना होगा कि आपको किस जगह का डेटा चाहिए. ऐसा करने के लिए, Place.Field वैल्यू की सूची दें. रिस्पॉन्स में, रिटर्न किए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती.

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

  इनमें से एक या उससे ज़्यादा फ़ील्ड डालें:

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

    Place.Field.DISPLAY_NAME, Place.Field.ID, Place.Field.PHOTO_METADATAS, Place.Field.RESOURCE_NAME
    
    ध्यान दें:

    • Android के लिए Places SDK टूल के वर्शन 4.0 में, Place.Field.NAME फ़ील्ड का इस्तेमाल बंद कर दिया गया था. इसके बजाय, Place.Field.DISPLAY_NAME का इस्तेमाल करें.
    • RESOURCE_NAME फ़ील्ड में जगह के संसाधन का नाम इस फ़ॉर्मैट में होता है: places/PLACE_ID. जगह का टेक्स्ट नाम ऐक्सेस करने के लिए, DISPLAY_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
    
    ध्यान दें:Android के लिए Places SDK टूल के वर्शन 4.0 में, Place.Field.ADDRESS और Place.Field.LAT_LNG फ़ील्ड का इस्तेमाल बंद कर दिया गया है. इसके बजाय, Place.Field.FORMATTED_ADDRESS और Place.Field.LOCATION का इस्तेमाल करें.

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

    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
    
    ध्यान दें:Android के लिए Places SDK टूल के वर्शन 4.0 में, Place.Field.ICON_URL और Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE फ़ील्ड का इस्तेमाल बंद कर दिया गया है. इसके बजाय, Place.Field.ICON_MASK_URL और Place.Field.ACCESSIBILITY_OPTIONS का इस्तेमाल करें. Place.Field.ACCESSIBILITY_OPTIONS सिर्फ़ जगह की जानकारी (नया) के लिए उपलब्ध है.

  • ये फ़ील्ड, जगह की जानकारी (बेहतर) 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
    
    ध्यान दें:Android के लिए Places SDK टूल के वर्शन 4.0 में, Place.Field.PHONE_NUMBER और Place.Field.USER_RATINGS_TOTAL फ़ील्ड का इस्तेमाल बंद कर दिया गया है. इसके बजाय, Place.Field.INTERNATIONAL_PHONE_NUMBER और Place.USER_RATING_COUNT का इस्तेमाल करें.

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

    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
  ध्यान दें: Places SDK for Android के 4.0 वर्शन में, जगह के कई डेटा फ़ील्ड का इस्तेमाल बंद कर दिया गया है. साथ ही, नए फ़ील्ड जोड़े गए हैं. ज़्यादा जानकारी के लिए, Places SDK for Android 4.0 में, जगह की जानकारी के नए फ़ील्ड पर माइग्रेट करना
  लेख पढ़ें.

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

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);