Bắt buộc. Tên tài nguyên của nội dung nghe nhìn dạng ảnh ở định dạng: places/{placeId}/photos/{photo_reference}/media.
Tên tài nguyên của ảnh được trả về trong trường photos.name của đối tượng Địa điểm có định dạng places/{placeId}/photos/{photo_reference}. Bạn cần thêm /media vào cuối tài nguyên ảnh để lấy tên tài nguyên nội dung nghe nhìn ảnh.
Tham số truy vấn
Thông số
maxWidthPx
integer
Không bắt buộc. Chỉ định chiều rộng tối đa mong muốn, tính bằng pixel, của hình ảnh. Nếu hình ảnh nhỏ hơn các giá trị đã chỉ định, hình ảnh gốc sẽ được trả về. Nếu lớn hơn ở một trong hai kích thước, hình ảnh sẽ được điều chỉnh theo tỷ lệ cho phù hợp với kích thước nhỏ hơn trong hai kích thước, bị giới hạn ở tỷ lệ khung hình ban đầu. Cả thuộc tính maxHeightPx và maxWidthPx đều chấp nhận số nguyên từ 1 đến 4800. Nếu giá trị không nằm trong phạm vi cho phép, thì lỗi INVALID_ARGUMENT sẽ được trả về.
Bạn cần chỉ định ít nhất một trong hai thuộc tính maxHeightPx hoặc maxWidthPx. Nếu bạn không chỉ định maxHeightPx hoặc maxWidthPx, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
maxHeightPx
integer
Không bắt buộc. Chỉ định chiều cao tối đa mong muốn (tính bằng pixel) của hình ảnh. Nếu hình ảnh nhỏ hơn các giá trị đã chỉ định, hình ảnh gốc sẽ được trả về. Nếu lớn hơn ở một trong hai kích thước, hình ảnh sẽ được điều chỉnh theo tỷ lệ cho phù hợp với kích thước nhỏ hơn trong hai kích thước, bị giới hạn ở tỷ lệ khung hình ban đầu. Cả thuộc tính maxHeightPx và maxWidthPx đều chấp nhận số nguyên từ 1 đến 4800. Nếu giá trị không nằm trong phạm vi cho phép, thì lỗi INVALID_ARGUMENT sẽ được trả về.
Bạn cần chỉ định ít nhất một trong hai thuộc tính maxHeightPx hoặc maxWidthPx. Nếu bạn không chỉ định maxHeightPx hoặc maxWidthPx, hệ thống sẽ trả về lỗi INVALID_ARGUMENT.
skipHttpRedirect
boolean
Không bắt buộc. Nếu được đặt, hãy bỏ qua hành vi chuyển hướng HTTP mặc định và hiển thị phản hồi ở định dạng văn bản (ví dụ: ở định dạng JSON cho trường hợp sử dụng HTTP). Nếu bạn không đặt thuộc tính này, hệ thống sẽ chuyển hướng HTTP để chuyển hướng lệnh gọi đến nội dung nghe nhìn hình ảnh. Tuỳ chọn này bị bỏ qua đối với các yêu cầu không phải HTTP.
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nội dung nghe nhìn dạng ảnh từ API Địa điểm.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON
{"name": string,"photoUri": string}
Trường
name
string
Tên tài nguyên của nội dung nghe nhìn dạng ảnh ở định dạng: places/{placeId}/photos/{photo_reference}/media.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eRetrieve a photo media resource using a specific photo reference string through a GET request.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003ename\u003c/code\u003e path parameter specifying the photo media resource, formatted as \u003ccode\u003eplaces/{placeId}/photos/{photo_reference}/media\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptionally customize the retrieved photo's dimensions using \u003ccode\u003emaxWidthPx\u003c/code\u003e and \u003ccode\u003emaxHeightPx\u003c/code\u003e query parameters, with values ranging from 1 to 4800.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a JSON object containing the photo media's resource name (\u003ccode\u003ename\u003c/code\u003e) and a temporary URI (\u003ccode\u003ephotoUri\u003c/code\u003e) for rendering the photo.\u003c/p\u003e\n"]]],["This outlines how to retrieve photo media using a `GET` request to the specified URL, which requires a photo resource `name` in the path parameters. Optional query parameters `maxWidthPx` and `maxHeightPx` allow for image resizing (1-4800 pixels). `skipHttpRedirect` is another optional parameter. The request body must be empty. The response includes `name` and a short-lived `photoUri` for the photo. Access requires the `cloud-platform` authorization scope.\n"],null,["# Method: places.photos.getMedia\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PhotoMedia.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nGet a photo media with a photo reference string.\n\n### HTTP request\n\n`GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name of a photo media in the format: `places/{placeId}/photos/{photo_reference}/media`. The resource name of a photo as returned in a Place object's `photos.name` field comes with the format `places/{placeId}/photos/{photo_reference}`. You need to append `/media` at the end of the photo resource to get the photo media resource name. |\n\n### Query parameters\n\n| Parameters ||\n|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxWidthPx` | `integer` Optional. 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 maxHeightPx and maxWidthPx properties accept an integer between 1 and 4800, inclusively. If the value is not within the allowed range, an INVALID_ARGUMENT error will be returned. At least one of maxHeightPx or maxWidthPx needs to be specified. If neither maxHeightPx nor maxWidthPx is specified, an INVALID_ARGUMENT error will be returned. |\n| `maxHeightPx` | `integer` Optional. 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. Both the maxHeightPx and maxWidthPx properties accept an integer between 1 and 4800, inclusively. If the value is not within the allowed range, an INVALID_ARGUMENT error will be returned. At least one of maxHeightPx or maxWidthPx needs to be specified. If neither maxHeightPx nor maxWidthPx is specified, an INVALID_ARGUMENT error will be returned. |\n| `skipHttpRedirect` | `boolean` Optional. If set, skip the default HTTP redirect behavior and render a text format (for example, in JSON format for HTTP use case) response. If not set, an HTTP redirect will be issued to redirect the call to the image media. This option is ignored for non-HTTP requests. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA photo media from Places API.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------|\n| ``` { \"name\": string, \"photoUri\": string } ``` |\n\n| Fields ||\n|------------|---------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name of a photo media in the format: `places/{placeId}/photos/{photo_reference}/media`. |\n| `photoUri` | `string` A short-lived uri that can be used to render the photo. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`"]]
