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

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

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

新しいプレイスフォトサービスをご利用になるには、写真のリソース名を渡します。この名前にはプレイス ID が含まれます。リクエスト URL を渡します。詳細については、次をご覧ください: 写真の参照の変更。
新しいプレイスフォトサービスは 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 要素には、次のフィールドが含まれます。