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

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा
यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

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

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

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

जगह की जानकारी (नई) का अनुरोध, इस फ़ॉर्म में एचटीटीपी 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: *

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

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

      attributions
      id
      moved_place
      moved_place_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

    • इन फ़ील्ड से, जगह की जानकारी देने वाले 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"
        }
      ]
    }
  }

किसी जगह की जानकारी पाना, जिसे दूसरी जगह पर ले जाया गया है

अगर आपके ऐप्लिकेशन में बताई गई किसी जगह को दूसरी जगह पर ले जाया गया है, तो नई जगह की जानकारी पाने के लिए, movedPlace और movedPlaceId फ़ील्ड का इस्तेमाल करें.

हमेशा के लिए बंद जगहों के लिए, Place Details (New) API, businessStatus फ़ील्ड में CLOSED_PERMANENTLY दिखाता है. साथ ही, रिस्पॉन्स बॉडी में movedPlace और movedPlaceId फ़ील्ड शामिल नहीं करता है.

जिन जगहों के लिए पता बदल गया है, उनके लिए Place Details (New) API, businessStatus फ़ील्ड में CLOSED_PERMANENTLY दिखाता है. साथ ही, जवाब के मुख्य हिस्से के movedPlace और movedPlaceId फ़ील्ड में नया पता दिखाता है.

जिन जगहों की जानकारी नहीं बदली है उनके लिए, जगह की जानकारी (नई) सुविधा के जवाब में movedPlace या movedPlaceId नहीं दिखता.

यहां दिए गए उदाहरण में, कनाडा के क्यूबेक में मौजूद Marche IGA St-Canut के बारे में जानकारी का अनुरोध किया गया है:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

अनुरोध करने पर, यह जवाब मिलता है:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

नई जगह के बारे में जानकारी का अनुरोध करने के लिए, Place Details (New) के नए अनुरोध में movedPlace फ़ील्ड में Place रिसॉर्स का नाम इस्तेमाल करें.

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

इसे आज़माएं!

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

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

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

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

  4. APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.