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

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

‫Place Photos (דור קודם), חלק מ-Places API, הוא ממשק API לקריאה בלבד שמאפשר להוסיף תוכן צילום באיכות גבוהה לאפליקציה. התכונה "תמונות של מקומות (דור קודם)" מאפשרת לכם לגשת למיליוני התמונות ששמורות במסד הנתונים של Places. כשאתם מקבלים מידע על מקום באמצעות בקשה לפרטי מקום, יוחזרו הפניות לתמונות עבור תוכן צילום רלוונטי. גם בקשות מסוג "חיפוש מקום (מדור קודם)", "חיפוש בסביבה (מדור קודם)" ו"חיפוש טקסט (מדור קודם)" מחזירות הפניה לתמונה אחת לכל מקום, אם זה רלוונטי. באמצעות 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 (מדור קודם) חייבות לכלול photo_reference, שמוחזר בתגובה לבקשה של חיפוש מקום (מדור קודם), חיפוש בסביבה (מדור קודם), חיפוש טקסט (מדור קודם) או Place Details (מדור קודם). התשובה לבקשות האלה תכלול את השדה photos[] אם למקום יש תוכן צילומי קשור.

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

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