Method: places.photos.getMedia

الحصول على وسائط صورة تتضمّن سلسلة مرجعية للصورة

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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

اختياريّ. في حال ضبطه، يمكنك تخطّي السلوك التلقائي لإعادة توجيه HTTP وعرض استجابة بتنسيق نصي (على سبيل المثال، بتنسيق JSON لحالة استخدام HTTP). في حال عدم ضبط هذه القيمة، سيتم إصدار إعادة توجيه HTTP لإعادة توجيه المكالمة إلى وسائط الصور. يتم تجاهل هذا الخيار لطلبات غير HTTP.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ملف وسائط صورة من Places API

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "name": string,
  "photoUri": string
}
الحقول
name

string

اسم مورد لوسائط صورة بالتنسيق: places/{placeId}/photos/{photo_reference}/media.

photoUri

string

عنوان URL صالح لفترة قصيرة يمكن استخدامه لعرض الصورة.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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