Method: places.photos.getMedia

Lấy một tệp ảnh đa phương tiện bằng 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 một ảnh trong tệp đa phương tiện ở định dạng: places/{placeId}/photos/{photo_reference}/media.

Tên tài nguyên của một bức ảnh được trả về trong trường photos.name của đối tượng Place 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 của ả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 của hình ảnh, tính bằng pixel. Nếu hình ảnh nhỏ hơn các giá trị được chỉ định, hình ảnh gốc sẽ được trả về. Nếu hình ảnh lớn hơn ở một trong hai chiều, thì hình ảnh đó sẽ được điều chỉnh tỷ lệ cho phù hợp với chiều nhỏ hơn trong hai chiều, trong phạm vi tỷ lệ khung hình ban đầu. Cả hai thuộc tính maxHeightPx và maxWidthPx đều chấp nhận một số nguyên từ 1 đến 4800 (bao gồm cả 1 và 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 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 của hình ảnh, tính bằng pixel. Nếu hình ảnh nhỏ hơn các giá trị được chỉ định, hình ảnh gốc sẽ được trả về. Nếu hình ảnh lớn hơn ở một trong hai chiều, thì hình ảnh đó sẽ được điều chỉnh tỷ lệ cho phù hợp với chiều nhỏ hơn trong hai chiều, trong phạm vi tỷ lệ khung hình ban đầu. Cả hai thuộc tính maxHeightPx và maxWidthPx đều chấp nhận một số nguyên từ 1 đến 4800 (bao gồm cả 1 và 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 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 không được đặt, một lệnh chuyển hướng HTTP sẽ được phát hành để chuyển hướng lệnh gọi đến nội dung nghe nhìn của hình ảnh. Tuỳ chọn này sẽ 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

Một ảnh đa phương tiệ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
}
Trường
name

string

Tên tài nguyên của một ảnh trong tệp đa phương tiện ở định dạng: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

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

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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