Method: places.photos.getMedia

یک رسانه عکس با رشته مرجع عکس دریافت کنید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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

اختیاری. در صورت تنظیم، از رفتار پیش‌فرض تغییر مسیر HTTP صرفنظر کنید و یک قالب متنی (مثلاً در قالب JSON برای موارد استفاده HTTP) ارائه دهید. اگر تنظیم نشود، یک تغییر مسیر HTTP برای هدایت تماس به رسانه تصویر صادر می شود. این گزینه برای درخواست های غیر HTTP نادیده گرفته می شود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

یک رسانه عکس از Places API.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "name": string,
  "photoUri": string
}
فیلدها
name

string

نام منبع یک رسانه عکس در قالب: places/{placeId}/photos/{photo_reference}/media .

photoUri

string

اوری کوتاه مدت که می توان از آن برای رندر عکس استفاده کرد.