このページは Cloud Translation API によって翻訳されました。

プレイス写真への移行（新規）

Places API は、既存の Place Photo をサポートしています。既存の Place Photo をご存じであれば、新しいバージョンの Place Photo では次のような変更が加えられています。

新しいプレイスフォトサービスでは、写真のリファレンスだけでなく、写真のリソース名（リクエスト URL のプレイス ID を含む）を渡す必要があります。詳細については、写真参照への変更をご覧ください。
新しい Place Photo サービスは、認証メカニズムとして API キーと OAuth トークンの両方をサポートしています。

次の表に、新しいプレイスフォト用に名前が変更または変更された既存のプレイスフォトのパラメータ、またはサポートが終了したパラメータを示します。

現在のパラメータ	新しいパラメータ	メモ
`maxheight`	`maxHeightPx`	`maxHeightPx` または `maxWidthPx` のいずれか、または両方を指定する必要があります。
`maxwidth`	`maxWidthPx`	`maxHeightPx` または `maxWidthPx` のいずれか、または両方を指定する必要があります。

既存のプレイスフォトは、最大 1,600 x 1,600 ピクセルの写真をサポートしていました。Place Photo（新規）は、最大 4,800 x 4,800 ピクセルのサイズをサポートしています。

新しい Place Photo API では、リクエストされた写真のリソース名（プレイス ID と写真参照を含む）を次の形式で渡す必要があります。

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

新しいバージョンの Nearby Search、Text Search、Place Details はすべて、この形式をサポートするレスポンスで photos[] 配列を返します。新しいレスポンスの photos[] の各要素には、次のフィールドが含まれます。

name - 写真のリソース名を含む文字列。この文字列の形式は次のとおりです。
```
places/PLACE_ID/photos/PHOTO_REFERENCE
```
heightPx - 画像の最大高さ（ピクセル単位）。
widthPx - 画像の最大幅（ピクセル単位）。
authorAttributions[] - 必要な帰属表示。このフィールドは常に存在しますが、空の場合があります。

既存の API では、写真の参照のみを次の形式で渡す必要があります。

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

既存の Find Place、Nearby Search、Text Search、Place Details はすべて、この形式をサポートする photos[] 配列をレスポンスで返します。既存のレスポンスの各 photo 要素には、次のフィールドが含まれています。