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

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

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

• टेक्स्ट खोज (नया) या आस-पास खोज (नई)
• जियोकोडिंग एपीआई
• Routes एपीआई
• पते की पुष्टि करने वाला एपीआई
• जगहों का अपने-आप पूरा होना

एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. ऐसा करके, एपीआई और एपीआई के विकल्पों के बारे में जाना जा सकता है:

इसे आज़माएं!

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

जगह की जानकारी के लिए अनुरोध, फ़ॉर्म में एचटीटीपी जीईटी अनुरोध होता है:

https://places.googleapis.com/v1/places/PLACE_ID

सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर या हेडर में, जीईटी अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

इसके अलावा, आप cURL निर्देश का इस्तेमाल करके भी ऐसा कर सकते हैं:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

जगह की जानकारी (नई) के जवाब

जगह की जानकारी (नया) जवाब के तौर पर JSON ऑब्जेक्ट दिखाता है. इस जवाब में:

• रिस्पॉन्स को Place ऑब्जेक्ट के तौर पर दिखाया जाता है. Place ऑब्जेक्ट में जगह के बारे में पूरी जानकारी होती है.
• अनुरोध में पास किया गया FieldMask, Place ऑब्जेक्ट में मिले फ़ील्ड की सूची के बारे में बताता है.

पूरा JSON ऑब्जेक्ट इस रूप में होता है:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

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

