عکس‌های مکان (جدید) مستلزم آن است که نام منبع عکس را که شامل شناسه مکان در URL درخواست می‌شود، به جای مرجع عکس ارسال کنید. برای اطلاعات بیشتر، تغییر به مراجع عکس را ببینید.
Place Photos (جدید) از کلیدهای API و نشانه‌های OAuth به عنوان مکانیزم احراز هویت پشتیبانی می‌کند.
جدول زیر پارامترهایی را در Place Photos (Legacy) که برای Place Photos (جدید) تغییر نام داده یا اصلاح شده‌اند یا پارامترهایی که دیگر پشتیبانی نمی‌شوند، فهرست می‌کند.
پارامتر فعلی
پارامتر جدید
یادداشت ها
maxheight
maxHeightPx
باید maxHeightPx ، maxWidthPx یا هر دو را مشخص کنید.
maxwidth
maxWidthPx
باید maxHeightPx ، maxWidthPx یا هر دو را مشخص کنید.
افزایش سایز عکس
Place Photos (Legacy) حداکثر اندازه عکس 1600 در 1600 پیکسل را پشتیبانی می کند. عکس‌های مکان (جدید) از اندازه‌های حداکثر 4800 در 4800 پیکسل پشتیبانی می‌کند.
تغییر به مرجع عکس
Place Photos (جدید) API مستلزم آن است که نام منبع عکس درخواستی را که شامل شناسه مکان و مرجع عکس است، به شکل زیر ارسال کنید:
جستجوی نزدیک (جدید)، جستجوی متن (جدید)، و جزئیات مکان (جدید) همگی یک آرایه photos[] در پاسخی که از این قالب پشتیبانی می‌کند، برمی‌گردانند. هر عنصر photos[] در پاسخ جدید حاوی فیلدهای زیر است:
name - رشته ای حاوی نام منبع عکس. این رشته به شکل زیر است:
places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx - حداکثر ارتفاع تصویر، بر حسب پیکسل.
widthPx - حداکثر عرض تصویر، بر حسب پیکسل.
authorAttributions[] - هر گونه اسناد مورد نیاز. این فیلد همیشه وجود دارد، اما ممکن است خالی باشد.
با API قدیمی، فقط باید مرجع عکس را به شکل زیر ارسال کنید:
یافتن مکان (میراث)، جستجوی نزدیک (میراث)، جستجوی متن (میراث)، و جزئیات مکان (میراث) همگی یک آرایه photos[] در پاسخی که از این قالب پشتیبانی می‌کند، برمی‌گردانند. هر عنصر photo در پاسخ قدیمی حاوی فیلدهای زیر است:
photo_reference - رشته ای که برای شناسایی عکس هنگام انجام درخواست عکس استفاده می شود.
height - حداکثر ارتفاع تصویر.
width - حداکثر عرض تصویر.
html_attributions[] - هر گونه اسناد مورد نیاز. این فیلد همیشه وجود دارد، اما ممکن است خالی باشد.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Migrate to Place Photos (New)\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nIntroduction\n------------\n\nThe Places API supports\n[Place Photos (Legacy)](/maps/documentation/places/web-service/photos).\nIf you are familiar with Place Photos (Legacy),\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nmakes the following changes:\n\n- Place Photos (New) requires that you pass the resource name of the photo, which includes the place ID in the request URL, instead of just the photo reference. For more information, see [Change to photo references](#photo-ref).\n- Place Photos (New) supports both [API keys](/maps/documentation/places/web-service/get-api-key) and [OAuth](/maps/documentation/places/web-service/oauth-token) tokens as the authentication mechanism.\n\nThe following table lists parameters in\nPlace Photos (Legacy) that have been renamed or\nmodified for Place Photos (New), or parameters\nthat are no longer supported.\n\n| Current parameter | New parameter | Notes |\n|-------------------|---------------|---------------------------------------------------------------|\n| `maxheight` | `maxHeightPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n| `maxwidth` | `maxWidthPx` | You must specify either `maxHeightPx`, `maxWidthPx`, or both. |\n\n### Increased photo size\n\nPlace Photos (Legacy) supported a maximum photo\nsize of 1600 by 1600 pixels. Place Photos (New)\nsupports sizes up to 4800 by 4800 pixels.\n\n### Change to photo references\n\n[Place Photos (New)](/maps/documentation/places/web-service/place-photos)\nAPI requires that you pass the *resource name* of the requested photo, which\nincludes a **place ID** and the **photo reference**, in the form: \n\n```json\nhttps://places.googleapis.com/v1/places/\u003cvar translate=\"no\"\u003ePLACE_ID\u003c/var\u003e/photos/\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003e/media?maxWidthPx=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nNearby Search (New),\nText Search (New), and\nPlace Details (New)\nall return a `photos[]` array in the response that supports this format. Each\nelement of `photos[]` in the new response contains the following fields:\n\n- `name` --- A string containing the resource name of the\n photo. This string is in the form:\n\n ```\n places/PLACE_ID/photos/PHOTO_REFERENCE\n ```\n- `heightPx` --- The maximum height of the image, in pixels.\n- `widthPx` --- The maximum width of the image, in pixels.\n- `authorAttributions[]` --- Any required attributions. This field is always present, but might be empty.\n\nWith the legacy API, you only have to pass the **photo reference**, in the\nform: \n\n```json\nhttps://maps.googleapis.com/maps/api/place/photo?photo_reference=\u003cvar translate=\"no\"\u003ePHOTO_REFERENCE\u003c/var\u003emaxwidth=400&key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\n```\n\nFind Place (Legacy),\nNearby Search (Legacy),\nText Search (Legacy), and\nPlace Details (Legacy) all return a `photos[]` array in\nthe response that supports this format. Each `photo` element in the legacy\nresponse contains the following fields:\n\n- `photo_reference` --- A string used to identify the photo when you perform a Photo request.\n- `height` --- The maximum height of the image.\n- `width` --- The maximum width of the image.\n- `html_attributions[]` --- Any required attributions. This field is always present, but might be empty.\n\n| **Note:** The `photo_reference` field does not include the place ID. If you want to use Place Photos (New) with these legacy APIs, you must add the place ID to construct the full resource name."]]
