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

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

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

בקשות 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 (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, שמציין בקשה לא תקינה. הסיבות הנפוצות ביותר לבקשה לא חוקית הן:

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