Places API は既存の Place Photo。 既存の Place Photo を使い慣れている場合は、 新バージョンの Place Photo 次の変更が行われます。
- 新しいプレイスフォトサービスをご利用になるには、 写真のリソース名を渡します。この名前にはプレイス ID が含まれます。 リクエスト URL を渡します。詳細については、次をご覧ください: 写真の参照の変更。
- 新しいプレイスフォトサービスは API キー および OAuth 使用することをおすすめします。
次の表に、既存の 名前が変更された、または修正された Place Photo 新しいプレイスフォト、またはパラメータが サポートされません。
| 現在のパラメータ | 新しいパラメータ | メモ |
|---|---|---|
maxheight |
maxHeightPx |
maxHeightPx、
maxWidthPx、またはその両方です。 |
maxwidth |
maxWidthPx |
maxHeightPx、
maxWidthPx、またはその両方です。 |
写真サイズを拡大しました
既存のプレイスフォトでサポートされていた写真は最大数までです 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[]- 必要な帰属情報。この フィールドは常に存在しますが、空の場合もあります。