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