مقدمه
Places API از Place Photos (Legacy) پشتیبانی می‌کند. اگر با Place Photos (قدیمی) آشنا هستید، Place Photos (جدید) تغییرات زیر را ایجاد می‌کند:
- Place Photos (New) از شما می‌خواهد که نام منبع عکس را که شامل شناسه مکان در نشانی وب درخواست است، به‌جای فقط مرجع عکس، ارسال کنید. برای اطلاعات بیشتر، تغییر در ارجاع‌های عکس را ببینید.
- «عکس‌های مکان (جدید)» از هر دو کلیدهای API و کدهای OAuth به‌عنوان سازوکار اصالت‌سنجی پشتیبانی می‌کند.
جدول زیر پارامترهای موجود در «عکس‌های مکان» (قدیمی) را که برای «عکس‌های مکان» (جدید) تغییر نام داده یا اصلاح شده‌اند، یا پارامترهایی را که دیگر پشتیبانی نمی‌شوند فهرست می‌کند.
| پارامتر فعلی | پارامتر جدید | یادداشت‌ها |
|---|---|---|
maxheight |
maxHeightPx |
باید maxHeightPx،
maxWidthPx، یا هر دو را مشخص کنید. |
maxwidth |
maxWidthPx |
باید maxHeightPx،
maxWidthPx، یا هر دو را مشخص کنید. |
اندازه عکس افزایش یافت
«عکس‌های مکان» (قدیمی) از حداکثر اندازه عکس ۱۶۰۰ در ۱۶۰۰ پیکسل پشتیبانی می‌کرد. Place Photos (New) از اندازه‌های حداکثر ۴۸۰۰ در ۴۸۰۰ پیکسل پشتیبانی می‌کند.
تغییر به مرجع‌های عکس
Place Photos (New) API requires that you pass the resource name of the requested photo, which includes a place ID and the photo reference, in the form:
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
«جستجوی اطراف» (جدید)،
«جستجوی نوشتار» (جدید)، و
«جزئیات جا» (جدید)
همگی آرایه photos[] را در پاسخ برمی‌گردانند که از این قالب پشتیبانی می‌کند. هر عنصر photos[] در پاسخ جدید شامل فیلدهای زیر است:
name— رشته‌ای که حاوی نام منبع عکس است. این رشته در فرم است:places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx— حداکثر ارتفاع تصویر، به پیکسل.widthPx— حداکثر عرض تصویر، به پیکسل.authorAttributions[]— هرگونه ارجاع لازم. این فیلد همیشه وجود دارد، اما ممکن است خالی باشد.
با میانای برنامه‌سازی کاربردی قدیمی، فقط باید مرجع عکس را در این قالب ارسال کنید:
https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY
«یافتن مکان» (قدیمی)،
«جستجوی اطراف» (قدیمی)،
«جستجوی نوشتار» (قدیمی)، و
«جزئیات مکان» (قدیمی) همگی آرایه photos[] را در
پاسخی که از این قالب پشتیبانی می‌کند برمی‌گردانند. هر عنصر photo در پاسخ قدیمی حاوی فیلدهای زیر است:
photo_reference— رشته‌ای که برای شناسایی عکس هنگام انجام درخواست عکس استفاده می‌شود.height— حداکثر ارتفاع تصویر.width— حداکثر عرض تصویر.html_attributions[]— هرگونه ارجاع لازم. این فیلد همیشه وجود دارد، اما ممکن است خالی باشد.