Method: places.photos.getMedia

Nhận 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

Các tham số
name

string

Bắt buộc. Tên tài nguyên của phương tiện ảnh có định dạng: places/{placeId}/photos/{photo_reference}/media.

Tên tài nguyên của một ả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 nối /media ở cuối tài nguyên ảnh để lấy tên tài nguyên nội dung nghe nhìn trên ảnh.

Tham số truy vấn

Các tham số
maxWidthPx

integer

Không bắt buộc. Chỉ định chiều rộng tối đa mà bạn muốn, tính bằng pixel, của hình ảnh. Nếu hình ảnh nhỏ hơn giá trị được chỉ định, hệ thống sẽ trả về hình ảnh gốc. Nếu hình ảnh lớn hơn ở một trong hai chiều, 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 chiều, được giới hạn ở tỷ lệ khung hình gốc. Cả hai thuộc tính maxHeightPx và maxWidthPx đều chấp nhận một số nguyên từ 1 đến 4800. Nếu giá trị không nằm trong phạm vi cho phép, hệ thống sẽ trả về lỗi INVALID_ nhiệm.

Cần chỉ định ít nhất một trong số maxHeightPx hoặc maxWidthPx. Nếu không chỉ định maxHeightPx và maxWidthPx, hệ thống sẽ trả về lỗi INVALID_URL.

maxHeightPx

integer

Không bắt buộc. Chỉ định chiều cao tối đa mong muốn của hình ảnh, tính bằng pixel. Nếu hình ảnh nhỏ hơn giá trị được chỉ định, hệ thống sẽ trả về hình ảnh gốc. Nếu hình ảnh lớn hơn ở một trong hai chiều, 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 chiều, được giới hạn ở tỷ lệ khung hình gốc. Cả hai thuộc tính maxHeightPx và maxWidthPx đều chấp nhận một số nguyên từ 1 đến 4800. Nếu giá trị không nằm trong phạm vi cho phép, hệ thống sẽ trả về lỗi INVALID_ nhiệm.

Cần chỉ định ít nhất một trong số maxHeightPx hoặc maxWidthPx. Nếu không chỉ định maxHeightPx và maxWidthPx, hệ thống sẽ trả về lỗi INVALID_URL.

skipHttpRedirect

boolean

Không bắt buộc. Nếu bạn đặt chính sách này, 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, hệ thống sẽ tạo một 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

Ảnh nội dung nghe nhìn 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
}
Các trường
name

string

Tên tài nguyên của phương tiện ảnh có đị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.