פרויקט: /maps/documentation/places/web-service/_project.yaml ספר: /maps/documentation/places/web-service/_book.yaml
Places API תומך ב-Place Photos (קודם). אם אתם משתמשים ב-Place Photos (הממשק הקודם), Place Photos (הממשק החדש) כולל את השינויים הבאים:
- כדי להשתמש ב-Place Photos (חדש), צריך להעביר את שם המשאב של התמונה, שכולל את מזהה המקום, בכתובת ה-URL של הבקשה, במקום רק את ההפניה לתמונה. למידע נוסף, ראו מעבר להפניות לתמונות.
- Place Photos (הגרסה החדשה) תומך גם במפתחות API וגם באסימוני OAuth כמנגנון אימות.
בטבלה הבאה מפורטים פרמטרים ב-Place Photos (מדור קודם) ששינו את השם או שונו ב-Place Photos (חדש), או פרמטרים שכבר אין תמיכה בהם.
| הפרמטר הנוכחי | פרמטר חדש | הערות |
|---|---|---|
maxheight |
maxHeightPx |
צריך לציין את הערך maxHeightPx, את הערך maxWidthPx או את שניהם. |
maxwidth |
maxWidthPx |
צריך לציין את הערך maxHeightPx, את הערך maxWidthPx או את שניהם. |
הגדלת גודל התמונות
ב-Place Photos (הממשק הקודם) אפשר היה להעלות תמונות בגודל מקסימלי של 1,600 על 1,600 פיקסלים. ב-Place Photos (הגרסה החדשה) אפשר להשתמש בתמונות בגודל של עד 4,800 על 4,800 פיקסלים.
שינוי לתמונות לדוגמה
ב-API של Place Photos (New) צריך להעביר את שם המשאב של התמונה המבוקשת, שכולל מזהה מקום והפניה לתמונה, בפורמט הבא:
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[]– פרטי ייחוס (קרדיט) נדרשים. השדה הזה תמיד קיים, אבל יכול להיות שהוא יהיה ריק.