عکس‌های مکان (میراث)، عکس‌های مکان (قدمت)، عکس‌های مکان (میراث)، عکس‌های مکان (قدمت)

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

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

درخواست‌های عکس‌های مکان (قدیمی)

درخواست Place Photos (Legacy) یک HTTP URL به شکل زیر است:

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

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

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600 .

    You must specify either maxheight , or maxwidth , or both.

منابع عکس

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

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

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

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

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

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

مثال زیر یک درخواست Place Details (Legacy) را نشان می‌دهد:

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"
       }]
    ...

مثال عکس‌های مکان (قدیمی)

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

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

پاسخ به عکس‌های مکان (میراث)

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

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

تصویر سهمیه مازاد

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