Method: places.photos.getMedia

קבלת מדיה של תמונה עם מחרוזת הפניה לתמונה.

בקשת HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב של מדיה מסוג תמונה בפורמט: places/{placeId}/photos/{photo_reference}/media.

שם המשאב של תמונה שמוחזר בשדה photos.name של אובייקט Place מגיע בפורמט places/{placeId}/photos/{photo_reference}. כדי לקבל את שם משאב המדיה של התמונה, צריך להוסיף את המחרוזת /media בסוף משאב התמונה.

פרמטרים של שאילתה

פרמטרים
maxWidthPx

integer

אופציונלי. מציין את הרוחב המקסימלי הרצוי של התמונה, בפיקסלים. אם התמונה קטנה מהערכים שצוינו, התמונה המקורית תוחזר. אם התמונה גדולה יותר באחד מהממדים, היא תותאם לממד הקטן מבין השניים, בהתאם ליחס הגובה-רוחב המקורי שלה. המאפיינים maxHeightPx ו-maxWidthPx מקבלים מספר שלם בין 1 ל-4,800, כולל. אם הערך לא נמצא בטווח המותר, תוחזר שגיאת INVALID_ARGUMENT.

צריך לציין לפחות אחד מהערכים maxHeightPx או maxWidthPx. אם לא מציינים את maxHeightPx או את maxWidthPx, תוחזר שגיאה מסוג INVALID_ARGUMENT.
maxHeightPx

integer

אופציונלי. מציין את הגובה המקסימלי הרצוי של התמונה, בפיקסלים. אם התמונה קטנה מהערכים שצוינו, התמונה המקורית תוחזר. אם התמונה גדולה יותר באחד מהממדים, היא תותאם לממד הקטן מבין השניים, בהתאם ליחס הגובה-רוחב המקורי שלה. המאפיינים maxHeightPx ו-maxWidthPx מקבלים מספר שלם בין 1 ל-4,800, כולל. אם הערך לא נמצא בטווח המותר, תוחזר שגיאת 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