Places API תומך בממשק הקיים תמונה של מקום. אם אתם מכירים את תמונת המקום הקיימת, גרסה חדשה של תמונת מקום מבצע את השינויים הבאים:
- השירות החדש 'תמונת מקום' מחייב להעביר את שם המשאב של התמונה, שכולל את מזהה המקום כתובת האתר של הבקשה, ולא רק את ההפניה לתמונה. מידע נוסף זמין במאמר הבא: שינוי להפניות של תמונות.
- שירות התמונות החדש של מיקומים תומך גם במפתחות 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– מחרוזת שמשמשת לזיהוי התמונה כששולחים בקשה לתמונה.height– הגובה המקסימלי של התמונה.width– הרוחב המקסימלי של התמונה.html_attributions[]– כל הייחוסים הנדרשים. השדה הזה תמיד מופיע, אבל יכול להיות שהוא יהיה ריק.