• FieldMask

  रिस्पॉन्स में जवाब देने के लिए, रिस्पॉन्स वाला फ़ील्ड मास्क बनाकर, उन फ़ील्ड की सूची तय करें. रिस्पॉन्स फ़ील्ड मास्क को यूआरएल पैरामीटर $fields या fields या एचटीटीपी हेडर X-Goog-FieldMask का इस्तेमाल करके पास करें. जवाब में लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं है. अगर फ़ील्ड मास्क को छोड़ दिया जाता है, तो यह तरीका एक गड़बड़ी दिखाता है.

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

  लौटाए जाने वाले जगह के डेटा टाइप की कॉमा-सेपरेटेड लिस्ट बनाएं. उदाहरण के लिए, डिसप्ले नेम और जगह के पते की जानकारी पाने के लिए.

  X-Goog-FieldMask: displayName,formattedAddress

  ध्यान दें: फ़ील्ड की सूची में कहीं भी स्पेस का इस्तेमाल नहीं किया जा सकता.

  सभी फ़ील्ड वापस पाने के लिए * का इस्तेमाल करें.

  X-Goog-FieldMask: *

  वाइल्डकार्ड "*" सभी फ़ील्ड चुनता है. हालांकि, इस वाइल्डकार्ड का डेवलपमेंट में इस्तेमाल किया जा सकता है. हालांकि, Google, प्रोडक्शन में वाइल्डकार्ड (*) रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल नहीं करने देता, क्योंकि बहुत ज़्यादा डेटा दिखाया जा सकता है.
  iconMaskBaseUri और iconBackgroundColor का इस्तेमाल करने के बारे में ज़्यादा निर्देश, जगह के आइकॉन सेक्शन में देखे जा सकते हैं.

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

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

    id, name^*, photos
    
    ^* name फ़ील्ड में, जगह संसाधन का नाम इस फ़ॉर्मैट में होता है: places/PLACE_ID. जगह के टेक्स्ट का नाम ऐक्सेस करने के लिए, displayName का इस्तेमाल करें.

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

    addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

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

    accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, और utcOffsetMinutes

  • नीचे दिए गए फ़ील्ड, जगह की जानकारी (ऐडवांस) SKU को ट्रिगर करते हैं:

    currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, और websiteUri

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

    allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, delivery, {2, {2, deliveryreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout
    

• placeId

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

  places/PLACE_ID स्ट्रिंग को, जगह संसाधन का नाम भी कहा जाता है. जगह की जानकारी (नई), आस-पास खोज (नई), और टेक्स्ट खोज (नई) के अनुरोध से मिलने वाले रिस्पॉन्स में, यह स्ट्रिंग, रिस्पॉन्स के name फ़ील्ड में दिखती है. स्टैंडअलोन प्लेस आईडी, जवाब के id फ़ील्ड में शामिल होता है.

  ध्यान दें: मौजूदा जगह की जानकारी के जवाब के name फ़ील्ड में वह नाम मौजूद है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. नए एपीआई में, उस फ़ील्ड को अब displayName कहा जाता है.

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

• languageCode

  वह भाषा जिसमें नतीजे देने हैं.

  • इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google अक्सर इस्तेमाल की जाने वाली भाषाओं को अपडेट करता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
  • अगर languageCode नहीं दिया जाता है, तो एपीआई डिफ़ॉल्ट रूप से en को दिखाता है. अमान्य भाषा का कोड देने पर, एपीआई INVALID_ARGUMENT गड़बड़ी दिखाता है.
  • एपीआई मोहल्ले का पता देने की पूरी कोशिश करता है, ताकि उपयोगकर्ता और स्थानीय, दोनों उसे आसानी से पढ़ सकें. इस लक्ष्य को हासिल करने के लिए, यह मोहल्ले के पते को स्थानीय भाषा में दिखाता है. साथ ही, ज़रूरत पड़ने पर उस स्क्रिप्ट को ऐसी स्क्रिप्ट में ट्रांसलिट्रेट किया जाता है जिसे उपयोगकर्ता आसानी से पढ़ सकता है. इस जानकारी की मदद से, उपयोगकर्ता अपनी पसंदीदा भाषा का भी ध्यान रख सकता है. बाकी सभी पते, पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट एक ही भाषा में दिखाए जाते हैं, जिसे पहले कॉम्पोनेंट से चुना जाता है.
  • अगर कोई नाम पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई काफ़ी हद तक मैच होने वाली वैल्यू का इस्तेमाल करता है.
  • एपीआई के दिखाए जाने वाले नतीजों के सेट और दिखाए जाने के क्रम पर, पसंदीदा भाषा का बहुत कम असर होता है. जियोकोडर, भाषा के मुताबिक शब्दों के संक्षिप्त रूपों का अलग-अलग मतलब निकालता है. जैसे, सड़कों के छोटे नाम या समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.

• regionCode

  रिस्पॉन्स को फ़ॉर्मैट करने के लिए इस्तेमाल किया गया क्षेत्र का कोड, जिसे दो वर्ण वाले CLDR कोड की वैल्यू के तौर पर दिखाया जाता है. कोई डिफ़ॉल्ट वैल्यू नहीं है.

  अगर जवाब में formattedAddress फ़ील्ड में दिए गए देश का नाम regionCode से मेल खाता है, तो देश कोड formattedAddress से हटा दिया जाता है. इस पैरामीटर का adrFormatAddress पर कोई असर नहीं पड़ता, जिसमें देश का नाम हमेशा शामिल होता है. इसके अलावा, shortFormattedAddress पर इसका कोई असर नहीं पड़ता, जिसमें यह कभी शामिल नहीं होता.

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

• sessionToken

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

जगह की जानकारी का उदाहरण

इस उदाहरण में placeId के ज़रिए किसी जगह की जानकारी का अनुरोध किया गया है:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

ध्यान दें कि X-Goog-FieldMask हेडर से पता चलता है कि response में ये डेटा फ़ील्ड शामिल हैं: id,displayName. इसके बाद जवाब फ़ॉर्म में होता है:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

ज़्यादा जानकारी देने के लिए, फ़ील्ड मास्क में ज़्यादा डेटा टाइप जोड़ें. उदाहरण के लिए, जवाब में पता और Plus Code शामिल करने के लिए, formattedAddress,plusCode जोड़ें:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

जवाब अब फ़ॉर्म में है:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

इसे आज़माएं!

एपीआई एक्सप्लोरर से आपको सैंपल अनुरोध बनाने की सुविधा मिलती है, ताकि आपको एपीआई और एपीआई के विकल्पों के बारे में पता चल सके.

अनुरोध करने के लिए:

1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन को चुनें.
2. विकल्प के तौर पर, name पैरामीटर को इस पर सेट करें:

   places/PLACE_ID

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

5. एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, 'बड़ा करें' आइकॉन को चुनें.