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_ARGUMENT 錯誤。

至少需要指定 maxHeightPx 或 maxWidthPx 其中一個。如果未指定 maxHeightPx 或 maxWidthPx，系統會傳回 INVALID_ARGUMENT 錯誤。
maxHeightPx

integer

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

至少需要指定 maxHeightPx 或 maxWidthPx 其中一個。如果未指定 maxHeightPx 或 maxWidthPx，系統會傳回 INVALID_ARGUMENT 錯誤。
skipHttpRedirect

boolean

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

要求主體

要求主體必須為空白。

回應主體

Places API 中的相片媒體。

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

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

string

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

string

可用於算繪相片的短效 uri。

授權範圍

需要下列 OAuth 範圍：

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