場所の写真

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

</ph> 注: サーバーサイドおよびクライアントサイドのライブラリ

Places API は、 Java クライアント、 Google マップサービス用の Python クライアント、Go クライアント、Node.js クライアントをご覧ください。 Places API とクライアントライブラリは、サーバーアプリケーションで使用されています。

このサービスを JavaScript アプリケーションで使用する場合は、乗るこちらをプレイスライブラリ、Maps JavaScript API

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 が返されます。無効なリクエストを示します。エラーの最も一般的な理由は無効なリクエストの例:

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