Places API תומך בתמונה הקיימת של המקום. אם אתם מכירים את התמונה הקיימת של המקום, הגרסה החדשה של התמונה של המקום כוללת את השינויים הבאים:
- בשירות החדש של תמונות של מקומות, צריך להעביר את שם המשאב של התמונה, שכולל את מזהה המקום, בכתובת ה-URL של הבקשה, במקום רק את ההפניה לתמונה. למידע נוסף, ראו שינוי לתמונות עזר.
- שירות התמונות החדש של מיקומים תומך גם במפתחות API וגם באסימוני OAuth כמנגנון אימות.
בטבלה הבאה מפורטים פרמטרים בתמונה הקיימת של המקום ששינו את השם או שונו לתמונה החדשה של המקום, או פרמטרים שכבר לא נתמכים.
| הפרמטר הנוכחי | פרמטר חדש | הערות |
|---|---|---|
maxheight |
maxHeightPx |
צריך לציין את הערך maxHeightPx, את הערך maxWidthPx או את שניהם. |
maxwidth |
maxWidthPx |
צריך לציין את הערך maxHeightPx, את הערך maxWidthPx או את שניהם. |
הגדלת גודל התמונות
בתמונה הקיימת של המקום, הגודל המקסימלי של התמונה היה 1,600 על 1,600 פיקסלים. התמונה של המקום (חדש) תומכת בגדלים של עד 4,800 על 4,800 פיקסלים.
שינוי לתמונות לדוגמה
ב-API החדש של Place Photo צריך להעביר את שם המשאב של התמונה המבוקשת, שכולל מזהה מקום והפניה לתמונה, בפורמט הבא:
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– מחרוזת שמשמשת לזיהוי התמונה כששולחים בקשה לתמונה.height– הגובה המקסימלי של התמונה.width– הרוחב המקסימלי של התמונה.html_attributions[]– פרטי ייחוס (קרדיט) נדרשים. השדה הזה תמיד מופיע, אבל יכול להיות שהוא יהיה ריק.