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