Method: places.photos.getMedia

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
  • ייצוג JSON

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

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