Place Photos (Legacy)، بخشی از Places API، یک API فقط خواندنی است که به شما امکان می دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. Place Photos (Legacy) به شما امکان دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Places را می دهد. وقتی اطلاعات مکان را با استفاده از درخواست جزئیات مکان دریافت می‌کنید، مراجع عکس برای محتوای عکاسی مربوطه بازگردانده می‌شوند. درخواست‌های Find Place (Legacy)، Nearby Search (Legacy) و Text Search (Legacy) نیز در صورت مرتبط بودن، یک مرجع عکس را در هر مکان برمی‌گردانند. با استفاده از Place Photos (Legacy) می توانید به عکس های ارجاع شده دسترسی داشته باشید و اندازه تصویر را به اندازه مطلوب برای برنامه خود تغییر دهید.
درخواست‌های عکس‌های مکان (میراث).
درخواست Place Photos (Legacy) یک 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
maxheightspecifies 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.maxwidthspecifies 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
maxheightandmaxwidthproperties accept an integer between1and1600.You must specify either
maxheight, ormaxwidth, or both.
مراجع عکس
همه درخواست‌های مربوط به عکس‌های مکان (میراث) باید شامل یک photo_reference باشد که در پاسخ به درخواست «یافتن مکان» (میراث)، «جستجوی نزدیک» (میراث)، «جستجوی متنی» (میراث)، یا «جزئیات مکان» (میراث) ارائه می‌شود. اگر مکان دارای محتوای عکاسی مرتبط باشد، پاسخ به این درخواست‌ها شامل یک قسمت photos[] خواهد بود.
توجه: تعداد عکس های برگشتی بر اساس درخواست متفاوت است.
- درخواست Find Place (Legacy)، Nearby Search (Legacy)، یا Text Search (Legacy) حداکثر یک عنصر
photoرا در آرایه برمی گرداند. - درخواست جزئیات مکان (میراث) تا ده عنصر
photoرا برمی گرداند.
هر عنصر photo حاوی فیلدهای زیر است:
-
photo_reference- رشته‌ای که برای شناسایی عکس هنگام انجام درخواست Place Photos (Legacy) استفاده می‌شود. -
height- حداکثر ارتفاع تصویر. -
width- حداکثر عرض تصویر. -
html_attributions[]- شامل هر گونه اسناد مورد نیاز است. این فیلد همیشه وجود خواهد داشت، اما ممکن است خالی باشد.
عکس‌های برگردانده شده توسط Place Photos (میراث) از مکان‌های مختلف، از جمله صاحبان کسب‌وکار و عکس‌های ارائه‌شده توسط کاربر، تهیه شده‌اند. در بیشتر موارد، این عکس‌ها را می‌توان بدون ذکر منبع استفاده کرد یا به عنوان بخشی از تصویر، ارجاع مورد نیاز را در نظر گرفت. با این حال، اگر عنصر 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
پاسخ عکس‌های مکان (میراث).
پاسخ یک درخواست موفق Place Photos (Legacy) یک تصویر است. نوع تصویر به نوع عکس ارسالی اصلی بستگی دارد.
اگر درخواست شما از سهمیه موجود شما بیشتر شود، سرور وضعیت HTTP 403 را برمی‌گرداند و تصویر زیر را نمایش می‌دهد تا نشان دهد از سهمیه فراتر رفته است:
اگر سرور قادر به درک درخواست شما نباشد، وضعیت HTTP 400 را برمی‌گرداند که نشان‌دهنده درخواست نامعتبر است. رایج ترین دلایل درخواست نامعتبر عبارتند از:
- مرجع عکس ارسالی به درستی مشخص نشده است.
- این درخواست شامل پارامترهای
maxwidthیاmaxheightنبود. - مقدار پارامتر
maxwidthیاmaxheightرویnullتنظیم شد. -
photo_referenceمنقضی شده است. اگرphoto_referenceمنقضی می‌شود، برای دریافت مقدارphoto_referenceبه‌روزرسانی شده، درخواستی برای جزئیات مکان (میراث) ، یافتن مکان (میراث) ، جستجوی نزدیک (میراث) یا جستجوی متن (میراث) ارائه دهید.
Place Photos (Legacy)، بخشی از Places API، یک API فقط خواندنی است که به شما امکان می دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. Place Photos (Legacy) به شما امکان دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Places را می دهد. وقتی اطلاعات مکان را با استفاده از درخواست جزئیات مکان دریافت می‌کنید، مراجع عکس برای محتوای عکاسی مربوطه بازگردانده می‌شوند. درخواست‌های Find Place (Legacy)، Nearby Search (Legacy) و Text Search (Legacy) نیز در صورت مرتبط بودن، یک مرجع عکس را در هر مکان برمی‌گردانند. با استفاده از Place Photos (Legacy) می توانید به عکس های ارجاع شده دسترسی داشته باشید و اندازه تصویر را به اندازه مطلوب برای برنامه خود تغییر دهید.
درخواست‌های عکس‌های مکان (میراث).
درخواست Place Photos (Legacy) یک 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
maxheightspecifies 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.maxwidthspecifies 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
maxheightandmaxwidthproperties accept an integer between1and1600.You must specify either
maxheight, ormaxwidth, or both.
مراجع عکس
همه درخواست‌های مربوط به عکس‌های مکان (میراث) باید شامل یک photo_reference باشد که در پاسخ به درخواست «یافتن مکان» (میراث)، «جستجوی نزدیک» (میراث)، «جستجوی متنی» (میراث)، یا «جزئیات مکان» (میراث) ارائه می‌شود. اگر مکان دارای محتوای عکاسی مرتبط باشد، پاسخ به این درخواست‌ها شامل یک قسمت photos[] خواهد بود.
توجه: تعداد عکس های برگشتی بر اساس درخواست متفاوت است.
- درخواست Find Place (Legacy)، Nearby Search (Legacy)، یا Text Search (Legacy) حداکثر یک عنصر
photoرا در آرایه برمی گرداند. - درخواست جزئیات مکان (میراث) تا ده عنصر
photoرا برمی گرداند.
هر عنصر photo حاوی فیلدهای زیر است:
-
photo_reference- رشته‌ای که برای شناسایی عکس هنگام انجام درخواست Place Photos (Legacy) استفاده می‌شود. -
height- حداکثر ارتفاع تصویر. -
width- حداکثر عرض تصویر. -
html_attributions[]- شامل هر گونه اسناد مورد نیاز است. این فیلد همیشه وجود خواهد داشت، اما ممکن است خالی باشد.
عکس‌های برگردانده شده توسط Place Photos (میراث) از مکان‌های مختلف، از جمله صاحبان کسب‌وکار و عکس‌های ارائه‌شده توسط کاربر، تهیه شده‌اند. در بیشتر موارد، این عکس‌ها را می‌توان بدون ذکر منبع استفاده کرد یا به عنوان بخشی از تصویر، ارجاع مورد نیاز را در نظر گرفت. با این حال، اگر عنصر 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
پاسخ عکس‌های مکان (میراث).
پاسخ یک درخواست موفق Place Photos (Legacy) یک تصویر است. نوع تصویر به نوع عکس ارسالی اصلی بستگی دارد.
اگر درخواست شما از سهمیه موجود شما بیشتر شود، سرور وضعیت HTTP 403 را برمی‌گرداند و تصویر زیر را نمایش می‌دهد تا نشان دهد از سهمیه فراتر رفته است:
اگر سرور قادر به درک درخواست شما نباشد، وضعیت HTTP 400 را برمی‌گرداند که نشان‌دهنده درخواست نامعتبر است. رایج ترین دلایل درخواست نامعتبر عبارتند از:
- مرجع عکس ارسالی به درستی مشخص نشده است.
- این درخواست شامل پارامترهای
maxwidthیاmaxheightنبود. - مقدار پارامتر
maxwidthیاmaxheightرویnullتنظیم شد. -
photo_referenceمنقضی شده است. اگرphoto_referenceمنقضی می‌شود، برای دریافت مقدارphoto_referenceبه‌روزرسانی شده، درخواستی برای جزئیات مکان (میراث) ، یافتن مکان (میراث) ، جستجوی نزدیک (میراث) یا جستجوی متن (میراث) ارائه دهید.
Place Photos (Legacy)، بخشی از Places API، یک API فقط خواندنی است که به شما امکان می دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. Place Photos (Legacy) به شما امکان دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Places را می دهد. وقتی اطلاعات مکان را با استفاده از درخواست جزئیات مکان دریافت می‌کنید، مراجع عکس برای محتوای عکاسی مربوطه بازگردانده می‌شوند. درخواست‌های Find Place (Legacy)، Nearby Search (Legacy) و Text Search (Legacy) نیز در صورت مرتبط بودن، یک مرجع عکس را در هر مکان برمی‌گردانند. با استفاده از Place Photos (Legacy) می توانید به عکس های ارجاع شده دسترسی داشته باشید و اندازه تصویر را به اندازه مطلوب برای برنامه خود تغییر دهید.
درخواست‌های عکس‌های مکان (میراث).
درخواست Place Photos (Legacy) یک 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
maxheightspecifies 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.maxwidthspecifies 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
maxheightandmaxwidthproperties accept an integer between1and1600.You must specify either
maxheight, ormaxwidth, or both.
مراجع عکس
همه درخواست‌های مربوط به عکس‌های مکان (میراث) باید شامل یک photo_reference باشد که در پاسخ به درخواست «یافتن مکان» (میراث)، «جستجوی نزدیک» (میراث)، «جستجوی متنی» (میراث)، یا «جزئیات مکان» (میراث) ارائه می‌شود. اگر مکان دارای محتوای عکاسی مرتبط باشد، پاسخ به این درخواست‌ها شامل یک قسمت photos[] خواهد بود.
توجه: تعداد عکس های برگشتی بر اساس درخواست متفاوت است.
- درخواست Find Place (Legacy)، Nearby Search (Legacy)، یا Text Search (Legacy) حداکثر یک عنصر
photoرا در آرایه برمی گرداند. - درخواست جزئیات مکان (میراث) تا ده عنصر
photoرا برمی گرداند.
هر عنصر photo حاوی فیلدهای زیر است:
-
photo_reference- رشته‌ای که برای شناسایی عکس هنگام انجام درخواست Place Photos (Legacy) استفاده می‌شود. -
height- حداکثر ارتفاع تصویر. -
width- حداکثر عرض تصویر. -
html_attributions[]- شامل هر گونه اسناد مورد نیاز است. این فیلد همیشه وجود خواهد داشت، اما ممکن است خالی باشد.
عکس‌های برگردانده شده توسط Place Photos (میراث) از مکان‌های مختلف، از جمله صاحبان کسب‌وکار و عکس‌های ارائه‌شده توسط کاربر، تهیه شده‌اند. در بیشتر موارد، این عکس‌ها را می‌توان بدون ذکر منبع استفاده کرد یا به عنوان بخشی از تصویر، ارجاع مورد نیاز را در نظر گرفت. با این حال، اگر عنصر 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
پاسخ عکس‌های مکان (میراث).
پاسخ یک درخواست موفق Place Photos (Legacy) یک تصویر است. نوع تصویر به نوع عکس ارسالی اصلی بستگی دارد.
اگر درخواست شما از سهمیه موجود شما بیشتر شود، سرور وضعیت HTTP 403 را برمی‌گرداند و تصویر زیر را نمایش می‌دهد تا نشان دهد از سهمیه فراتر رفته است:
اگر سرور قادر به درک درخواست شما نباشد، وضعیت HTTP 400 را برمی‌گرداند که نشان‌دهنده درخواست نامعتبر است. رایج ترین دلایل درخواست نامعتبر عبارتند از:
- مرجع عکس ارسالی به درستی مشخص نشده است.
- این درخواست شامل پارامترهای
maxwidthیاmaxheightنبود. - مقدار پارامتر
maxwidthیاmaxheightرویnullتنظیم شد. -
photo_referenceمنقضی شده است. اگرphoto_referenceمنقضی می‌شود، برای دریافت مقدارphoto_referenceبه‌روزرسانی شده، درخواستی برای جزئیات مکان (میراث) ، یافتن مکان (میراث) ، جستجوی نزدیک (میراث) یا جستجوی متن (میراث) ارائه دهید.
Place Photos (Legacy)، بخشی از Places API، یک API فقط خواندنی است که به شما امکان می دهد محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. Place Photos (Legacy) به شما امکان دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Places را می دهد. وقتی اطلاعات مکان را با استفاده از درخواست جزئیات مکان دریافت می‌کنید، مراجع عکس برای محتوای عکاسی مربوطه بازگردانده می‌شوند. درخواست‌های Find Place (Legacy)، Nearby Search (Legacy) و Text Search (Legacy) نیز در صورت مرتبط بودن، یک مرجع عکس را در هر مکان برمی‌گردانند. با استفاده از Place Photos (Legacy) می توانید به عکس های ارجاع شده دسترسی داشته باشید و اندازه تصویر را به اندازه مطلوب برای برنامه خود تغییر دهید.
درخواست‌های عکس‌های مکان (میراث).
درخواست Place Photos (Legacy) یک 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
maxheightspecifies 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.maxwidthspecifies 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
maxheightandmaxwidthproperties accept an integer between1and1600.You must specify either
maxheight, ormaxwidth, or both.
مراجع عکس
همه درخواست‌های مربوط به عکس‌های مکان (میراث) باید شامل یک photo_reference باشد که در پاسخ به درخواست «یافتن مکان» (میراث)، «جستجوی نزدیک» (میراث)، «جستجوی متنی» (میراث)، یا «جزئیات مکان» (میراث) ارائه می‌شود. اگر مکان دارای محتوای عکاسی مرتبط باشد، پاسخ به این درخواست‌ها شامل یک قسمت photos[] خواهد بود.
توجه: تعداد عکس های برگشتی بر اساس درخواست متفاوت است.
- درخواست Find Place (Legacy)، Nearby Search (Legacy)، یا Text Search (Legacy) حداکثر یک عنصر
photoرا در آرایه برمی گرداند. - درخواست جزئیات مکان (میراث) تا ده عنصر
photoرا برمی گرداند.
هر عنصر photo حاوی فیلدهای زیر است:
-
photo_reference- رشته‌ای که برای شناسایی عکس هنگام انجام درخواست Place Photos (Legacy) استفاده می‌شود. -
height- حداکثر ارتفاع تصویر. -
width- حداکثر عرض تصویر. -
html_attributions[]- شامل هر گونه اسناد مورد نیاز است. این فیلد همیشه وجود خواهد داشت، اما ممکن است خالی باشد.
عکس‌های برگردانده شده توسط Place Photos (میراث) از مکان‌های مختلف، از جمله صاحبان کسب‌وکار و عکس‌های ارائه‌شده توسط کاربر، تهیه شده‌اند. در بیشتر موارد، این عکس‌ها را می‌توان بدون ذکر منبع استفاده کرد یا به عنوان بخشی از تصویر، ارجاع مورد نیاز را در نظر گرفت. با این حال، اگر عنصر 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
پاسخ عکس‌های مکان (میراث).
پاسخ یک درخواست موفق Place Photos (Legacy) یک تصویر است. نوع تصویر به نوع عکس ارسالی اصلی بستگی دارد.
اگر درخواست شما از سهمیه موجود شما بیشتر شود، سرور وضعیت HTTP 403 را برمی‌گرداند و تصویر زیر را نمایش می‌دهد تا نشان دهد از سهمیه فراتر رفته است:
اگر سرور قادر به درک درخواست شما نباشد، وضعیت HTTP 400 را برمی‌گرداند که نشان‌دهنده درخواست نامعتبر است. رایج ترین دلایل درخواست نامعتبر عبارتند از:
- مرجع عکس ارسالی به درستی مشخص نشده است.
- این درخواست شامل پارامترهای
maxwidthیاmaxheightنبود. - مقدار پارامتر
maxwidthیاmaxheightرویnullتنظیم شد. -
photo_referenceمنقضی شده است. اگرphoto_referenceمنقضی می‌شود، برای دریافت مقدارphoto_referenceبه‌روزرسانی شده، درخواستی برای جزئیات مکان (میراث) ، یافتن مکان (میراث) ، جستجوی نزدیک (میراث) یا جستجوی متن (میراث) ارائه دهید.