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 של אובייקט מקום מגיע בפורמט places/{placeId}/photos/{photo_reference}. כדי לקבל את השם של משאב המדיה של התמונה, צריך לצרף את הטקסט /media בסוף משאב התמונה.

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

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