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