תמונות של המקום (קודם)

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

‫Place Photos (מאגר מידע ישן), חלק מ-Places API, הוא API לקריאה בלבד שמאפשר לכם להוסיף תוכן צילומי באיכות גבוהה לאפליקציה שלכם. התכונה 'תמונות של מקומות' (גרסה קודמת) מאפשרת לכם לגשת למיליוני תמונות שמאוחסנות במסד הנתונים של המקומות. כשמקבלים מידע על מקום באמצעות בקשה לפרטי מקום, מוחזרים הפניות לתמונות של תוכן צילומי רלוונטי. בקשות של חיפוש מקום (מדור קודם), חיפוש בסביבה (מדור קודם) וחיפוש טקסט (מדור קודם) מחזירות גם הפניה לתמונה אחת לכל מקום, כשזה רלוונטי. אחרי שמשתמשים ב-Place Photos (Legacy), אפשר לגשת לתמונות שאליהן יש הפניה ולשנות את הגודל של התמונה לגודל האופטימלי לאפליקציה.

בקשות ל-Place Photos (גרסה קודמת)

בקשה ל-Place Photos (מדור ישן) היא כתובת URL ב-HTTP מהצורה הבאה:

https://maps.googleapis.com/maps/api/place/photo?parameters

כדי ליזום בקשת חיפוש, צריך לציין פרמטרים מסוימים. כמו בכתובות URL רגילות, כל הפרמטרים מופרדים באמצעות תו האמפרסנד (&). רשימת הפרמטרים והערכים האפשריים שלהם מפורטת בהמשך.

פרמטרים נדרשים

  • photo_reference

    מזהה מחרוזת שמזהה תמונה באופן ייחודי. הפניות לתמונות מוחזרות מבקשה לחיפוש מקומות או מבקשה ל-Place Details.

  • maxheight או maxwidth

    ‫maxheight מציין את הגובה המועדף המקסימלי של התמונה, בפיקסלים. אם התמונה קטנה מהערכים שצוינו, התמונה המקורית תוחזר. אם התמונה גדולה יותר באחד מהממדים, היא תוקטן בהתאם לממד הקטן יותר, תוך שמירה על יחס הגובה-רוחב המקורי.

    ‫maxwidth מציין את הרוחב המועדף המקסימלי של התמונה, בפיקסלים. אם התמונה קטנה מהערכים שצוינו, תוחזר התמונה המקורית. אם אחד מהמימדים של התמונה גדול יותר, היא תותאם למימד הקטן מבין השניים, תוך שמירה על יחס הגובה-רוחב המקורי שלה.

    במאפיינים maxheight ו-maxwidth אפשר להזין מספר שלם בין 1 ל-1600.

    צריך לציין את maxheight או את maxwidth, או את שניהם.

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

כל הבקשות ל-Place Photos (גרסה קודמת) חייבות לכלול את photo_reference, שמוחזר בתגובה לבקשה של חיפוש מקום (גרסה קודמת), חיפוש בסביבה (גרסה קודמת), חיפוש טקסט (גרסה קודמת) או Place Details (גרסה קודמת). התשובה לבקשות האלה תכלול את השדה photos[] אם למקום יש תוכן צילומי קשור.

הערה: מספר התמונות שמוחזרות משתנה בהתאם לבקשה.

  • בקשה של "חיפוש מקום (דור קודם)", "חיפוש בסביבה (דור קודם)" או "חיפוש טקסט (דור קודם)" מחזירה לכל היותר רכיב photo אחד במערך.
  • בקשה של פרטי מקום (גרסה קודמת) מחזירה עד עשרה רכיבי photo.

כל רכיב photo מכיל את השדות הבאים:

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

התמונות שמוחזרות על ידי Place Photos (Legacy) מגיעות ממגוון מיקומים, כולל תמונות שנוספו על ידי בעלי עסקים ומשתמשים. ברוב המקרים, אפשר להשתמש בתמונות האלה ללא ציון מקור, או שהמקור יצוין כחלק מהתמונה. עם זאת, אם רכיב photo שמוחזר כולל ערך בשדה html_attributions, אתם צריכים לכלול את הייחוס הנוסף באפליקציה בכל מקום שבו התמונה מוצגת.

בדוגמה הבאה מוצגת בקשה לפרטי מקום (מדור קודם):

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

דוגמה למערך photos[] בתגובה מוצגת בהמשך.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

דוגמה ל-Place Photos (גרסה קודמת)

דוגמה לבקשה מוצגת בהמשך. הבקשה הזו מחזירה את התמונה שאליה יש הפניה, אחרי שינוי הגודל שלה כך שהרוחב שלה יהיה 400 פיקסלים לכל היותר.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

תגובה של Place Photos (גרסה קודמת)

התגובה לבקשה מוצלחת של Place Photos (מדור קודם) היא תמונה. סוג התמונה תלוי בסוג התמונה המקורית שנשלחה.

אם הבקשה חורגת מהמכסה הזמינה, השרת מחזיר סטטוס HTTP 403 ומציג את התמונה הבאה כדי לציין שהייתה חריגה מהמכסה:

תמונה שמציינת שיש חריגה מהמכסה

אם השרת לא מצליח להבין את הבקשה, הוא מחזיר סטטוס HTTP 400, שמציין בקשה לא תקינה. הסיבות הנפוצות ביותר לבקשה לא חוקית הן: