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 ~ 4800 の整数を取ります。値が許容範囲内でない場合は、INVALID_ARGUMENT エラーが返されます。

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

maxHeightPx

integer

省略可。画像の最大希望高さをピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のサイズが大きい場合は、元のアスペクト比に合わせて、2 つのサイズのどちらか小さい方に合わせて拡大縮小されます。maxHeightPx プロパティと maxWidthPx プロパティのどちらも、1 ~ 4800 の整数を取ります。値が許容範囲内でない場合は、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。