जगह का आईडी मिलने के बाद, किसी खास जगह या लोकप्रिय जगह के बारे में ज़्यादा जानकारी का अनुरोध करने के लिए, जगह की जानकारी (नई) का अनुरोध करें. जगह की जानकारी (नया) के लिए किए गए अनुरोध में, बताई गई जगह के बारे में ज़्यादा जानकारी दिखती है. जैसे, जगह का पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.
प्लेस आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
- टेक्स्ट सर्च (नया) या आस-पास खोजने की सुविधा (नया)
- जियोकोडिंग एपीआई
- रूट एपीआई
- पते की पुष्टि करने वाला एपीआई
- जगह की जानकारी के अपने-आप पूरे होने की सुविधा
एपीआई एक्सप्लोरर की मदद से लाइव अनुरोध किए जा सकते हैं, ताकि आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिल सके:
इसे आज़माएं!जगह की जानकारी (नए) के अनुरोध
जगह की जानकारी के लिए किया गया अनुरोध, फ़ॉर्म में एचटीटीपी जीईटी अनुरोध होता है:
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
, {2,/},delivery
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
, जिसमें यह कभी शामिल नहीं होता.ज़्यादातर 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
हेडर से पता चलता है कि रिस्पॉन्स में ये डेटा फ़ील्ड शामिल हैं: 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" } }
इसे आज़माएं!
एपीआई एक्सप्लोरर से आपको सैंपल के तौर पर अनुरोध करने की सुविधा मिलती है. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
अनुरोध करने के लिए:
- पेज के दाईं ओर मौजूद, एपीआई आइकॉन को चुनें.
- विकल्प के तौर पर,
name
पैरामीटर को इस पर सेट करें:places/PLACE_ID
- विकल्प के तौर पर, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और
fields
पैरामीटर को फ़ील्ड मास्क पर सेट करें. - लागू करें बटन चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, 'बड़ा करें' आइकॉन चुनें.