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

परिचय

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

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

• टेक्स्ट खोज (नई सुविधा) या आस-पास की जगहें खोजने की सुविधा (नई सुविधा)
• Geocoding API
• Routes API
• Address Validation API
• ऑटोकंप्लीट (नई सुविधा)

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

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

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

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

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

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

या कर्ल कमांड में:

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: *

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

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

    attributions
id
name^*
    photos
    

    ^* name फ़ील्ड में जगह का संसाधन का नाम होता है. यह इस फ़ॉर्म में होता है: places/PLACE_ID. जगह का नाम टेक्स्ट के तौर पर पाने के लिए, Pro SKU में displayName फ़ील्ड का अनुरोध करें.

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

    addressComponents
addressDescriptor^*
    adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
    
    ^* पते के बारे में जानकारी देने वाले शब्द, आम तौर पर भारत में खरीदारों के लिए उपलब्ध हैं. हालांकि, अन्य देशों में यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.
    
    

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

    accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes
    
    

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

    currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
userRatingCount
websiteUri

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

    allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries^*
    servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
    
    ^* सिर्फ़ टेक्स्ट खोज और आस-पास की जगहें खोजने की सुविधा के लिए

• placeId

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

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

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

• languageCode

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

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

• regionCode

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

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

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

• sessionToken

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

जगह के बारे में ज़्यादा जानकारी (नई) का उदाहरण

यहां दिए गए उदाहरण में, 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"
  }
}

अतिरिक्त जानकारी पाने के लिए, फ़ील्ड मास्क में ज़्यादा डेटा टाइप जोड़ें. उदाहरण के लिए, जवाब में पता और प्लस कोड शामिल करने के लिए, 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"
  }
}

Address descriptors पाना

पते के डिस्क्रिप्टर, किसी जगह की लोकेशन के बारे में जानकारी देते हैं. इसमें आस-पास के लैंडमार्क और इलाके शामिल हैं.

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

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

जवाब में, अनुरोध में बताई गई जगह की जानकारी शामिल होती है. साथ ही, आस-पास के लैंडमार्क की सूची और जगह से उनकी दूरी की जानकारी भी शामिल होती है. इसके अलावा, जगहों की सूची और जगह से उनके जुड़ाव की जानकारी भी शामिल होती है:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

इसे आज़माएं!

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

1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.

2. अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.

3. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

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