یک رسانه عکس با رشته مرجع عکس دریافت کنید.
درخواست HTTP
GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
name | مورد نیاز. نام منبع یک رسانه عکس در قالب: نام منبع عکسی که در فیلد |
پارامترهای پرس و جو
پارامترها | |
---|---|
maxWidthPx | اختیاری. حداکثر عرض مورد نظر تصویر را بر حسب پیکسل مشخص می کند. اگر تصویر کوچکتر از مقادیر مشخص شده باشد، تصویر اصلی برگردانده می شود. اگر تصویر در هر یک از ابعاد بزرگتر باشد، برای مطابقت با ابعاد کوچکتر از دو بعد، محدود به نسبت تصویر اصلی آن، مقیاس بندی می شود. هر دو ویژگی maxHeightPx و maxWidthPx یک عدد صحیح بین 1 و 4800 را می پذیرند. اگر مقدار در محدوده مجاز نباشد، یک خطای INVALID_ARGUMENT برگردانده می شود. حداقل یکی از maxHeightPx یا maxWidthPx باید مشخص شود. اگر maxHeightPx و maxWidthPx مشخص نشده باشد، یک خطای INVALID_ARGUMENT برگردانده خواهد شد. |
maxHeightPx | اختیاری. حداکثر ارتفاع مورد نظر تصویر را بر حسب پیکسل مشخص می کند. اگر تصویر کوچکتر از مقادیر مشخص شده باشد، تصویر اصلی برگردانده می شود. اگر تصویر در هر یک از ابعاد بزرگتر باشد، برای مطابقت با ابعاد کوچکتر از دو بعد، محدود به نسبت تصویر اصلی آن، مقیاس بندی می شود. هر دو ویژگی maxHeightPx و maxWidthPx یک عدد صحیح بین 1 و 4800 را می پذیرند. اگر مقدار در محدوده مجاز نباشد، یک خطای INVALID_ARGUMENT برگردانده می شود. حداقل یکی از maxHeightPx یا maxWidthPx باید مشخص شود. اگر maxHeightPx و maxWidthPx مشخص نشده باشد، یک خطای INVALID_ARGUMENT برگردانده خواهد شد. |
skipHttpRedirect | اختیاری. در صورت تنظیم، از رفتار پیشفرض تغییر مسیر HTTP صرفنظر کنید و یک قالب متنی (مثلاً در قالب JSON برای موارد استفاده HTTP) ارائه دهید. اگر تنظیم نشود، یک تغییر مسیر HTTP برای هدایت تماس به رسانه تصویر صادر می شود. این گزینه برای درخواست های غیر HTTP نادیده گرفته می شود. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
یک رسانه عکس از Places API.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "name": string, "photoUri": string } |
فیلدها | |
---|---|
name | نام منبع یک رسانه عکس در قالب: |
photoUri | اوری کوتاه مدت که می توان از آن برای رندر عکس استفاده کرد. |