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

Places API תומך בממשק הקיים תמונה של מקום. אם אתם מכירים את תמונת המקום הקיימת, גרסה חדשה של תמונת מקום מבצע את השינויים הבאים:

  • השירות החדש 'תמונת מקום' מחייב להעביר את שם המשאב של התמונה, שכולל את מזהה המקום כתובת האתר של הבקשה, ולא רק את ההפניה לתמונה. מידע נוסף זמין במאמר הבא: שינוי להפניות של תמונות.
  • השירות החדש 'תמונת מקום' תומך מפתחות API ו-OAuth אסימונים בתור מנגנון האימות.

בטבלה הבאה מפורטים פרמטרים תמונת מקום שהשם שלה השתנה או השתנה תמונת מקום חדשה, או פרמטרים שכבר לא קיימים נתמך.

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

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

תמונת המקום הקיימת תומכת בתמונה לכל היותר בגודל 1,600 על 1,600 פיקסלים. תמונה של מקום (חדש) תומכת בגדלים של עד 4800 על 4800 פיקסלים.

שינוי להפניות של תמונות

הגרסה החדשה תמונה של מקום ל-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

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

  • photo_reference – מחרוזת שמשמשת לזיהוי התמונה בזמן מבצעים בקשת תמונה.
  • height – הגובה המקסימלי של התמונה.
  • width – הרוחב המקסימלי של התמונה.
  • html_attributions[] – כל הייחוסים הנדרשים. הזה תמיד קיים, אבל יכול להיות שהוא ריק.