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

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

מבוא

‫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 x 1,600 פיקסלים. Place Photos (חדש) תומך בגדלים של עד 4800 על 4800 פיקסלים.

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

‫Place Photos (New) API: כדי להשתמש ב-API הזה, צריך להעביר את resource name של התמונה המבוקשת, שכולל place ID ו-photo reference, בפורמט הבא:

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[] — כל פרטי הייחוס (קרדיט) הנדרשים. השדה הזה תמיד קיים, אבל יכול להיות שהוא יהיה ריק.