Place Photos（従来版）

欧州経済領域（EEA）のデベロッパー

Places API の一部である Place Photos（以前のバージョン）は、読み取り専用の API であり、アプリケーションに高品質な写真コンテンツを追加できます。Place Photos（レガシー）では、プレイス データベースに保存されている数百万の写真にアクセスできます。Place Details リクエストを使って場所の情報を検索すると、関連する写真コンテンツに対する写真のリファレンスが返されます。Find Place（従来版）、Nearby Search（従来版）、Text Search（従来版）のリクエストでも、関連する写真コンテンツがあれば、場所ごとに 1 つの写真のリファレンスが返されます。Place Photos（以前のバージョン）を使用すると、参照された写真にアクセスできるだけでなく、そうした画像をアプリケーションに最適なサイズに変更できます。

Place Photos（従来版）リクエスト

Place Photos（Legacy）リクエストは、次の形式の HTTP URL です。

https://maps.googleapis.com/maps/api/place/photo?parameters

検索リクエストを開始するには、特定のパラメータが必要です。URL の標準規則と同様に、すべてのパラメータはアンパサンド（&）文字を使用して区切ります。パラメータとその可能な値のリストを以下に示します。

Required parameters

  • photo_reference

    A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.

  • maxheight or maxwidth

    maxheight specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    maxwidth specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.

    Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

写真の参照

Place Photos（従来版）に対するすべてのリクエストには、Find Place（従来版）、Nearby Search（従来版）、テキスト検索（従来版）、または Place Details（従来版）リクエストのレスポンスで返される photo_reference を含める必要があります。これらのリクエストに対するレスポンスには、場所に関連する写真コンテンツがある場合に photos[] フィールドが含まれます。

注: 返される写真の数はリクエストによって異なります。

  • Find Place（従来版）、Nearby Search（従来版）、Text Search（従来版）のリクエストでは、配列内の photo 要素が 1 つのみ返されます。
  • Place Details（以前のバージョン）リクエストでは、最大 10 個の photo 要素が返されます。

各 photo 要素には次のフィールドが含まれています。

  • photo_reference - Place Photos（レガシー）リクエストを実行するときに写真の識別に使用される文字列。
  • height - 画像の最大高さ。
  • width - 画像の最大幅。
  • html_attributions[] - 必要な帰属情報が含まれます。このフィールドは常に存在しますが、空の場合があります。

Place Photos（以前のバージョン）によって返される写真の提供元は、お店やサービスの所有者、ユーザーの投稿などさまざまです。こういった写真は、帰属情報なしで使用できる場合や、必要な帰属情報が画像内にあらかじめ記載されている場合がほとんどです。ただし、返された photo 要素の html_attributions フィールドに値が含まれる場合は、アプリケーション内でその画像を表示するすべての箇所で、追加の帰属情報として組み込む必要があります。

次の例は、Place Details（レガシー）リクエストを示しています。

curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"

レスポンスの photos[] 配列の例を次に示します。

    ...
    "photos" : [
       {
          "html_attributions" : [],
          "height" : 853,
          "width" : 1280,
          "photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
       }]
    ...

Place Photos（従来版）の例

リクエストの例を以下に示します。このリクエストは、参照された画像を返します。このとき、画像の幅が最大 400 ピクセルになるようにサイズが変更されます。

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Place Photos（従来版）のレスポンス

プレイスフォト（以前のバージョン）リクエストが成功した場合のレスポンスは画像です。画像のタイプは、元々送信された写真のタイプによって異なります。

リクエストが使用可能な割り当てを超えると、サーバーは HTTP 403 ステータスを返し、次の画像を表示して割り当てを超過したことを示します。

割り当て超過の画像

サーバーがリクエストを理解できない場合は、無効なリクエストを示す HTTP 400 ステータスが返されます。無効なリクエストの最も一般的な理由は次のとおりです。

  • 提出された写真の参照が正しく指定されていませんでした。
  • リクエストに maxwidth パラメータまたは maxheight パラメータが含まれていません。
  • maxwidth パラメータまたは maxheight パラメータの値が null に設定されました。
  • photo_reference の有効期限が切れています。photo_reference が期限切れになった場合は、Place Details（以前）、Find Place（以前）、Nearby Search（以前）、または Text Search（以前）にリクエストを送信して、更新された photo_reference 値を取得します。