このプロダクトまたは機能は、従来版のステータスです。従来版のステータスの詳細については、従来版のサービスと機能をご覧ください。Places API（新規）に移行するには、移行ガイドをご覧ください。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Place Photos（従来版）

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

注: サーバーサイドとクライアントサイドのライブラリ

Places API は、Google マップサービス向け Java クライアント、Python クライアント、Go クライアント、Node.js クライアントでも利用できます。Places API とクライアントライブラリは、サーバーアプリケーションで使用するためのものです。

JavaScript アプリケーションでこのサービスを使用する場合は、プレイスライブラリ、Maps JavaScript API をご覧ください。

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

Place Photos（以前の機能）リクエスト

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

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

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

必須パラメータ

photo_reference

写真を一意に識別する文字列識別子。写真のリファレンスは、Place Search リクエストまたは Place Details リクエストから返されます。
maxheight または maxwidth

maxheight では、画像の推奨最大高さをピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元の縦横比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。

maxwidth には、画像の最大推奨幅をピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元のアスペクト比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。

maxheight プロパティと maxwidth プロパティはどちらも、1～1600 の整数を受け入れます。

maxheight、maxwidth、またはその両方を指定する必要があります。

写真の参照

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

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

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

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

photo_reference - Place Photos（Legacy）リクエストを実行するときに写真の識別に使用される文字列。
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"
       }]
    ...