場所の写真

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。
プラットフォームを選択: Android iOS JavaScript ウェブサービス

Places Photo サービスの一部である Places Photo サービスは、アプリに高品質な写真コンテンツを追加できる読み取り専用の API です。プレイスフォト サービスを使用すると、プレイス データベースに保存されている数百万の写真を利用できます。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.

Optional parameters

  • 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. Both the maxheight and maxwidth properties accept an integer between 1 and 1600.

  • 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.

Generated from the OpenAPI specification. Edit Report bug

写真のリファレンス

Place Photo サービスに対するすべてのリクエストには、Find Place、Nearby Search、Text Search、Place Details リクエストに対するレスポンスで返される photoreference を含める必要があります。関連する写真コンテンツがある場合、これらのリクエストに対するレスポンスには photos[] フィールドが含まれます。

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

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

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

  • photo_reference - 写真リクエストを行うときに写真を識別するために使用される文字列。
  • height - 画像の最大高。
  • width - 画像の最大幅。
  • html_attributions[] - 必須属性が含まれます。このフィールドは常に存在しますが、空でもかまいません。

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

photos[] 配列の例を以下に示します。

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

場所の写真の例

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

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

場所の写真レスポンス

場所の写真のリクエストが成功すると、レスポンスは画像になります。画像のタイプは、元の写真の種類によって異なります。

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

割り当て超過の画像

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

  • 送信された写真のリファレンスが正しく指定されていません。
  • リクエストに maxwidth パラメータと maxheight パラメータが含まれていませんでした。
  • maxwidth または maxheight パラメータの値が、null に設定されました。