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 です。

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

クエリ パラメータ

パラメータ
maxWidthPx

integer

省略可。画像の最大幅をピクセル単位で指定します。画像が指定した値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元の縦横比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。maxHeightPx プロパティと maxWidthPx プロパティの両方で、1 ～ 4800 の整数を指定できます。値が許容範囲外の場合は、INVALID_ARGUMENT エラーが返されます。

maxHeightPx または maxWidthPx のいずれかを指定する必要があります。maxHeightPx と maxWidthPx の両方を指定しないと、INVALID_ARGUMENT エラーが返されます。
maxHeightPx

integer

省略可。画像の最大高さをピクセル単位で指定します。画像が指定した値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元の縦横比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。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