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