مقدمه
Places API از عکس‌های مکان (قدیمی) پشتیبانی می‌کند. اگر با «عکس‌های مکان» (قدیمی) آشنا هستید، عکس‌های مکان (جدید) تغییرات زیر را ایجاد می‌کند:
- «عکس‌های مکان» (جدید) از شما می‌خواهد که نام منبع عکس را که شامل شناسه مکان در نشانی وب درخواست است، به‌جای فقط مرجع عکس، ارسال کنید. برای اطلاعات بیشتر، تغییر در ارجاع‌های عکس را ببینید.
- «عکس‌های مکان» (جدید) از هر دو کلیدهای میانای برنامه‌سازی کاربردی و کدهای OAuth به‌عنوان سازوکار اصالت‌سنجی پشتیبانی می‌کند.
جدول زیر پارامترهای موجود در Place Photos (Legacy) را که برای Place Photos (New) تغییر نام داده یا اصلاح شده‌اند، یا پارامترهایی را که دیگر پشتیبانی نمی‌شوند فهرست می‌کند.
| پارامتر کنونی | پارامتر جدید | یادداشت‌ها |
|---|---|---|
maxheight |
maxHeightPx |
باید maxHeightPx،
maxWidthPx، یا هر دو را مشخص کنید. |
maxwidth |
maxWidthPx |
باید maxHeightPx،
maxWidthPx، یا هر دو را مشخص کنید. |
اندازه عکس افزایش یافت
«عکس‌های مکان» (قدیمی) از حداکثر اندازه عکس ۱۶۰۰ در ۱۶۰۰ پیکسل پشتیبانی می‌کرد. «عکس‌های مکان» (جدید) از اندازه‌های حداکثر ۴۸۰۰ در ۴۸۰۰ پیکسل پشتیبانی می‌کند.
تغییر به مرجع‌های عکس
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[]— هرگونه ارجاع لازم. این فیلد همیشه وجود دارد، اما ممکن است خالی باشد.