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

پروژه: /maps/documentation/places/web-service/_project.yaml کتاب: /maps/documentation/places/web-service/_book.yaml

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

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

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

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

افزایش سایز عکس

Place Photos (Legacy) حداکثر اندازه عکس 1600 در 1600 پیکسل را پشتیبانی می کند. عکس‌های مکان (جدید) از اندازه‌های حداکثر 4800 در 4800 پیکسل پشتیبانی می‌کند.

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

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

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

یافتن مکان (میراث)، جستجوی نزدیک (میراث)، جستجوی متن (میراث)، و جزئیات مکان (میراث) همگی یک آرایه photos[] در پاسخی که از این قالب پشتیبانی می‌کند، برمی‌گردانند. هر عنصر photo در پاسخ قدیمی حاوی فیلدهای زیر است:

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