जगह की फ़ोटो पर माइग्रेट करें (नया)

Places API, मौजूदा जगह की फ़ोटो के साथ काम करता है. अगर आपको 'जगह की मौजूदा फ़ोटो' के बारे में जानकारी है, तो जगह की फ़ोटो के नए वर्शन में ये बदलाव किए गए हैं:

  • 'जगह की फ़ोटो' सेवा की नई सेवा के लिए ज़रूरी है कि आप फ़ोटो के संसाधन का नाम पास करें. यह नाम अनुरोध के यूआरएल में मौजूद जगह का आईडी होना चाहिए, न कि सिर्फ़ फ़ोटो का रेफ़रंस. ज़्यादा जानकारी के लिए, फ़ोटो वाली पहचान फ़ाइलों में बदलाव करना देखें.
  • 'जगह की फ़ोटो' सुविधा की नई सेवा, पुष्टि करने के तरीके के तौर पर एपीआई पासकोड और OAuth दोनों टोकन के साथ काम करती है.

इस टेबल में, 'जगह की मौजूदा फ़ोटो' में मौजूद उन पैरामीटर की सूची दी गई है जिन्हें 'जगह की नई फ़ोटो' के लिए बदला गया है या बदला गया है. इसके अलावा, यहां कुछ ऐसे पैरामीटर भी दिए गए हैं जो अब काम नहीं करते.

मौजूदा पैरामीटर नया पैरामीटर ज़रूरी जानकारी
maxheight maxHeightPx आपको maxHeightPx, maxWidthPx या दोनों में से किसी एक की जानकारी देनी होगी.
maxwidth maxWidthPx आपको maxHeightPx, maxWidthPx या दोनों में से किसी एक की जानकारी देनी होगी.

फ़ोटो का साइज़ बढ़ाया गया

जगह की मौजूदा फ़ोटो में ज़्यादा से ज़्यादा 1600 x 1600 पिक्सल की फ़ोटो हो सकती है. जगह की फ़ोटो (नई) 4800 x 4800 पिक्सल तक के साइज़ के साथ काम करती है.

फ़ोटो रेफ़रंस में बदलाव करें

नए Place Photo एपीआई का इस्तेमाल करने के लिए ज़रूरी है कि आप अनुरोध की गई फ़ोटो के रिसॉर्स का नाम पास करें. इसमें जगह का आईडी और फ़ोटो का रेफ़रंस शामिल है. यह फ़ॉर्म इस फ़ॉर्म में होना चाहिए:

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