जगह का आईडी मिलने के बाद, जगह की जानकारी (नया) से जुड़ा अनुरोध करके, किसी खास संस्थान या लोकप्रिय जगह के बारे में ज़्यादा जानकारी पाने का अनुरोध किया जा सकता है. जगह की जानकारी (नया) अनुरोध करने पर, बताई गई जगह के बारे में पूरी जानकारी मिलती है. जैसे, जगह का पूरा पता, फ़ोन नंबर, उपयोगकर्ता रेटिंग, और समीक्षाएं.
जगह का आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:
- टेक्स्ट खोज (नया) या आस-पास खोज (नई)
- जियोकोडिंग एपीआई
- Routes एपीआई
- पते की पुष्टि करने वाला एपीआई
- जगहों का अपने-आप पूरा होना
एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. ऐसा करके, एपीआई और एपीआई के विकल्पों के बारे में जाना जा सकता है:
इसे आज़माएं!जगह की जानकारी (नए) के अनुरोध
जगह की जानकारी के लिए अनुरोध, फ़ॉर्म में एचटीटीपी जीईटी अनुरोध होता है:
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 को ट्रिगर करते हैं:
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
,delivery
, {2, {2,delivery
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDesserts
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
हेडर से पता चलता है कि
response में ये डेटा फ़ील्ड शामिल हैं: 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
पैरामीटर को फ़ील्ड मास्क पर सेट करें. - लागू करें बटन को चुनें. पॉप-अप में, वह खाता चुनें जिसका इस्तेमाल आपको अनुरोध करने के लिए करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, 'बड़ा करें' आइकॉन को चुनें.