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

परिचय

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

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

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

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

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

जगह की जानकारी (नया वर्शन) का अनुरोध, इस तरह का एचटीटीपी GET अनुरोध होता है:

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

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

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

Place Details (नया) के जवाब

Place Details (New) सेवा, रिस्पॉन्स के तौर पर 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: *

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

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

    attributions
consumerAlert
id
movedPlace
movedPlaceId
name^*
    photos
    

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

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

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

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

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

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

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

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

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

    currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
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, इस्तेमाल की जा सकने वाली भाषाओं की सूची को अक्सर अपडेट करता रहता है. इसलिए, हो सकता है कि इस सूची में सभी भाषाएं शामिल न हों.
  • अगर languageCode नहीं दिया गया है, तो एपीआई डिफ़ॉल्ट रूप से en का इस्तेमाल करता है. अगर आपने अमान्य भाषा कोड डाला है, तो एपीआई INVALID_ARGUMENT गड़बड़ी का मैसेज दिखाता है.
  • एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को हासिल करने के लिए, यह स्थानीय भाषा में मोहल्ले के पते दिखाता है. अगर ज़रूरी हो, तो उपयोगकर्ता की पसंदीदा भाषा को ध्यान में रखते हुए, उसे ऐसी स्क्रिप्ट में ट्रांसलिट्रेट किया जाता है जिसे उपयोगकर्ता पढ़ सके. अन्य सभी पते, आपकी पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट उसी भाषा में दिखाए जाते हैं जो पहले कॉम्पोनेंट के लिए चुनी गई है.
  • अगर पसंदीदा भाषा में कोई नाम उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
  • पसंदीदा भाषा का असर, एपीआई से मिलने वाले नतीजों के सेट और उनके क्रम पर थोड़ा पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए इस्तेमाल किए जाने वाले शॉर्ट फ़ॉर्म या समानार्थी शब्द, जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.

• regionCode

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

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

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

• sessionToken

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

Place Details (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 हेडर से पता चलता है कि रिस्पॉन्स में ये डेटा फ़ील्ड शामिल हैं: 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"
  }
}

रेटिंग, समीक्षाओं की संख्या, और समीक्षाएं पाना

किसी कारोबार की औसत स्टार रेटिंग, रेटिंग की कुल संख्या (कुल समीक्षाएं) या खरीदार की समीक्षा का टेक्स्ट पाने के लिए, अपने X-Goog-FieldMask हेडर में उससे जुड़े फ़ील्ड शामिल करें:

• rating और userRatingCount: जगह की औसत रेटिंग (1.0 से 5.0 तक) और समीक्षाओं की कुल संख्या दिखाता है. इन फ़ील्ड का अनुरोध करने पर, Place Details Enterprise SKU ट्रिगर होता है.
• reviews और reviewSummary: उपयोगकर्ता के सबमिट किए गए ज़्यादा से ज़्यादा पांच Review ऑब्जेक्ट और एआई से जनरेट की गई समीक्षाओं की खास जानकारी दिखाएं. इन फ़ील्ड का अनुरोध करने पर, Place Details Enterprise + Atmosphere SKU ट्रिगर होता है.

अगर आपके ऐप्लिकेशन को सिर्फ़ स्टार रेटिंग और समीक्षाओं की कुल संख्या की ज़रूरत है, तो reviews के बिना rating और userRatingCount का अनुरोध करें, ताकि अनुरोध Place Details Enterprise SKU टियर में रहे:

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

उपयोगकर्ता के सबमिट किए गए ज़्यादा से ज़्यादा पांच Review ऑब्जेक्ट को भी वापस पाने के लिए, फ़ील्ड मास्क में reviews जोड़ें. इसके लिए, Place Details Enterprise + Atmosphere SKU टियर के हिसाब से बिलिंग की जाती है:

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

जवाब में रेटिंग, रेटिंग की कुल संख्या, और reviews अरे शामिल होता है:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  },
  "rating": 4.2,
  "userRatingCount": 2594,
  "reviews": [
    {
      "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...",
      "relativePublishTimeDescription": "a month ago",
      "rating": 5,
      "text": {
        "text": "Iconic tech campus with visitor areas and cafes.",
        "languageCode": "en"
      },
      "authorAttribution": {
        "displayName": "Alex Rivera"
      }
    }
  ]
}

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) businessStatus फ़ील्ड में CLOSED_PERMANENTLY दिखाता है. साथ ही, रिस्पॉन्स बॉडी में movedPlace और movedPlaceId फ़ील्ड को शामिल नहीं करता.

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

जिन जगहों को नहीं हटाया गया है उनके लिए, Place Details (New) रिस्पॉन्स बॉडी में 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"
}

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

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

आने वाले समय में खुलने वाले कारोबारों को ढूंढना

आने वाले समय में खुलने वाले कारोबारों के बारे में जानकारी मांगी जा सकती है. अगर कारोबार के खुलने की अनुमानित तारीख में कम से कम महीना शामिल है और वह तारीख 90 दिनों से कम है, तो आस-पास की जगहों की जानकारी (नया वर्शन) की सुविधा, openingDate फ़ील्ड को अपने-आप भर देगी.

यहां न्यू मेडोज़, इडाहो में आने वाले समय में खुलने वाले कारोबार के लिए, आस-पास की जगहों की जानकारी (नया वर्शन) के अनुरोध का उदाहरण दिया गया है:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

जवाब में, जगह के कारोबार की स्थिति और उसके खुलने की अनुमानित तारीख शामिल होती है:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

बस, मेट्रो वगैरह के स्टेशन की जानकारी पाना

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

यहां दिए गए उदाहरण में, ग्रैंड सेंट्रल स्टेशन के लिए बस, मेट्रो वगैरह के स्टेशन की जानकारी का अनुरोध दिखाया गया है:

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

रिस्पॉन्स के मुख्य हिस्से में, तय की गई दूरी के दायरे में मौजूद हर स्टेशन की जानकारी शामिल होती है. इसमें स्टेशन से जुड़ी लाइनें, उस स्टॉप पर ट्रांसपोर्ट एजेंसियों की ओर से जारी की गई सूचनाएं, और बस/ट्रेन के छूटने की जानकारी शामिल होती है:

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

एंट्री और नेविगेशन पॉइंट की जानकारी पाना

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

नेविगेशन पॉइंट, navigationPointToken दिखाते हैं. इस टोकन को Navigation SDK (Android या iOS के लिए उपलब्ध है) या Routes API को पास किया जा सकता है, ताकि ड्राइवर को उस जगह तक पहुंचने के लिए निर्देश दिए जा सकें. ज़्यादा जानकारी के लिए, नेविगेशन पॉइंट टोकन देखें.

यहां दिए गए उदाहरण में, इंदिरा गांधी अंतरराष्ट्रीय हवाई अड्डे (जगह का आईडी ChIJVVVVVYx3j4ARP-3NGldc8qQ) की जानकारी का अनुरोध किया गया है. इसमें फ़ील्ड मास्क में entrances और navigationPoints शामिल हैं:

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

जवाब में, जगह के लिए एंट्री पॉइंट और नेविगेशन पॉइंट शामिल होते हैं:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

इसे आज़माएं!

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

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

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

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

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