Place Photos (قدیمی)

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

Place Photos (Legacy)، بخشی از Places API، یک API فقط خواندنی است که به شما امکان می‌دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. «عکس‌های مکان» (قدیمی) به شما امکان می‌دهد به میلیون‌ها عکس ذخیره‌شده در پایگاه داده «مکان‌ها» دسترسی داشته باشید. وقتی بااستفاده از درخواست «جزئیات مکان» اطلاعات مکان دریافت می‌کنید، مرجع‌های عکس برای محتوای عکاسی مرتبط برگردانده می‌شود. درخواست‌های «یافتن مکان» (قدیمی)، «جستجوی اطراف» (قدیمی)، و «جستجوی نوشتاری» (قدیمی) نیز درصورت مرتبط بودن، یک مرجع عکس برای هر مکان برمی‌گردانند. بااستفاده از Place Photos (Legacy) می‌توانید به عکس‌های ارجاع‌شده دسترسی پیدا کنید و اندازه تصویر را به اندازه بهینه برای برنامه‌تان تغییر دهید.

درخواست‌های Place Photos (قدیمی)

درخواست «عکس‌های مکان» (قدیمی) نشانی وب HTTP به‌شکل زیر است:

https://maps.googleapis.com/maps/api/place/photo?parameters

برای شروع درخواست جستجو، پارامترهای خاصی لازم است. همان‌طور که در نشانی‌های وب استاندارد است، همه پارامترها بااستفاده از نویسه اَمپرسند (&) از هم جدا می‌شوند. فهرست پارامترها و مقادیر ممکن آن‌ها در زیر فهرست شده است.

پارامترهای الزامی

  • photo_reference

    شناسه رشته‌ای که عکس را به‌طور یکتا شناسایی می‌کند. مرجع‌های عکس از درخواست «جستجوی مکان» یا «جزئیات مکان» برگردانده می‌شوند.

  • maxheight یا maxwidth

    maxheight حداکثر ارتفاع ترجیحی تصویر را به پیکسل مشخص می‌کند. اگر تصویر از مقادیر مشخص‌شده کوچک‌تر باشد، تصویر اصلی برگردانده خواهد شد. اگر تصویر در هر یک از ابعاد بزرگ‌تر باشد، برای مطابقت با کوچک‌ترین ابعاد، با محدودیت نسبت ابعادی اصلی خود، مقیاس‌بندی می‌شود.

    maxwidth حداکثر عرض ترجیحی تصویر را به پیکسل مشخص می‌کند. اگر تصویر کوچک‌تر از مقادیر مشخص‌شده باشد، تصویر اصلی برگردانده خواهد شد. اگر تصویر در هریک از ابعاد بزرگ‌تر باشد، مقیاس آن تغییر می‌کند تا با بعد کوچک‌تر مطابقت داشته باشد و به نسبت ابعادی اصلی‌اش محدود می‌شود.

    هر دو دارایی maxheight و maxwidth عدد صحیحی بین 1 و 1600 را می‌پذیرند.

    باید maxheight یا maxwidth یا هر دو را مشخص کنید.

مرجع‌های عکس

همه درخواست‌ها به Place Photos (قدیمی) باید شامل photo_reference باشد، که در پاسخ به درخواست «یافتن مکان» (قدیمی)، «جستجوی اطراف» (قدیمی)، «جستجوی نوشتاری» (قدیمی)، یا «جزئیات مکان» (قدیمی) برگردانده می‌شود. پاسخ به این درخواست‌ها درصورتی‌که مکان محتوای عکاسی مرتبط داشته باشد، حاوی فیلد photos[] خواهد بود.

توجه: تعداد عکس‌های برگردانده‌شده بسته به درخواست متفاوت است.

  • درخواست «یافتن مکان» (قدیمی)، «جستجوی اطراف» (قدیمی)، یا «جستجوی نوشتاری» (قدیمی) حداکثر یک عنصر photo در آرایه برمی‌گرداند.
  • درخواست «جزئیات مکان (قدیمی)» حداکثر ده عنصر photo را برمی‌گرداند.

هر عنصر photo شامل فیلدهای زیر است:

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

عکس‌هایی که Place Photos (Legacy)‎ برمی‌گرداند از مکان‌های مختلفی گرفته شده‌اند، ازجمله عکس‌های ارسالی مالکان کسب‌وکار و کاربران. در بیشتر موارد، این عکس‌ها را می‌توان بدون ذکر منبع استفاده کرد، یا منبع موردنیاز به‌عنوان بخشی از تصویر ذکر می‌شود. بااین‌حال، اگر عنصر photo برگردانده‌شده شامل مقداری در فیلد html_attributions باشد، باید ارجاع اضافی را در هر جایی از برنامه‌تان که تصویر را نمایش می‌دهید اضافه کنید.

ذکر شده است ببینید

مثال زیر درخواست «جزئیات مکان (قدیمی)» را نشان می‌دهد:

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

نمونه‌ای از آرایه photos[] در پاسخ در زیر نشان داده شده است.

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

نمونه Place Photos (قدیمی)

درخواست نمونه در زیر نشان داده شده است. این درخواست تصویر ارجاع‌شده را برمی‌گرداند و آن را تغییر اندازه می‌دهد تا حداکثر ۴۰۰ پیکسل عرض داشته باشد.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

پاسخ Place Photos (قدیمی)

پاسخ درخواست موفق «عکس‌های مکان» (قدیمی) یک تصویر است. نوع تصویر به نوع عکس اصلی ارسالی بستگی دارد.

اگر درخواست شما از سهمیه دردسترس شما فراتر رود، سرور وضعیت HTTP 403 را برمی‌گرداند و تصویر زیر را نمایش می‌دهد تا نشان دهد که از سهمیه فراتر رفته‌اید:

تصویر بیش‌از حد مجاز

اگر سرور نتواند درخواست شما را درک کند، وضعیت HTTP 400 را برمی‌گرداند که نشان‌دهنده درخواست نامعتبر است. رایج‌ترین دلایل درخواست نامعتبر عبارت‌اند از: