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

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

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

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

בקשה של Place Photos (גרסה קודמת) היא כתובת URL של HTTP בפורמט הבא:

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

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

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

תמונות להשוואה

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

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

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

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

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

התמונות שמוחזרות על ידי Place Photos (מאגר תמונות של מקומות) (גרסה קודמת) מגיעות ממגוון מקומות, כולל תמונות שנוספו על ידי בעלי עסקים ותמונות שנוספו על ידי משתמשים. ברוב המקרים, אפשר להשתמש בתמונות האלה ללא ציון מקור, או שהמקור יצוין כחלק מהתמונה. עם זאת, אם רכיב 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"
       }]
    ...

דוגמה לשימוש בתמונות של המקום (גרסה קודמת)

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

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

תגובה בנושא תמונות של מקום (גרסה קודמת)

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

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

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

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

  • ההפניה לתמונה ששלחת לא צוינה בצורה נכונה.
  • הבקשה לא כללה את הפרמטרים maxwidth או maxheight.
  • הערך של הפרמטר maxwidth או של הפרמטר maxheight הוגדר כ-null.
  • פג התוקף של photo_reference. אם תוקף photo_reference פג, צריך לשלוח בקשה אל Place Details (Legacy),‏ Find Place (Legacy),‏ Nearby Search (Legacy) או Text Search (Legacy) כדי לקבל את הערך המעודכן של photo_reference.