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

מפתחים באזור הכלכלי האירופי (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 (Legacy) היה אפשר להעלות תמונות בגודל מקסימלי של ‎1,600 x 1,600 פיקסלים. Place Photos (חדשה) תומכת בגדלים של עד ‎4,800 x 4,800 פיקסלים.

מעבר לתמונות לדוגמה

‫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

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