はじめに
Places API は Place Photos（旧版）をサポートしています。 Place Photos（旧版）をご存じの場合は、 Place Photos（新版） で以下の変更が加えられています。
- Place Photos（新版）では、写真の参照情報だけでなく、リクエスト URL に場所 ID を含む写真のリソース名を渡す必要があります。詳細については、 写真の参照情報の変更をご覧ください。
- Place Photos（新版）では、認証メカニズムとして API キー と OAuth トークンの両方がサポートされています。
次の表に、Place Photos（旧版）で名前が変更されたパラメータ、Place Photos（新版）で変更されたパラメータ、またはサポートされなくなったパラメータを示します。
| 現在のパラメータ | 新しいパラメータ | メモ |
|---|---|---|
maxheight |
maxHeightPx |
maxHeightPx、
maxWidthPx のいずれか、または両方を指定する必要があります。 |
maxwidth |
maxWidthPx |
maxHeightPx、
maxWidthPx のいずれか、または両方を指定する必要があります。 |
写真サイズの拡大
Place Photos（旧版）では、写真の最大サイズは 1600 x 1600 ピクセルでした。Place Photos（新版）では、最大 4800 x 4800 ピクセルまでのサイズがサポートされています。
写真の参照情報の変更
Place Photos（新版） API では、リクエストされた写真のリソース名を次の形式で渡す必要があります。これには、 場所 IDと写真の参照情報が含まれます。
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
Nearby 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（旧版）、テキスト検索（旧版）、Place Details（旧版）ではすべて、この形式をサポートする photos[] 配列がレスポンスで返されます。旧版のレスポンスの各 photo 要素には、次のフィールドが含まれます。
photo_reference- 写真リクエストを実行するときに写真を識別するために使用される文字列。height- 画像の最大高さ。width- 画像の最大幅。html_attributions[]- 必要な属性情報。このフィールドは常に存在しますが、空の場合があります。