Places API の一部である Place 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.
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
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
写真の参照
Place Photo サービスに対するすべてのリクエストには、Find Place、Nearby Search、Text Search、Place Details のリクエストに対するレスポンスで返される photo_reference
を含める必要があります。場所に関連する写真コンテンツがある場合、これらのリクエストに対するレスポンスには、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" : "AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1"
}
...
場所の写真の例
以下にリクエストの例を示します。このリクエストでは、参照先の画像が返され、幅が 400 ピクセル以下になるようにサイズ変更されます。
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1 &key=YOUR_API_KEY
場所の写真レスポンス
プレイス写真のリクエストが成功すると、レスポンスとして画像が返されます。画像のタイプは、送信された元の写真のタイプによって異なります。
リクエストが利用可能な割り当てを超過すると、サーバーは HTTP 403 ステータスを返し、割り当てを超過したことを示す次の画像を表示します。
サーバーがリクエストを認識できない場合は、HTTP 400 ステータスが返されます。これは、無効なリクエストであることを示します。無効なリクエストの最も一般的な理由は次のとおりです。
- 送信された写真参照が正しく指定されていません。
- リクエストに
maxwidth
パラメータとmaxheight
パラメータのどちらも含まれていませんでした。 maxwidth
パラメータまたはmaxheight
パラメータの値がnull
に設定されている。