プレイス写真への移行(新規)

Places API は既存の Place Photo。 既存の Place Photo を使い慣れている場合は、 新バージョンの Place Photo 次の変更を行います。

  • 新しいプレイスフォトサービスをご利用になるには、 写真のリソース名を渡します。この名前にはプレイス ID が含まれます。 リクエスト URL を渡します。詳細については、次をご覧ください: 写真の参照の変更
  • 新しいプレイスフォトサービスは API キー および OAuth 使用することをおすすめします。

次の表に、既存の 名前が変更された、または修正された Place Photo 新しいプレイスフォト、またはパラメータが サポートされません。

現在のパラメータ 新しいパラメータ メモ
maxheight maxHeightPx maxHeightPxmaxWidthPx、またはその両方です。
maxwidth maxWidthPx maxHeightPxmaxWidthPx、またはその両方です。

写真サイズを拡大しました

既存のプレイスフォトでサポートされていた写真は最大数までです 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[] - 必要な帰属情報。この フィールドは常に存在しますが、空の場合もあります。
で確認できます。