परिचय
Places API, Place Details (लेगसी) के साथ काम करता है. अगर आपको Places API (लेगसी) के बारे में जानकारी है, तो Place Details (नया) में ये बदलाव किए गए हैं:
- फ़ील्ड मास्क करना ज़रूरी है. आपको यह बताना होगा कि रिस्पॉन्स में कौनसे फ़ील्ड दिखाने हैं. लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. अगर आपने यह सूची नहीं दी, तो तरीकों से गड़बड़ी का मैसेज मिलेगा. ज़्यादा जानकारी के लिए, FieldMask देखें.
- Place Details (नया), पुष्टि करने के तरीके के तौर पर एपीआई कुंजियां और OAuth टोकन, दोनों के साथ काम करता है.
- Place Details (नया) में, रिस्पॉन्स फ़ॉर्मैट के तौर पर सिर्फ़ JSON काम करता है.
- Places API (नया) के लिए JSON रिस्पॉन्स फ़ॉर्मैट लेगसी एपीआई के फ़ॉर्मैट से अलग है. ज़्यादा जानकारी के लिए, Places API के रिस्पॉन्स को माइग्रेट करना लेख देखें.
यहां दी गई टेबल में, Place Details (लेगसी) के उन पैरामीटर की सूची दी गई है जिनके नाम Place Details (नया) के लिए बदले गए हैं या जिनमें बदलाव किया गया है. साथ ही, उन पैरामीटर की सूची भी दी गई है जो अब काम नहीं करते.
| मौजूदा पैरामीटर | नया पैरामीटर | नोट |
|---|---|---|
place_id |
places/PLACE_ID |
`places/PLACE_ID` स्ट्रिंग को, जगह का
संसाधन नाम भी कहा जाता है.places/PLACE_ID Place Details (नया),
आस-पास की जगहों की जानकारी (नया) और टेक्स्ट से खोजें (नया)
के अनुरोध के रिस्पॉन्स में, यह स्ट्रिंग रिस्पॉन्स के name फ़ील्ड में शामिल होती है.
जगह की आईडी, रिस्पॉन्स के id फ़ील्ड में शामिल होती है. |
language |
languageCode |
|
region |
regionCode |
अनुरोध का उदाहरण
जीईटी अनुरोध के इस उदाहरण में, Place Details (लेगसी) का इस्तेमाल किया गया है. इस उदाहरण में, आपने JSON रिस्पॉन्स का अनुरोध किया है. इसमें, जगह की आईडी के बारे में जानकारी शामिल है. साथ ही, आपने सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर पास किया है. इस उदाहरण में, fields का भी इस्तेमाल किया गया है. इसलिए, रिस्पॉन्स में सिर्फ़ जगह का डिसप्ले नेम और फ़ॉर्मैट किया गया पता शामिल है:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Place Details (नया) के साथ, आपको जीईटी अनुरोध करना होगा. साथ ही, अनुरोध के हिस्से के तौर पर, सभी पैरामीटर को यूआरएल पैरामीटर और हेडर में पास करना होगा. इस उदाहरण में, फ़ील्ड मास्क का भी इस्तेमाल किया गया है. इसलिए, रिस्पॉन्स में सिर्फ़ जगह का डिसप्ले नेम और फ़ॉर्मैट किया गया पता शामिल है:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
स्ट्रिंग places/PLACE_ID को, जगह का
संसाधन नाम भी कहा जाता है. Place Details (नया), आस-पास की जगहों की जानकारी (नया) और टेक्स्ट से खोजें (नया) के अनुरोध के रिस्पॉन्स में, यह स्ट्रिंग रिस्पॉन्स के name फ़ील्ड में शामिल होती है. जगह की आईडी, रिस्पॉन्स के id फ़ील्ड में शामिल होती है.