Ảnh địa điểm (Mới) yêu cầu bạn truyền tên tài nguyên của ảnh, bao gồm cả mã địa điểm trong URL yêu cầu, thay vì chỉ truyền thông tin tham chiếu về ảnh. Để biết thêm thông tin, hãy xem bài viết Thay đổi thành ảnh tham khảo.
Place Photos (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
Bảng sau đây liệt kê các tham số trong Place Photos (Cũ) đã được đổi tên hoặc sửa đổi cho Place Photos (Mới), hoặc các tham số không còn được hỗ trợ.
Tham số hiện tại
Thông số mới
Ghi chú
maxheight
maxHeightPx
Bạn phải chỉ định maxHeightPx, maxWidthPx hoặc cả hai.
maxwidth
maxWidthPx
Bạn phải chỉ định maxHeightPx, maxWidthPx hoặc cả hai.
Tăng kích thước ảnh
Ảnh về địa điểm (phiên bản cũ) hỗ trợ kích thước ảnh tối đa là 1600 x 1600 pixel. Ảnh về địa điểm (Mới) hỗ trợ kích thước lên đến 4800 x 4800 pixel.
Chuyển sang ảnh tham khảo
API Ảnh địa điểm (Mới) yêu cầu bạn truyền tên tài nguyên của bức ảnh được yêu cầu, bao gồm mã địa điểm và tham chiếu ảnh, theo dạng:
Nearby Search (Mới), Text Search (Mới) và Place Details (Mới) đều trả về một mảng photos[] trong phản hồi hỗ trợ định dạng này. Mỗi phần tử của photos[] trong phản hồi mới chứa các trường sau:
name – Một chuỗi chứa tên tài nguyên của bức ảnh. Chuỗi này có dạng:
places/PLACE_ID/photos/PHOTO_REFERENCE
heightPx – Chiều cao tối đa của hình ảnh, tính bằng pixel.
widthPx – Chiều rộng tối đa của hình ảnh, tính bằng pixel.
authorAttributions[] – Mọi thông tin ghi công bắt buộc. Trường này luôn xuất hiện nhưng có thể trống.
Với API cũ, bạn chỉ cần truyền tham chiếu ảnh ở dạng:
Find Place (Legacy), Nearby Search (Legacy), Text Search (Legacy) và Place Details (Legacy) đều trả về một mảng photos[] trong phản hồi hỗ trợ định dạng này. Mỗi phần tử photo trong phản hồi cũ đều chứa các trường sau:
photo_reference – Một chuỗi dùng để xác định ảnh khi bạn thực hiện yêu cầu về Ảnh.
height – Chiều cao tối đa của hình ảnh.
width — Chiều rộng tối đa của hình ảnh.
html_attributions[] – Mọi thông tin ghi công bắt buộc. Trường này luôn xuất hiện nhưng có thể trống.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],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."]]
