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 وmax widthPx عددًا صحيحًا بين 1 و4800 بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ INVALID_{9}.

يجب تحديد قيمة واحدة على الأقل من maxHeightPx أو max widthPx. إذا لم يتم تحديد maxHeightPx أو max widthPx، سيتم عرض خطأ INVALID_ لذلك.
maxHeightPx

integer

اختياريّ. تحدِّد هذه السياسة الحد الأقصى لارتفاع الصورة المطلوب بالبكسل. إذا كانت الصورة أصغر من القيم المحددة، سيتم عرض الصورة الأصلية. إذا كانت الصورة أكبر في أي من البعدين، سيتم تغيير حجمها لتتطابق مع الحجم الأصغر بين البُعدين، مع حصرها بنسبة العرض إلى الارتفاع الأصلية. تقبل كل من خاصيتَي maxheightPx وmax widthPx عددًا صحيحًا بين 1 و4800 بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ INVALID_{9}.

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