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