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 फ़ॉर्मैट) में रिस्पॉन्स रेंडर करें. अगर यह सेट नहीं है, तो कॉल को इमेज मीडिया पर रीडायरेक्ट करने के लिए, एक एचटीटीपी रीडायरेक्ट जारी किया जाएगा. यह विकल्प, HTTP के अलावा किसी दूसरे तरीके से किए गए अनुरोधों के लिए अनदेखा कर दिया जाता है.

अनुरोध का मुख्य भाग

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

जवाब का मुख्य भाग

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

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

JSON के काेड में दिखाना
{
  "name": string,
  "photoUri": string
}
फ़ील्ड
name

string

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

photoUri

string

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