किसी खास कारोबार या जगह के बारे में ज़्यादा जानकारी पाने का अनुरोध किया जा सकता है इसके स्थान का उपयोग करके रुचि आईडी बनाना और जगह की जानकारी (नई) अनुरोध. जगह की जानकारी (नई) में ज़्यादा जानकारी दिखती है बताई गई जगह की जानकारी, जैसे कि उसका पूरा पता, फ़ोन नंबर नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं शामिल हैं.
प्लेस आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
जगह की जानकारी (नए) के अनुरोध
कॉल करके जगह की जानकारी मांगी जा सकती है
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
हैं:
-
जगह का आईडी
एक शाब्दिक आइडेंटिफ़ायर, जो किसी जगह की खास तौर पर पहचान करता है. Text Search (नई सुविधा), आस-पास खोज (नया), या ऑटोकंप्लीट की सुविधा (नई सुविधा). जगह के आईडी के बारे में ज़्यादा जानकारी के लिए, जगह के आईडी की खास जानकारी.
-
फ़ील्ड की सूची
किसी जगह का अनुरोध करते समय, आपको यह बताना होगा कि किस जगह का डेटा दिखाना है. यहां की यात्रा पर हूं ऐसा करने के लिए,
Place.Fieldवैल्यू की सूची पास करें दिया जाने वाला डेटा तय कर रहा है. यहां कोई डिफ़ॉल्ट सूची नहीं है जवाब में फ़ील्ड दिखाई गईं.फ़ील्ड की सूचियां डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जाता है कि आप अनुरोध न करें. डेटा की ज़रूरत नहीं होती, जिससे प्रोसेसिंग में लगने वाले ज़्यादा समय को कम करने और बिलिंग शुल्क.यह सूची एक महत्वपूर्ण विचार है, क्योंकि इससे हर अनुरोध की लागत पर असर पड़ता है. ज़्यादा जानकारी के लिए, यह देखें इस्तेमाल किए जाने से जुड़ी जानकारी और बिलिंग शामिल हैं.
इनमें से एक या ज़्यादा फ़ील्ड चुनें:
ये फ़ील्ड, जगह की जानकारी (सिर्फ़ आईडी के लिए) SKU को ट्रिगर करते हैं:
Place.Field.ID,Place.Field.NAME,Place.Field.PHOTO_METADATASये फ़ील्ड, जगह की जानकारी (सिर्फ़ जगह की जानकारी) SKU को ट्रिगर करते हैं:
Place.Field.ADDRESS_COMPONENTS,Place.Field.ADDRESS,Place.Field.LAT_LNG,Place.Field.PLUS_CODE,Place.Field.TYPES,Place.Field.VIEWPORTये फ़ील्ड, जगह की जानकारी (बेसिक) SKU को ट्रिगर करते हैं:
Place.Field.BUSINESS_STATUS,Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_URL,Place.Field.UTC_OFFSET,Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCEये फ़ील्ड, जगह की जानकारी (बेहतर) SKU को ट्रिगर करते हैं:
Place.Field.CURRENT_OPENING_HOURS,Place.Field.SECONDARY_OPENING_HOURS,Place.Field.PHONE_NUMBER,Place.Field.PRICE_LEVEL,Place.Field.RATING,Place.Field.OPENING_HOURS,Place.Field.USER_RATINGS_TOTAL,Place.Field.WEBSITE_URIये फ़ील्ड, जगह की जानकारी (पसंदीदा) SKU को ट्रिगर करते हैं:
Place.Field.CURBSIDE_PICKUP,Place.Field.DELIVERY,Place.Field.DINE_IN,Place.Field.EDITORIAL_SUMMARY,Place.Field.RESERVABLE,Place.Field.REVIEWS,Place.Field.SERVES_BEER,Place.Field.SERVES_BREAKFAST,Place.Field.SERVES_BRUNCH,Place.Field.SERVES_DINNER,Place.Field.SERVES_LUNCH,Place.Field.SERVES_VEGETARIAN_FOOD,Place.Field.SERVES_WINE,Place.Field.TAKEOUT
ज़रूरी नहीं पैरामीटर
इसके लिए वैकल्पिक पैरामीटर
FetchPlaceRequest
हैं:
क्षेत्र कोड
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्रीय कोड, जिसे दो वर्ण वाले CLDR कोड की वैल्यू. कोई डिफ़ॉल्ट मान नहीं है.
अगर जवाब में
Place.Field.ADDRESSफ़ील्ड का देश का नाम मेल खाता हैregionCode,Place.Field.ADDRESSमें देश का कोड शामिल नहीं किया गया है.ज़्यादातर CLDR कोड, ISO 3166-1 कोड से मेल खाते हैं. इसमें कुछ अहम अपवाद शामिल हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है (तकनीकी तौर पर, इकाई "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉदर्न आयरलैंड" है. पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है.
क्षेत्र का कोड पैरामीटर सेट करने के लिए,
FetchPlaceRequestऑब्जेक्ट बनाते समयsetRegionCode()तरीके को कॉल करें.-
सेशन टोकन
सेशन टोकन, उपयोगकर्ता की जनरेट की गई स्ट्रिंग होती हैं, जो ऑटोकंप्लीट (नया) में, "सेशन" कॉल किए जाते हैं. ऑटोकंप्लीट की सुविधा (नया वर्शन), सेशन टोकन का इस्तेमाल इन कामों के लिए करता है यह विकल्प, उपयोगकर्ता की अपने-आप पूरी होने वाली खोज की क्वेरी का ग्रुप बनाता है और उसे चुनने के अलग-अलग चरणों को, अलग-अलग सेशन में सेट करने के लिए सेट करता है बिलिंग उद्देश्यों के लिए. सेशन टोकन, जगह की जानकारी में पास किए जाते हैं (नया) ऑटोकंप्लीट (नए) कॉल के बाद आने वाले कॉल. ज़्यादा जानकारी के लिए, यह देखें सेशन टोकन.
सेशन टोकन पैरामीटर सेट करने के लिए,
FetchPlaceRequestऑब्जेक्ट बनाते समयsetSessionToken()तरीके को कॉल करें.
जगह की जानकारी का उदाहरण
नीचे दिए गए उदाहरण में, कन्वर्ज़न विंडो के लिए ID, NAME, और 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.NAME, Place.Field.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);