העברה אל 'תמונות של המקום' (חדש)

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

‫Places API תומך ב-Place Photos (מדור קודם). אם אתם מכירים את Place Photos (מדור קודם), Place Photos (חדש) כולל את השינויים הבאים:

  • כדי להשתמש ב-Place Photos (חדש), צריך להעביר את שם המשאב של התמונה, שכולל את מזהה המקום בכתובת ה-URL של הבקשה, במקום רק את ההפניה לתמונה. מידע נוסף זמין במאמר שינוי במזהי התמונות.
  • התכונה "תמונות של מקומות (חדש)" תומכת גם במפתחות API וגם בטוקנים של OAuth כמנגנון האימות.

בטבלה הבאה מפורטים הפרמטרים ב-Place Photos (הגרסה הקודמת) ששינינו את השם שלהם או שינינו אותם ב-Place Photos (הגרסה החדשה), או פרמטרים שכבר לא נתמכים.

הפרמטר הנוכחי פרמטר חדש הערות
maxheight maxHeightPx צריך לציין את maxHeightPx, את maxWidthPx או את שניהם.
maxwidth maxWidthPx צריך לציין את maxHeightPx, את maxWidthPx או את שניהם.

תמונה גדולה יותר

בגרסה הקודמת של Place Photos, הגודל המקסימלי של התמונות היה ‎1,600 x 1,600 פיקסלים. התכונה "תמונות של מקומות (חדש)" תומכת בגדלים של עד 4,800 על 4,800 פיקסלים.

שינוי לתמונות רפרנס

ב-Place Photos 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

השיטות חיפוש מקום (מדור קודם), חיפוש בסביבה (מדור קודם), חיפוש טקסט (מדור קודם) ו-Place Details (מדור קודם) מחזירות מערך photos[] בתגובה שתומכת בפורמט הזה. כל רכיב photo בתגובה הקודמת מכיל את השדות הבאים:

  • ‫photo_reference – מחרוזת שמשמשת לזיהוי התמונה כששולחים בקשה לתמונה.
  • ‫height – הגובה המקסימלי של התמונה.
  • ‫width — הרוחב המקסימלי של התמונה.
  • ‫html_attributions[] – כל פרטי הייחוס (קרדיט) הנדרשים. השדה הזה תמיד קיים, אבל יכול להיות שהוא יהיה ריק.