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، سيتم عرض خطأ بهدفيَ دولي.
maxHeightPx

integer

اختياريّ. تحدد الحد الأقصى لارتفاع الصورة بالبكسل. إذا كانت الصورة أصغر من القيم المحدّدة، سيتم عرض الصورة الأصلية. إذا كانت الصورة أكبر في أيّ من سمتَيها، سيتم تصغيرها لتتطابق مع أصغر سمتَيها، مع الاحتفاظ بنسبة العرض إلى الارتفاع الأصلية. تقبل كلّ من السمتَين maxHeightPx وmaxWidthPx عددًا صحيحًا بين 1 و4800، شاملةً. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض الخطأ INVALID_ARGUMENT.

يجب تحديد سمة واحدة على الأقل من maxHeightPx أو maxWidthPx. إذا لم يتم تحديد قيمة maxHeightPx أو maxwidthPx، سيتم عرض خطأ بهدفيَ دولي.
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 صالح لفترة قصيرة يمكن استخدامه لعرض الصورة.