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

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

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

integer

（省略可）画像の高さとして必要な上限をピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。いずれかのサイズが大きい画像は、元のアスペクト比に合わせて拡大縮小されます。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。