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

Places API は既存の Place Photo をサポートしています。既存の Place Photo を使い慣れている方は、新バージョンの Place Photo で次のように変更されています。

  • 新しいプレイスフォト サービスでは、写真の参照だけでなく、場所の 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 x 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[] - 必要な帰属情報。このフィールドは常に存在しますが、空の場合もあります。