はじめに
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、またはその両方を指定する必要があります。 |
写真サイズの増加
プレイス フォト (レガシー) では、最大 1600 x 1600 ピクセルの写真サイズがサポートされていました。Place Photos（New）は、最大 4,800×4,800 ピクセルのサイズをサポートしています。
写真参照に変更
Place Photos（新版）API では、リクエストされた写真のリソース名（プレイス ID と写真の参照を含む）を次の形式で渡す必要があります。
https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY
周辺検索（新）、テキスト検索（新）、場所詳細（新）はすべて、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従来の応答の要素には、次のフィールドが含まれています。
photo_reference— 写真リクエストを実行するときに写真を識別するために使用される文字列。height- 画像の最大高さ。width— 画像の最大幅。html_attributions[]- 必要な帰属表示。このフィールドは常に存在しますが、空の場合があります。