Method: places.photos.getMedia

Lấy nội dung nghe nhìn dạng ả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

Thông 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 đượ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.
photoUri

string

Một uri ngắn hạn có thể dùng để hiển thị ảnh.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform