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