مهاجرت به عکس‌های مکان (جدید)

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

مقدمه

API مکان‌ها از عکس‌های مکان (Legacy) پشتیبانی می‌کند. اگر با عکس‌های مکان (Legacy) آشنا هستید، عکس‌های مکان (جدید) تغییرات زیر را ایجاد می‌کند:

  • عکس‌های مکان (جدید) مستلزم آن است که نام منبع عکس، که شامل شناسه مکان در URL درخواست است، را به جای فقط مرجع عکس، ارسال کنید. برای اطلاعات بیشتر، به تغییر به مراجع عکس مراجعه کنید.
  • Place Photos (جدید) از هر دو کلید API و توکن‌های OAuth به عنوان مکانیزم احراز هویت پشتیبانی می‌کند.

جدول زیر پارامترهایی را در Place Photos (Legacy) فهرست می‌کند که برای Place Photos (New) تغییر نام داده یا اصلاح شده‌اند، یا پارامترهایی که دیگر پشتیبانی نمی‌شوند.

پارامتر فعلی پارامتر جدید یادداشت‌ها
maxheight maxHeightPx شما باید maxHeightPx یا maxWidthPx یا هر دو را مشخص کنید.
maxwidth maxWidthPx شما باید maxHeightPx یا maxWidthPx یا هر دو را مشخص کنید.

حجم عکس زیاد شده

Place Photos (Legacy) حداکثر اندازه عکس ۱۶۰۰ در ۱۶۰۰ پیکسل را پشتیبانی می‌کرد. Place Photos (جدید) از اندازه‌هایی تا ۴۸۰۰ در ۴۸۰۰ پیکسل پشتیبانی می‌کند.

تغییر به مراجع عکس

API مربوط به Place Photos (جدید) از شما می‌خواهد که نام منبع عکس درخواستی، که شامل شناسه مکان و مرجع عکس است را به شکل زیر ارسال کنید:

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[] — هرگونه ویژگی مورد نیاز. این فیلد همیشه وجود دارد، اما ممکن است خالی باشد.

با API قدیمی، فقط باید مرجع عکس را به شکل زیر ارسال کنید:

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

توابع Find Place (Legacy)، Nearby Search (Legacy)، Text Search (Legacy) و Place Details (Legacy) همگی یک آرایه photos[] در پاسخی که از این فرمت پشتیبانی می‌کند، برمی‌گردانند. هر عنصر photo در پاسخ legacy شامل فیلدهای زیر است:

  • photo_reference — رشته‌ای که برای شناسایی عکس هنگام انجام درخواست عکس استفاده می‌شود.
  • height — حداکثر ارتفاع تصویر.
  • width — حداکثر عرض تصویر.
  • html_attributions[] — هرگونه ویژگی مورد نیاز. این فیلد همیشه وجود دارد، اما ممکن است خالی باشد.