Place Photo（新規）に移行する

欧州経済領域（EEA）のデベロッパー

はじめに

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、またはその両方を指定する必要があります。

写真のサイズが大きくなった

プレイス写真（以前のバージョン）では、写真の最大サイズは 1,600×1,600 ピクセルでした。Place Photos（新版）は、最大 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

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

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