परिचय
Places API, Place Photos (लेगसी) के साथ काम करता है. अगर आपको Place Photos (लेगसी) के बारे में पता है, तो Place Photos (नया वर्शन) में ये बदलाव किए गए हैं:
- Place Photos (नए वर्शन) के लिए, आपको फ़ोटो का संसाधन नाम पास करना होगा. इसमें अनुरोध के यूआरएल में सिर्फ़ फ़ोटो रेफ़रंस के बजाय, जगह का आईडी भी शामिल होता है. ज़्यादा जानकारी के लिए, फ़ोटो रेफ़रंस में बदलाव लेख पढ़ें.
- Place Photos (नए वर्शन) में, पुष्टि करने के तरीके के तौर पर एपीआई कुंजियां और OAuth टोकन, दोनों का इस्तेमाल किया जा सकता है.
यहां दी गई टेबल में, Place Photos (लेगसी) के उन पैरामीटर के बारे में बताया गया है जिनके नाम Place Photos (नए वर्शन) के लिए बदले गए हैं या जिनमें बदलाव किया गया है. इसके अलावा, उन पैरामीटर के बारे में भी बताया गया है जिन्हें अब इस्तेमाल नहीं किया जा सकता.
| मौजूदा पैरामीटर | नया पैरामीटर | नोट |
|---|---|---|
maxheight |
maxHeightPx |
आपको maxHeightPx,
maxWidthPx या दोनों में से कोई एक पैरामीटर बताना होगा. |
maxwidth |
maxWidthPx |
आपको maxHeightPx,
maxWidthPx या दोनों में से कोई एक पैरामीटर बताना होगा. |
फ़ोटो का साइज़ बढ़ाया गया
Place Photos (लेगसी) में, फ़ोटो का ज़्यादा से ज़्यादा साइज़ 1600 x 1600 पिक्सल था. Place Photos (नए वर्शन) में, फ़ोटो का साइज़ 4800 x 4800 पिक्सल तक हो सकता है.
फ़ोटो रेफ़रंस में बदलाव
Place Photos (नए वर्शन) API के लिए, आपको अनुरोध की गई फ़ोटो का संसाधन नाम पास करना होगा. इसमें जगह का आईडी और फ़ोटो रेफ़रंस शामिल होता है. इसे इस फ़ॉर्मैट में पास करना होगा:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Nearby Search (नया वर्शन), Text Search (नया वर्शन) और Place Details (नया वर्शन) के जवाब में, 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 (लेगसी), Nearby Search (लेगसी), Text Search (लेगसी) और Place Details (लेगसी) के जवाब में, photos[] कलेक्शन मिलता है. यह कलेक्शन, इस फ़ॉर्मैट के साथ काम करता है. लेगसी जवाब में, हर photo एलिमेंट में ये फ़ील्ड शामिल होते हैं:
photo_reference— यह एक स्ट्रिंग है. इसका इस्तेमाल, फ़ोटो का अनुरोध करते समय उसे पहचानने के लिए किया जाता है.height— यह इमेज की ज़्यादा से ज़्यादा ऊंचाई होती है.width— यह इमेज की ज़्यादा से ज़्यादा चौड़ाई होती है.html_attributions[]— इसमें, एट्रिब्यूशन की ज़रूरी जानकारी होती है. यह फ़ील्ड हमेशा मौजूद होता है, लेकिन यह खाली भी हो सकता है.