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

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

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

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

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

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

התמונות שמתקבלות מהתכונה 'תמונות של מקומות' (מדור קודם) מגיעות ממגוון מקורות, כולל תמונות שנוספו על ידי בעלי עסקים ומשתמשים. ברוב המקרים, אפשר להשתמש בתמונות האלה ללא שיוך, או שהשיוך הנדרש ייכלל כחלק מהתמונה. עם זאת, אם האלמנט 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 (קודם)

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

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

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

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