Method: places.photos.getMedia

使用相片參照字串取得相片媒體。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。相片媒體的資源名稱，格式為：places/{placeId}/photos/{photo_reference}/media。

Place 物件的 photos.name 欄位傳回的相片資源名稱會採用 places/{placeId}/photos/{photo_reference} 格式。您需要在相片資源結尾處附加 /media，以取得相片媒體資源名稱。

查詢參數

參數
maxWidthPx

integer

選用設定。指定所需的圖片寬度上限 (以像素為單位)。如果圖片小於指定值，系統會傳回原始圖片。如果任一尺寸的圖片較大，系統會將其縮放至與中兩者中較小者的尺寸，以至於原始顯示比例限制。maxHeightPx 和 maxWidthPx 屬性都接受 1 到 4800 (含) 之間的整數 (含首尾)。如果值不在允許的範圍內，系統會傳回 INVALID_COUNTRY 錯誤。

至少須指定一個 maxHeightPx 或 maxWidthPx。如未指定 maxHeightPx 和 maxWidthPx，系統就會傳回 INVALID_COUNTRY 錯誤。
maxHeightPx

integer

選用設定。指定所需的圖片高度上限 (以像素為單位)。如果圖片小於指定值，系統會傳回原始圖片。如果任一尺寸的圖片較大，系統會將其縮放至與中兩者中較小者的尺寸，以至於原始顯示比例限制。maxHeightPx 和 maxWidthPx 屬性都接受 1 到 4800 (含) 之間的整數 (含首尾)。如果值不在允許的範圍內，系統會傳回 INVALID_COUNTRY 錯誤。

至少須指定一個 maxHeightPx 或 maxWidthPx。如未指定 maxHeightPx 和 maxWidthPx，系統就會傳回 INVALID_COUNTRY 錯誤。
skipHttpRedirect

boolean

選用設定。如果已設定，請略過預設的 HTTP 重新導向行為，並轉譯文字格式 (例如，HTTP 用途採用 JSON 格式) 回應。如未設定，系統會發出 HTTP 重新導向，將呼叫重新導向至圖片媒體。非 HTTP 要求會忽略此選項。

要求主體

要求主體必須為空白。

回應主體

Places API 的相片媒體。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "name": string,
  "photoUri": string
}
欄位
name

string

相片媒體的資源名稱，格式為：places/{placeId}/photos/{photo_reference}/media。
photoUri

string

一個時效短暫的 URI，可用於算繪相片。