ב-Places API יש תמיכה בתמונה הקיימת של המקום. אם אתם מכירים את התמונה הקיימת של המקום, הגרסה החדשה של התמונה של המקום כוללת את השינויים הבאים:
- בשירות החדש של תמונות של מקומות, צריך להעביר את שם המשאב של התמונה, שכולל את מזהה המקום, ב-URL של הבקשה, במקום רק את הפניה לתמונה. למידע נוסף, ראו שינוי לתמונות עזר.
- שירות התמונות החדש של המקומות תומך גם במפתחות API וגם באסימוני OAuth כמנגנון אימות.
בטבלה הבאה מפורטים פרמטרים בתמונה הקיימת של המקום ששינו את השם או שונו לתמונה החדשה של המקום, או פרמטרים שכבר לא נתמכים.
| הפרמטר הנוכחי | פרמטר חדש | הערות |
|---|---|---|
maxheight |
maxHeightPx |
חובה לציין את הערך maxHeightPx, maxWidthPx או את שניהם. |
maxwidth |
maxWidthPx |
חובה לציין את הערך maxHeightPx, maxWidthPx או את שניהם. |
הגדלת גודל התמונות
בתמונה הקיימת של המקום, הגודל המקסימלי של התמונה היה 1,600 על 1,600 פיקסלים. התמונה של המקום (חדש) תומכת בגדלים של עד 4,800 על 4,800 פיקסלים.
שינוי לתמונות לדוגמה
ב-API החדש של תמונות של מקומות צריך להעביר את שם המשאב של התמונה המבוקשת, שכולל מזהה מקום והפניה לתמונה, בפורמט הבא:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
הגרסאות החדשות של 'חיפוש בקרבת מקום', 'חיפוש טקסט' ו'פרטי מקום' כולן מחזירות מערך photos[] בתגובה שתומכת בפורמט הזה. כל רכיב של photos[] בתגובה החדשה מכיל את השדות הבאים:
name– מחרוזת שמכילה את שם המשאב של התמונה. המחרוזת הזו בפורמט:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx– הגובה המקסימלי של התמונה, בפיקסלים.widthPx— הרוחב המקסימלי של התמונה, בפיקסלים.authorAttributions[]– כל הקרדיטים הנדרשים. השדה הזה תמיד מופיע, אבל יכול להיות שהוא יהיה ריק.
ב-API הקיים, צריך להעביר רק את הפנייה לתמונה, בפורמט:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
הפונקציות הקיימות 'חיפוש מקום', 'חיפוש בקרבת מקום', 'חיפוש טקסט' ו'פרטי מקום' מחזירות מערך photos[] בתגובה שתומכת בפורמט הזה. כל רכיב photo בתגובה הקיימת מכיל את השדות הבאים:
photo_reference– מחרוזת שמשמשת לזיהוי התמונה כששולחים בקשה ל-Photos.height– הגובה המקסימלי של התמונה.width– הרוחב המקסימלי של התמונה.html_attributions[]– כל הקרדיטים הנדרשים. השדה הזה תמיד קיים, אבל יכול להיות שהוא יהיה ריק.