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

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

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

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

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

जगह की जानकारी का अनुरोध करने के लिए, 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 के लिए ज़रूरी पैरामीटर ये हैं:

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

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