परिचय
Places API, Place Details (लेगसी) के साथ काम करता है. अगर आपको Places API (लेगसी) के बारे में जानकारी है, तो जगह की जानकारी (नया) में ये बदलाव किए गए हैं:
- फ़ाइल मास्क करना ज़रूरी है. आपको यह बताना होगा कि जवाब में आपको कौनसे फ़ील्ड चाहिए. जवाब में मिले फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. इस सूची को शामिल न करने पर, ये तरीके गड़बड़ी दिखाते हैं. ज़्यादा जानकारी के लिए, FieldMask देखें.
- जगह की जानकारी (नया) एपीआई में, पुष्टि करने के तरीके के तौर पर एपीआई पासकोड और OAuth टोकन, दोनों का इस्तेमाल किया जा सकता है.
- जगह की जानकारी (नया) में, रिस्पॉन्स फ़ॉर्मैट के तौर पर सिर्फ़ JSON का इस्तेमाल किया जा सकता है.
- Places API (New) के JSON रिस्पॉन्स का फ़ॉर्मैट, लेगसी एपीआई के फ़ॉर्मैट से बदल गया है. ज़्यादा जानकारी के लिए, Places API के रिस्पॉन्स को माइग्रेट करना लेख पढ़ें.
यहां दी गई टेबल में, Place Details (लेगसी) के उन पैरामीटर के बारे में बताया गया है जिनके नाम बदलकर Place Details (नया) के लिए इस्तेमाल किए जा रहे हैं या जिनमें बदलाव किया गया है. साथ ही, उन पैरामीटर के बारे में भी बताया गया है जिनका अब इस्तेमाल नहीं किया जा सकता.
| मौजूदा पैरामीटर | नया पैरामीटर | नोट |
|---|---|---|
place_id |
places/PLACE_ID |
स्ट्रिंग places/PLACE_ID को जगह का संसाधन नाम भी कहा जाता है. जगह की जानकारी (नया), आस-पास की जगहों की जानकारी (नया), और टेक्स्ट से खोजें (नया) के अनुरोध के जवाब में, यह स्ट्रिंग 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'
जगह की जानकारी (नई) सेवा के साथ, आपको GET अनुरोध करना होता है. साथ ही, अनुरोध के हिस्से के तौर पर यूआरएल पैरामीटर और हेडर में सभी पैरामीटर पास करने होते हैं. इस उदाहरण में फ़ील्ड मास्क का भी इस्तेमाल किया गया है, ताकि जवाब में सिर्फ़ जगह का डिसप्ले नेम और फ़ॉर्मैट किया गया पता शामिल हो:
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 को जगह का संसाधन नाम भी कहा जाता है. जगह की जानकारी (नया), आस-पास की जगहों की जानकारी (नया), और टेक्स्ट से खोजें (नया) के अनुरोध के जवाब में, यह स्ट्रिंग name फ़ील्ड में शामिल होती है. स्टैंडअलोन प्लेस आईडी, जवाब के id फ़ील्ड में मौजूद होता है.