Method: places.photos.getMedia

写真の参照文字列を使用して写真メディアを取得します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。写真メディアのリソース名（places/{placeId}/photos/{photo_reference}/media 形式）。

プレイス オブジェクトの photos.name フィールドで返される写真のリソース名は、places/{placeId}/photos/{photo_reference} の形式です。写真メディアのリソース名を取得するには、写真リソースの末尾に /media を追加する必要があります。

クエリ パラメータ

パラメータ
maxWidthPx

integer

省略可。画像の最大幅（ピクセル単位）を指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかのサイズが指定サイズより大きい場合は、元のアスペクト比を維持しながら、2 つのサイズのうち小さい方に合わせて画像が拡大されます。maxHeightPx プロパティと maxWidthPx プロパティの両方には、1 ～ 4, 800 の整数を指定できます。値が許容範囲内に入っていない場合、INVALID_ARGUMENT エラーが返されます。

maxHeightPx または maxWidthPx の少なくとも 1 つを指定する必要があります。maxHeightPx も maxWidthPx も指定されていない場合、INVALID_ARGUMENT エラーが返されます。
maxHeightPx

integer

省略可。画像の高さの最大値（ピクセル単位）を指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかのサイズが指定サイズより大きい場合は、元のアスペクト比を維持しながら、2 つのサイズのうち小さい方に合わせて画像が拡大されます。maxHeightPx プロパティと maxWidthPx プロパティの両方には、1 ～ 4, 800 の整数を指定できます。値が許容範囲内に入っていない場合、INVALID_ARGUMENT エラーが返されます。

maxHeightPx または maxWidthPx の少なくとも 1 つを指定する必要があります。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/cloud-platform