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

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

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

בקשות Place Photos (קודמות)

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

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

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

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

  • photo_reference

    מזהה מחרוזת שמזהה תמונה באופן ייחודי. הפניות לתמונות מוחזרות מבקשה לחיפוש מקום או מבקשה לפרטי מקום.

  • maxheight או maxwidth

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

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

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

    חובה לציין את maxheight או את maxwidth או את שניהם.

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

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

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

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

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

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

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

בדוגמה הבאה מוצגת בקשה של Place Details (גרסה מדור קודם):

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 (Legacy) היא תמונה. סוג התמונה תלוי בסוג התמונה המקורית שנשלחה.

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

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

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