जगह की फ़ोटो की सुविधा पर माइग्रेट करना (नई सुविधा)

परिचय

Places API, Place Photos (लेगसी) के साथ काम करता है. अगर आपको Place Photos (Legacy) के बारे में पता है, तो Place Photos (New) में ये बदलाव किए गए हैं:

• Place Photos (New) API के लिए, आपको फ़ोटो का संसाधन नाम पास करना होगा. इसमें फ़ोटो के रेफ़रंस के बजाय, अनुरोध यूआरएल में जगह का आईडी शामिल होता है. ज़्यादा जानकारी के लिए, फ़ोटो के रेफ़रंस में बदलाव करना लेख पढ़ें.
• Place Photos (नया वर्शन) में पुष्टि करने के तरीके के तौर पर, एपीआई कुंजियों और OAuth टोकन, दोनों का इस्तेमाल किया जा सकता है.

यहां दी गई टेबल में, Place Photos (लेगसी) के उन पैरामीटर की सूची दी गई है जिनके नाम बदल दिए गए हैं या जिन्हें Place Photos (नया वर्शन) के लिए बदल दिया गया है. इसमें उन पैरामीटर की सूची भी दी गई है जो अब काम नहीं करते.

मौजूदा पैरामीटर	नया पैरामीटर	नोट
maxheight	maxHeightPx	आपको maxHeightPx, maxWidthPx या दोनों में से किसी एक की वैल्यू देनी होगी.
maxwidth	maxWidthPx	आपको maxHeightPx, maxWidthPx या दोनों में से किसी एक की वैल्यू देनी होगी.

फ़ोटो का साइज़ बढ़ाया गया

Place Photos (लेगसी) में, ज़्यादा से ज़्यादा 1600 x 1600 पिक्सल की फ़ोटो इस्तेमाल की जा सकती थी. जगह की फ़ोटो (नई सुविधा) 4800 x 4800 पिक्सल तक के साइज़ वाली फ़ोटो के साथ काम करती है.

फ़ोटो रेफ़रंस पर स्विच करना

जगह की फ़ोटो (नई) API के लिए ज़रूरी है कि आप अनुरोध की गई फ़ोटो का संसाधन नाम पास करें. इसमें जगह का आईडी और फ़ोटो का रेफ़रंस शामिल होता है. इसे इस फ़ॉर्म में पास करें:

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

'आस-पास खोजें' (नई), 'टेक्स्ट से खोजें' (नई), और 'जगह की जानकारी' (नई) के लिए, जवाब में photos[] ऐरे मिलता है. यह ऐरे इस फ़ॉर्मैट के साथ काम करता है. नए जवाब में मौजूद photos[] के हर एलिमेंट में ये फ़ील्ड शामिल होते हैं:

• name — इस स्ट्रिंग में फ़ोटो का संसाधन नाम होता है. यह स्ट्रिंग इस फ़ॉर्म में होती है:

  places/PLACE_ID/photos/PHOTO_REFERENCE

• heightPx — इमेज की ज़्यादा से ज़्यादा ऊंचाई, पिक्सल में.
• widthPx — इमेज की ज़्यादा से ज़्यादा चौड़ाई, पिक्सल में.
• authorAttributions[] — ज़रूरी एट्रिब्यूशन. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन हो सकता है कि यह खाली हो.

लेगसी एपीआई के साथ, आपको सिर्फ़ फ़ोटो रेफ़रंस पास करना होता है. यह इस फ़ॉर्म में होता है:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

Find Place (लेगसी), Nearby Search (लेगसी), Text Search (लेगसी), और Place Details (लेगसी) ये सभी, इस फ़ॉर्मैट के साथ काम करने वाले रिस्पॉन्स में photos[] ऐरे दिखाते हैं. लेगसी रिस्पॉन्स में मौजूद हर photo एलिमेंट में ये फ़ील्ड शामिल होते हैं:

• photo_reference — यह एक स्ट्रिंग है. इसका इस्तेमाल, फ़ोटो का अनुरोध करते समय फ़ोटो की पहचान करने के लिए किया जाता है.
• height — इमेज की ज़्यादा से ज़्यादा ऊंचाई.
• width — इमेज की ज़्यादा से ज़्यादा चौड़ाई.
• html_attributions[] — ज़रूरी एट्रिब्यूशन. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन हो सकता है कि यह खाली हो.