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`، سيتم عرض الخطأ INVALID_ARGUMENT.
maxHeightPx

integer

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

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform