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