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

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

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

यहां दी गई टेबल में, जगह की फ़ोटो (लेगसी) के ऐसे पैरामीटर दिए गए हैं जिनका नाम बदल दिया गया है या जिनमें जगह की फ़ोटो (नया) के लिए बदलाव किया गया है. इसके अलावा, इसमें ऐसे पैरामीटर भी दिए गए हैं जो अब काम नहीं करते.

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

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

जगह की फ़ोटो (लेगसी) की सुविधा के साथ, ज़्यादा से ज़्यादा 1600 x 1600 पिक्सल की फ़ोटो इस्तेमाल की जा सकती थी. जगह की फ़ोटो (नया) के लिए, ज़्यादा से ज़्यादा 4800 x 4800 पिक्सल का साइज़ इस्तेमाल किया जा सकता है.

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

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

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