Method: places.photos.getMedia

फ़ोटो के रेफ़रंस वाली स्ट्रिंग का इस्तेमाल करके, फ़ोटो मीडिया पाएं.

एचटीटीपी अनुरोध

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. यह फ़ोटो मीडिया के संसाधन का नाम है. इसका फ़ॉर्मैट यह है: places/{placeId}/photos/{photo_reference}/media.

जगह के ऑब्जेक्ट के photos.name फ़ील्ड में, फ़ोटो के संसाधन का नाम इस फ़ॉर्मैट में दिखता है: places/{placeId}/photos/{photo_reference}. फ़ोटो मीडिया के संसाधन का नाम पाने के लिए, आपको फ़ोटो के संसाधन के नाम के आखिर में /media जोड़ना होगा.

क्वेरी पैरामीटर

पैरामीटर
maxWidthPx

integer

ज़रूरी नहीं. इससे इमेज की ज़्यादा से ज़्यादा चौड़ाई पिक्सल में तय की जाती है. अगर इमेज, तय की गई वैल्यू से छोटी है, तो ओरिजनल इमेज दिखाई जाएगी. अगर इमेज की चौड़ाई या ऊंचाई, तय की गई वैल्यू से ज़्यादा है, तो उसे दोनों में से छोटी वैल्यू के हिसाब से स्केल किया जाएगा. हालांकि, इमेज का ओरिजनल आसपेक्ट रेशियो बरकरार रहेगा. maxHeightPx और maxWidthPx, दोनों प्रॉपर्टी के लिए 1 से 4800 के बीच की कोई भी पूर्णांक वैल्यू इस्तेमाल की जा सकती है. अगर वैल्यू, तय की गई रेंज में नहीं है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी.

maxHeightPx या maxWidthPx में से कम से कम एक वैल्यू तय करनी होगी. अगर maxHeightPx और maxWidthPx, दोनों के लिए कोई वैल्यू तय नहीं की जाती है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी.
maxHeightPx

integer

ज़रूरी नहीं. इससे इमेज की ज़्यादा से ज़्यादा ऊंचाई पिक्सल में तय की जाती है. अगर इमेज, तय की गई वैल्यू से छोटी है, तो ओरिजनल इमेज दिखाई जाएगी. अगर इमेज की चौड़ाई या ऊंचाई, तय की गई वैल्यू से ज़्यादा है, तो उसे दोनों में से छोटी वैल्यू के हिसाब से स्केल किया जाएगा. हालांकि, इमेज का ओरिजनल आसपेक्ट रेशियो बरकरार रहेगा. maxHeightPx और maxWidthPx, दोनों प्रॉपर्टी के लिए 1 से 4800 के बीच की कोई भी पूर्णांक वैल्यू इस्तेमाल की जा सकती है. अगर वैल्यू, तय की गई रेंज में नहीं है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी.

maxHeightPx या maxWidthPx में से कम से कम एक वैल्यू तय करनी होगी. अगर maxHeightPx और maxWidthPx, दोनों के लिए कोई वैल्यू तय नहीं की जाती है, तो INVALID_ARGUMENT गड़बड़ी दिखेगी.
skipHttpRedirect

boolean

ज़रूरी नहीं. अगर इसे सेट किया जाता है, तो डिफ़ॉल्ट एचटीटीपी रीडायरेक्ट के तरीके को छोड़ दिया जाता है. साथ ही, जवाब को टेक्स्ट फ़ॉर्मैट में दिखाया जाता है. उदाहरण के लिए, एचटीटीपी इस्तेमाल करने के लिए, JSON फ़ॉर्मैट में जवाब दिखाया जाता है. अगर इसे सेट नहीं किया जाता है, तो इमेज मीडिया पर कॉल को रीडायरेक्ट करने के लिए, एचटीटीपी रीडायरेक्ट जारी किया जाएगा. एचटीटीपी के अलावा अन्य अनुरोधों के लिए, इस विकल्प को अनदेखा किया जाता है.

अनुरोध का मुख्य हिस्सा

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

Places API से मिला फ़ोटो मीडिया.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है:

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "name": string,
  "photoUri": string
}
फ़ील्ड
name

string

यह फ़ोटो मीडिया के संसाधन का नाम है. इसका फ़ॉर्मैट यह है: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

यह यूआरआई कुछ समय के लिए मान्य होता है. इसका इस्तेमाल, फ़ोटो दिखाने के लिए किया जा सकता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform