Place Photos (قدیمی)

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

Place Photos (Legacy)، بخشی از Places API، یک API فقط خواندنی است که به شما امکان می‌دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. Place Photos (Legacy) به شما امکان می‌دهد به میلیون‌ها عکس ذخیره‌شده در پایگاه داده Places دسترسی داشته باشید. وقتی اطلاعات مکان را بااستفاده از درخواست «جزئیات مکان» دریافت می‌کنید، ارجاع‌های عکس برای محتوای عکاسی مربوطه برگردانده می‌شود. درخواست‌های Find Place (Legacy)،‏ Nearby Search (Legacy)، و Text Search (Legacy) نیز درصورت مرتبط بودن، یک مرجع عکس برای هر مکان برمی‌گردانند. بااستفاده از 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 باشد، که در پاسخ به درخواست Find Place (قدیمی)، Nearby Search (قدیمی)، Text Search (قدیمی)، یا Place Details (قدیمی) برگردانده شده است. اگر مکان محتوای عکاسی مرتبط داشته باشد، پاسخ به این درخواست‌ها حاوی فیلد 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 (Legacy)

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

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

پاسخ Place Photos (Legacy)

پاسخ درخواست موفق Place Photos (Legacy)‎ یک تصویر است. نوع تصویر به نوع عکس ارسال‌شده اصلی بستگی دارد.

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

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

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