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