場所の写真

プラットフォームを選択: Android iOS JavaScript ウェブサービス

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

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

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

Places API の一部である Place Photo サービスは、高品質の写真コンテンツをアプリケーションに追加するための読み取り専用 API です。Place Photo サービスを使用すると、プレイスデータベースに保存されている何百万もの写真にアクセスできます。Place Details リクエストを使用して場所情報を取得すると、関連する写真コンテンツに対して写真参照が返されます。Find Place、Nearby Search、Text Search の各リクエストも、関連する場合、場所ごとに 1 つの写真参照を返します。フォトサービスを使用すると、参照された写真にアクセスし、アプリケーションに最適なサイズに画像のサイズを変更できます。

プレイスフォトのリクエスト

プレイスフォトリクエストは、次の形式の 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 Photo サービスへのすべてのリクエストに photo_reference を含める必要があります。これは、Find Place、Nearby Search、Text Search、Place Details のリクエストに対するレスポンスで返されます。関連する写真コンテンツがある場合、これらのリクエストのレスポンスには photos[] フィールドが含まれます。

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

Find Place、Nearby Search、Text Search の各リクエストは、配列内で最大で 1 つの photo 要素を返します。
Place Details リクエストでは、最大 10 個の photo 要素が返されます。

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

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

フォトサービスから返される写真は、ビジネスオーナーやユーザーが投稿した写真など、さまざまな場所から取得されます。ほとんどの場合、これらの写真は帰属情報なしで使用することも、画像の一部として必要な帰属情報が含まれた形で使用することもできます。ただし、返された 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 Photo の例

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

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

Place Photo の回答

プレイスフォトのリクエストが成功すると、レスポンスとして画像が返されます。画像のタイプは、送信された元の写真のタイプによって異なります。

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

割り当て量の超過を示す画像

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

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