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 באובייקט Place צריך להיות בפורמט 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 לטווח קצר שיכול לשמש לעיבוד התמונה.