Method: places.photos.getMedia

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
name

string

الزامی. نام منبع یک رسانه تصویری با فرمت: places/{placeId}/photos/{photo_reference}/media .

نام منبع یک عکس که در فیلد photos.name شیء Place برگردانده می‌شود، با فرمت places/{placeId}/photos/{photo_reference} می‌آید. برای دریافت نام منبع رسانه عکس، باید /media به انتهای منبع عکس اضافه کنید.

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

پارامترها
maxWidthPx

integer

اختیاری. حداکثر عرض دلخواه تصویر را بر حسب پیکسل مشخص می‌کند. اگر تصویر از مقادیر مشخص شده کوچکتر باشد، تصویر اصلی برگردانده می‌شود. اگر تصویر در هر دو بُعد بزرگتر باشد، مقیاس آن به گونه‌ای تنظیم می‌شود که با کوچکترین بُعد از دو بُعد مطابقت داشته باشد و به نسبت ابعاد اصلی خود محدود شود. هر دو ویژگی maxHeightPx و maxWidthPx یک عدد صحیح بین ۱ تا ۴۸۰۰ را می‌پذیرند. اگر مقدار در محدوده مجاز نباشد، خطای INVALID_ARGUMENT برگردانده می‌شود.

حداقل یکی از maxHeightPx یا maxWidthPx باید مشخص شود. اگر هیچ یک از maxHeightPx یا maxWidthPx مشخص نشده باشند، خطای INVALID_ARGUMENT بازگردانده می‌شود.

maxHeightPx

integer

اختیاری. حداکثر ارتفاع دلخواه تصویر را بر حسب پیکسل مشخص می‌کند. اگر تصویر از مقادیر مشخص شده کوچکتر باشد، تصویر اصلی برگردانده می‌شود. اگر تصویر در هر دو بُعد بزرگتر باشد، مقیاس آن به گونه‌ای تنظیم می‌شود که با کوچکترین بُعد از دو بُعد مطابقت داشته باشد و به نسبت ابعاد اصلی خود محدود شود. هر دو ویژگی maxHeightPx و maxWidthPx یک عدد صحیح بین ۱ تا ۴۸۰۰ را می‌پذیرند. اگر مقدار در محدوده مجاز نباشد، خطای 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

یک uri کوتاه مدت که می‌تواند برای رندر کردن عکس استفاده شود.

دامنه‌های مجوز

به یکی از حوزه‌های 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