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

Places API از عکس مکان موجود پشتیبانی می کند. اگر با Place Photo موجود آشنا هستید، نسخه جدید Place Photo تغییرات زیر را اعمال می کند:

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

جدول زیر پارامترهایی را در عکس مکان موجود که برای عکس مکان جدید تغییر نام داده یا اصلاح شده اند یا پارامترهایی که دیگر پشتیبانی نمی شوند فهرست می کند.

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

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

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

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

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

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