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[]
- 必要な帰属情報。この フィールドは常に存在しますが、空の場合もあります。