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

Places API は Place Photo（従来版）をサポートしています。Place Photo（従来版）をご存じであれば、Place Photo（新規版）では次のような変更が加えられています。

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

次の表に、Place Photo（従来版）のパラメータのうち、Place Photo（新規版）で名前が変更または変更されたパラメータ、またはサポートが終了したパラメータを示します。

現在のパラメータ 新しいパラメータ メモ
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

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

  • photo_reference - 写真リクエストを実行する際に写真の識別に使用される文字列。
  • height - 画像の最大高。
  • width - 画像の最大幅。
  • html_attributions[] - 必要な帰属情報。このフィールドは常に存在しますが、空の場合があります。