ב-Places API יש תמיכה בתמונה של מקום (קודם). אם אתם מכירים את התכונה 'תמונה של מקום' (מהדורה קודמת), תמונה של מקום (מהדורה חדשה) כוללת את השינויים הבאים:
- כדי להשתמש ב-Place Photo (חדש), צריך להעביר את שם המשאב של התמונה, שכולל את מזהה המקום, בכתובת ה-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[]– פרטי ייחוס (קרדיט) נדרשים. השדה הזה תמיד קיים, אבל יכול להיות שהוא יהיה ריק.