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

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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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

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

Place Details (New) के अनुरोध

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 Details (नया) के जवाब

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

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

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

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

  • जगह का आईडी

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

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

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

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

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

    • इन फ़ील्ड से, Place Details Essentials IDs Only SKU ट्रिगर होता है:

      Place.Field.ID
      Place.Field.PHOTO_METADATAS
      Place.Field.RESOURCE_NAME

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

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

      Place.Field.ADDRESS_COMPONENTS
      ADR_FORMAT_ADDRESS
      Place.Field.FORMATTED_ADDRESS*
          * Place.Field.ADDRESS (अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
      Place.Field.LOCATION*
          * Place.Field.LAT_LNG (अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
      Place.Field.PLUS_CODE
      Place.Field.SHORT_FORMATTED_ADDRESS
      Place.Field.TYPES
      Place.Field.VIEWPORT

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

    • इन फ़ील्ड से, Place Details Pro एसकेयू ट्रिगर होता है:

      Place.Field.ACCESSIBILITY_OPTIONS*
          * Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE के बजाय इसका इस्तेमाल करें. अब का इस्तेमाल नहीं किया जाता.
      Place.Field.BUSINESS_STATUS
      Place.Field.DISPLAY_NAME*
          * Place.Field.NAME के बजाय इसका इस्तेमाल करें, क्योंकि अब का इस्तेमाल नहीं किया जाता.
      Place.Field.GOOGLE_MAPS_URI
      Place.Field.ICON_BACKGROUND_COLOR
      Place.Field.ICON_MASK_URL*
          * Place.Field.ICON_URL (अब काम नहीं करता) के बजाय इसका इस्तेमाल करें.
      Place.Field.PRIMARY_TYPE
      Place.Field.PRIMARY_TYPE_DISPLAY_NAME
      Place.Field.SUB_DESTINATIONS
      Place.Field.UTC_OFFSET

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

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

      Place.Field.CURRENT_OPENING_HOURS
      Place.Field.CURRENT_SECONDARY_OPENING_HOURS
      Place.Field.INTERNATIONAL_PHONE_NUMBER*
          * Place.Field.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.USER_RATINGS_TOTAL के बजाय इसका इस्तेमाल करें, क्योंकि अब यह काम नहीं करता.
      Place.Field.WEBSITE_URI

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

    • इन फ़ील्ड से, Place Details Enterprise Plus 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 से देश का कोड हटा दिया जाता है.

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

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

  • सेशन टोकन

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

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

Place Details का उदाहरण

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