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