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