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

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

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

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

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

इसे आज़माएं!

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

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

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: *
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

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

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

      attributions, 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, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

  • placeId

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

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

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

  • languageCode

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

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

  • regionCode

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

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

    ज़्यादातर CLDR कोड, ISO 3166-1 कोड से मेल खाते हैं. इसमें कुछ अहम अपवाद शामिल हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "यूके" (.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 हेडर से पता चलता है कि जवाब ये डेटा फ़ील्ड शामिल हैं: id,displayName. इसके बाद, जवाब इस फ़ॉर्म में होगा:

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

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

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. एपीआई एक्सप्लोरर पैनल में, 'बड़ा करें' आइकॉन को चुनें. एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, एपीआई एक्सप्लोरर को बड़ा करें..