場所の写真

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

<ph type="x-smartling-placeholder">

Places API の一部であるプレイスフォト サービスは、 高品質の写真コンテンツを 説明します。Place Photo サービスでは、数百万もの写真にアクセスできます。 プレイス データベースに格納されています。Place API を使用して場所の情報を取得する場合、 詳細をリクエストすると、関連する写真に対して写真参照が返されます 説明します。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.

写真のリファレンス

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

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

  • Find Place、Nearby Search、Text Search の各リクエストで返される photo 要素は 1 つだけです。 繰り返しフィールドがあります
  • 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 が返されます。 無効なリクエストを示します。エラーの最も一般的な理由は 無効なリクエストの例:

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