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
Nearby Search, टेक्स्ट खोज, और जगह की जानकारी के नए वर्शन, रिस्पॉन्स में 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[]— सभी ज़रूरी एट्रिब्यूशन. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन हो सकता है कि यह खाली हो.