Method: places.photos.getMedia

Tải nội dung nghe nhìn từ hình ảnh có chuỗi tham chiếu ảnh.

Yêu cầu HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
name

string

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 khi đượ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 từ ảnh.

Tham số truy vấn

Tham 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 hình ảnh 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 vừa với kích thước nhỏ hơn trong hai kích thước, được giới hạn theo tỷ lệ khung hình ban đầu. Cả hai 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, lỗi INVALID_ARGUMENT sẽ được trả về.

Bạn cần chỉ định ít nhất một trong số maxHeightPx hoặc maxWidthPx. Nếu không chỉ định maxHeightPx và maxWidthPx, thì 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 hình ảnh 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 vừa với kích thước nhỏ hơn trong hai kích thước, được giới hạn theo tỷ lệ khung hình ban đầu. Cả hai 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, lỗi INVALID_ARGUMENT sẽ được trả về.

Bạn cần chỉ định ít nhất một trong số maxHeightPx hoặc maxWidthPx. Nếu không chỉ định maxHeightPx và maxWidthPx, thì 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 chính sách này, thì hệ thống sẽ phát hành lệnh chuyển hướng HTTP để chuyển hướng lệnh gọi đến nội dung nghe nhìn dạng 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 lấy từ Places API.

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.
photoUri

string

Một URI ngắn hạn có thể dùng để kết xuất ảnh.