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

परिचय

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

• 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 पिक्सल तक के साइज़ वाली फ़ोटो के साथ काम करती है.

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

Place Photos (नया) 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 (लेगसी), आस-पास की जगहों की जानकारी (लेगसी), टेक्स्ट से खोजें (लेगसी), और जगह के बारे में ज़्यादा जानकारी (लेगसी) के अनुरोध के जवाब में, photos[] की एक ऐसी ऐरे मिलती है जो इस फ़ॉर्मैट के साथ काम करती है. लेगसी रिस्पॉन्स में मौजूद हर photo एलिमेंट में ये फ़ील्ड शामिल होते हैं:

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