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
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, 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
.