जगह का आईडी मिलने के बाद, किसी खास कारोबार या दिलचस्प जगह के बारे में ज़्यादा जानकारी पाने के लिए, जगह की जानकारी (नया) का अनुरोध करें. जगह की जानकारी (नया) का अनुरोध करने पर, चुनी गई जगह के बारे में ज़्यादा जानकारी मिलती है. जैसे, उसका पूरा पता, फ़ोन नंबर, उपयोगकर्ता की रेटिंग, और समीक्षाएं.
प्लेस आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
- टेक्स्ट सर्च (नया) या आस-पास की जगहों की जानकारी (नया)
- Geocoding 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 कमांड में:
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
का इस्तेमाल करें.ये फ़ील्ड, जगह की जानकारी (सिर्फ़ जगह) एसकेयू को ट्रिगर करते हैं:
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
ये फ़ील्ड, जगह की जानकारी (बुनियादी) एसकेयू को ट्रिगर करते हैं:
accessibilityOptions
,businessStatus
,containingPlaces
,displayName
,googleMapsLinks
*,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,pureServiceAreaBusiness
,subDestinations
,utcOffsetMinutes
*googleMapsLinks
फ़ील्ड, GA से पहले के वर्शन की झलक के चरण में है और इसके लिए कोई शुल्क नहीं लिया जाता. इसका मतलब है कि झलक के दौरान इस्तेमाल के लिए, बिलिंग 0 डॉलर है.ये फ़ील्ड, जगह की जानकारी (बेहतर) SKU को ट्रिगर करते हैं:
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,priceRange
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
ये फ़ील्ड, जगह की जानकारी (प्राथमिक) एसकेयू को ट्रिगर करते हैं:
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
,reviews
,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
पर भी नहीं पड़ता, जिसमें देश का नाम कभी शामिल नहीं होता.ज़्यादातर CLDR कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ कोड अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का सीसीटीएलडी "uk" (.co.uk) है, जबकि उसका आईएसओ 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
पैरामीटर सेट करें. - लागू करें बटन चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, 'बड़ा करें' आइकॉन को चुनें.