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

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

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

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

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

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

既存の Place Photo では、最大写真サイズが 1,600 x 1,600 ピクセルでした。Place Photo（新規）は、最大 4,800×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

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