Places API は、既存の Place Photo をサポートしています。既存の Place Photo を使い慣れている場合、新しいバージョンの Place Photo では以下の点が変更されています。
- 新しい Place Photo サービスでは、写真のリソース名を渡す必要があります。リクエスト URL には、写真の参照だけでなくプレイス ID が含まれます。詳しくは、写真の参照に関する変更をご覧ください。
- 新しいプレイス フォト サービスでは、認証メカニズムとして API キーと OAuth トークンの両方がサポートされています。
次の表は、既存のプレイスフォトのパラメータの中で、新しいプレイス写真用に名前変更または変更されたパラメータと、サポートされなくなったパラメータの一覧です。
現在のパラメータ | 新しいパラメータ | メモ |
---|---|---|
maxheight |
maxHeightPx |
maxHeightPx 、maxWidthPx 、またはその両方を指定する必要があります。 |
maxwidth |
maxWidthPx |
maxHeightPx 、maxWidthPx 、またはその両方を指定する必要があります。 |
写真サイズを拡大
既存のプレイスフォトは、最大 1,600 x 1,600 ピクセルの写真サイズをサポートしていました。Place Photo (New) は最大 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[]
- 必要な帰属表示。このフィールドは常に存在しますが、空の場合もあります。