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