जगह की जानकारी पर माइग्रेट करना (नया)

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 फ़ील्ड.