عکس های مکان

پلتفرم را انتخاب کنید: سرویس وب جاوا اسکریپت اندروید iOS

سرویس عکس مکان، بخشی از Places API، یک API فقط خواندنی است که به شما امکان می دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. سرویس عکس مکان به شما امکان دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Places را می دهد. وقتی اطلاعات مکان را با استفاده از درخواست جزئیات مکان دریافت می‌کنید، مراجع عکس برای محتوای عکاسی مرتبط بازگردانده می‌شوند. درخواست‌های Find Place، Nearby Search و Text Search نیز در صورت مرتبط بودن، یک مرجع عکس را در هر مکان برمی‌گردانند. با استفاده از سرویس Photo می توانید به عکس های ارجاع شده دسترسی داشته باشید و اندازه تصویر را به اندازه مطلوب برای برنامه خود تغییر دهید.

درخواست عکس را قرار دهید

درخواست عکس مکان یک URL HTTP به شکل زیر است:

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.

مراجع عکس

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

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

  • درخواست Find Place، Nearby Search یا Text Search حداکثر یک عنصر photo را در آرایه برمی گرداند.
  • درخواست جزئیات مکان حداکثر ده عنصر photo را برمی گرداند.

هر عنصر photo حاوی فیلدهای زیر است:

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

عکس‌های برگردانده شده توسط سرویس عکس از مکان‌های مختلف، از جمله صاحبان کسب‌وکار و عکس‌های ارائه‌شده توسط کاربر، تهیه شده‌اند. در بیشتر موارد، این عکس‌ها را می‌توان بدون ذکر منبع استفاده کرد، یا به عنوان بخشی از تصویر، ارجاع مورد نیاز را در نظر گرفت. با این حال، اگر عنصر 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"
   }
...

نمونه عکس مکان

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

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

محل پاسخ عکس

پاسخ درخواست موفقیت آمیز عکس مکان یک تصویر خواهد بود. نوع تصویر به نوع عکس ارسالی اولیه بستگی دارد.

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

تصویر بیش از سهمیه

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

  • مرجع عکس ارسالی به درستی مشخص نشده است.
  • این درخواست شامل پارامترهای maxwidth یا maxheight نبود.
  • مقدار پارامتر maxwidth یا maxheight روی null تنظیم شد.
  • photo_reference منقضی شده است. اگر photo_reference منقضی می‌شود، برای دریافت مقدار photo_reference به‌روز شده، درخواستی را برای جزئیات مکان ، یافتن مکان ، جستجوی نزدیک یا جستجوی متن ارسال کنید.