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