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