परिचय
Places API, Place Photos (लेगसी) के साथ काम करता है. अगर आपको Place Photos (लेगसी) के बारे में जानकारी है, तो आपको बता दें कि Place Photos (नया) में ये बदलाव किए गए हैं:
- Place Photos (New) के लिए, आपको फ़ोटो का संसाधन नाम पास करना होगा. इसमें अनुरोध के यूआरएल में जगह का आईडी शामिल होता है, न कि सिर्फ़ फ़ोटो का रेफ़रंस. ज़्यादा जानकारी के लिए, फ़ोटो रेफ़रंस में बदलाव लेख पढ़ें.
- Place Photos (New), पुष्टि करने के तरीके के तौर पर एपीआई पासकोड और OAuth टोकन, दोनों के साथ काम करता है.
यहां दी गई टेबल में, Place Photos (लेगसी) के उन पैरामीटर की सूची दी गई है जिनका नाम Place Photos (नए वर्शन) के लिए बदला गया है या जिनमें बदलाव किया गया है. इसके अलावा, इसमें उन पैरामीटर की सूची भी दी गई है जो अब काम नहीं करते.
| मौजूदा पैरामीटर | नया पैरामीटर | नोट |
|---|---|---|
maxheight |
maxHeightPx |
आपको maxHeightPx, maxWidthPx या दोनों की जानकारी देनी होगी. |
maxwidth |
maxWidthPx |
आपको maxHeightPx, maxWidthPx या दोनों की जानकारी देनी होगी. |
फ़ोटो का साइज़ बढ़ाना
Place Photos (लेगसी) में, ज़्यादा से ज़्यादा 1600 x 1600 पिक्सल साइज़ की फ़ोटो इस्तेमाल की जा सकती थी. Place Photos (New) में, 4800 x 4800 पिक्सल तक की इमेज इस्तेमाल की जा सकती हैं.
फ़ोटो रेफ़रंस में बदलाव करना
Place Photos (नया) एपीआई के लिए, आपको अनुरोध की गई फ़ोटो का संसाधन का नाम पास करना होगा. इसमें जगह का आईडी और फ़ोटो का रेफ़रंस शामिल होता है. इसे इस फ़ॉर्मैट में पास करना होगा:
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[]— ज़रूरी एट्रिब्यूशन. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन हो सकता है कि यह खाली हो.