Method: places.photos.getMedia

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

HTTP 要求

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

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

路徑參數

參數
name

string

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

地點物件 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 重新導向行為，並以文字格式 (例如 HTTP 用途的 JSON 格式) 呈現回應。如果未設定，系統會發出 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/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform