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