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

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

integer

選用設定。指定圖片的所需高度上限 (以像素為單位)。如果圖片小於指定值，系統就會傳回原始圖片。如果圖片的任一尺寸較大，系統會將圖片調整為兩個尺寸中較小者，以符合原始長寬比。maxHeightPx 和 maxWidthPx 屬性都接受介於 1 到 4800 (含) 之間的整數。如果該值超出允許範圍，則會傳回 INVALID_TRUE 錯誤。

至少須指定一個 maxHeightPx 或 maxWidthPx。如未指定 maxHeightPx 和 maxWidthPx，系統會傳回 INVALID_src 錯誤。
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。