احصل على وسائط صور مع سلسلة مرجع صورة.
طلب HTTP
GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
مطلوبة. اسم المورد لوسائط الصور بالتنسيق: يكون اسم المورد للصورة كما يظهر في حقل |
معلمات طلب البحث
المَعلمات | |
---|---|
maxWidthPx |
اختياريّ. تُستخدَم لتحديد الحد الأقصى لعرض الصورة بالبكسل. إذا كانت الصورة أصغر من القيم المحددة، سيتم عرض الصورة الأصلية. إذا كانت الصورة أكبر في أي من البعدين، سيتم تغيير حجمها لتتطابق مع الحجم الأصغر بين البُعدين، مع حصرها بنسبة العرض إلى الارتفاع الأصلية. تقبل كل من خاصيتَي maxheightPx وmax widthPx عددًا صحيحًا بين 1 و4800 بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ INVALID_{9}. يجب تحديد قيمة واحدة على الأقل من maxHeightPx أو max widthPx. إذا لم يتم تحديد maxHeightPx أو max widthPx، سيتم عرض خطأ INVALID_ لذلك. |
maxHeightPx |
اختياريّ. تحدِّد هذه السياسة الحد الأقصى لارتفاع الصورة المطلوب بالبكسل. إذا كانت الصورة أصغر من القيم المحددة، سيتم عرض الصورة الأصلية. إذا كانت الصورة أكبر في أي من البعدين، سيتم تغيير حجمها لتتطابق مع الحجم الأصغر بين البُعدين، مع حصرها بنسبة العرض إلى الارتفاع الأصلية. تقبل كل من خاصيتَي maxheightPx وmax widthPx عددًا صحيحًا بين 1 و4800 بشكل شامل. إذا لم تكن القيمة ضمن النطاق المسموح به، سيتم عرض خطأ INVALID_{9}. يجب تحديد قيمة واحدة على الأقل من maxHeightPx أو max widthPx. إذا لم يتم تحديد maxHeightPx أو max widthPx، سيتم عرض خطأ INVALID_ لذلك. |
skipHttpRedirect |
اختياريّ. في حال ضبطها، يمكنك تخطّي سلوك إعادة توجيه HTTP التلقائي وعرض استجابة بتنسيق نصي (على سبيل المثال، بتنسيق JSON لحالة استخدام HTTP). وفي حال عدم ضبطها، سيتم إصدار إعادة توجيه HTTP لإعادة توجيه الاستدعاء إلى وسائط الصور. ويتم تجاهل هذا الخيار للطلبات التي لا تتوافق مع بروتوكول HTTP. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
وسائط صور من Places API
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "name": string, "photoUri": string } |
الحقول | |
---|---|
name |
اسم المورد لوسائط الصور بالتنسيق: |
photoUri |
معرّف موارد منتظم (URI) قصير يمكن استخدامه لعرض الصورة. |