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 بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ ضياء_أمل.

يجب تحديد قيمة واحدة على الأقل من maxHeightPx أو maxwidthPx. إذا لم يتم تحديد السمة maxHeightPx أو maxwidthPx، سيتم عرض خطأ بهدفيَّي.
maxHeightPx

integer

اختياريّ. تحدد الحد الأقصى لارتفاع الصورة بالبكسل. إذا كانت الصورة أصغر من القيم المحددة، فسيتم عرض الصورة الأصلية. وإذا كانت الصورة أكبر في أي بُعد، سيتم تغيير حجمها لتتطابق مع حجم الصورة الأصغر حجمًا، أي مع نسبة العرض إلى الارتفاع الأصلية. تقبل كل من السمتين maxHeightPx وmaxwidthPx عددًا صحيحًا بين 1 و4800 بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ ضياء_أمل.

يجب تحديد قيمة واحدة على الأقل من 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

معرّف موارد منتظم (URI) قصير الأجل يمكن استخدامه لعرض الصورة.