Method: places.photos.getMedia

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

בקשת HTTP

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

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

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

פרמטרים
name

string

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

שם המשאב של תמונה, כפי שהוא מוחזר בשדה photos.name של אובייקט מקום, מופיע בפורמט 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). אם לא תגדירו את הפרמטר, תתבצע הפניה אוטומטית (redirect) מסוג 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/cloud-platform