Place Photo (New) サービスは読み取り専用の API であり、 追加することもできます。プレイスフォトサービスでは プレイス データベースに保存された数百万もの写真にアクセスする。
Place Details、Nearby Search、Text Search のいずれかのリクエストで場所の情報を取得する場合、 関連する写真コンテンツ用の写真リソースもリクエストできます。写真サービスを使用すると その後、参照写真にアクセスし、画像を最適なサイズにサイズ変更できます。 説明します。
API Explorer を使用すると、ライブ リクエストを発行できるため、API と API オプション:
試してみるプレイスフォトのリクエスト
プレイスフォト リクエストは、次の形式の URL に対する HTTP GET リクエストです。https://places.googleapis.com/v1/NAME/media?key=API_KEY&PARAMETERS
ここで、次のパラメータが必要です。
- NAME には写真のリソース名が含まれます。
- API_KEY には API キーが格納されます。
- PARAMETERS には、
maxHeightPxパラメータ、maxWidthPxパラメータ、または両方が必要です。
必須パラメータと省略可能なパラメータの完全なリストについては、以下で説明します。
必須パラメータ
写真の名前
写真を一意に識別する文字列 ID。写真名は
Place Details（新版）、Nearby Search（新版）、
またはテキスト検索（新版）リクエスト
photos[] 配列の各要素の name プロパティ。
例については、写真の名前を取得するをご覧ください。
maxHeightPx と maxWidthPx
画像の高さと幅の最大値をピクセル単位で指定します。画像が小さい場合 画像が返されない場合は、元の画像が返されます。どちらかのサイズが大きい場合は、 元のサイズに合わせ、2 つのサイズのうち小さい方に合わせてサイズが変更されます。 アスペクト比。maxheight プロパティと maxwidth プロパティは、どちらも 1 ～ 4800 の整数を受け入れます。
maxHeightPx、maxWidthPx、またはその両方を指定する必要があります。
オプション パラメータ
skipHttpRedirect
false（デフォルト）の場合、画像への HTTP リダイレクトを行い、画像を返します。
true の場合は、リダイレクトをスキップして、画像の詳細を含む JSON レスポンスを返します。
例:
{
"name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/Aaw_FcKly0DEv3EWmDJyHiEqXIP5mowOc99lN1GzBun6KHH52AZ5fFA/media",
"photoUri": "https://lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}
このオプションは、HTTP 以外のリクエストでは無視されます。
写真の名前を取得
プレイスフォト サービスに対するリクエストには、必ず
Nearby Search、Text Search、または
Place Details リクエスト。リクエストに対するレスポンスに photos[] 配列が含まれるのは、
関連する写真コンテンツがあります。
photo[] の各要素には次のフィールドがあります。
name- 追加するときに、写真のリソース名を含む文字列。 リクエストを実行します。この文字列の形式は次のとおりです。places/PLACE_ID/photos/PHOTO_RESOURCE
heightPx- 画像の最大高さ（ピクセル単位）。widthPx- 画像の最大幅（ピクセル単位）。authorAttributions[]- 必要な帰属情報。この フィールドは常に存在しますが、空の場合もあります。
フォトサービスから返される写真は、さまざまな場所から取得されます。
これにはビジネス オーナーやユーザーが投稿した写真も含まれます。ほとんどの場合、
権利帰属表示なしで写真を使用できます。または、帰属情報が必要です。
画像の一部として挿入されますただし、返された photo 要素が
authorAttributions フィールドに値が含まれている場合は、
画像が表示される場所にかかわらず、アプリに帰属情報を追加できます。
次の例は、photos を含む Place Details リクエストを示しています。
レスポンスに photos[] 配列が含まれるように、フィールド マスクを次のように変更します。
curl -X GET \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,photos" \ https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6Eレスポンスの
photos[] 配列の例を以下に示します。
...
"photos" : [
{
"name": "places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1",
"widthPx": 6000,
"heightPx": 4000,
"authorAttributions": [
{
"displayName": "John Smith",
"uri": "//maps.google.com/maps/contrib/101563",
"photoUri": "//lh3.googleusercontent.com/a-/AD_cFT-b=s100-p-k-no-mo"
}
]
}, ...
場所の写真をリクエストする
以下のリクエスト例では、リソース name を使用して画像を返し、次のように画像のサイズを変更しています。
縦と横が 400 ピクセル以下になるようにします。
https://places.googleapis.com/v1/places/ChIJ2fzCmcW7j4AR2JzfXBBoh6E/photos/AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1/media?maxHeightPx=400&maxWidthPx=400&key=API_KEY
レスポンス 画像です。 画像のタイプは、送信された元の写真の種類によって異なります。
リクエストが使用可能な割り当てを超えると、サーバーから HTTP 403 ステータスが返され、割り当てを超過したことを示す以下の画像が表示されます。 超過:
サーバーがリクエストを認識できない場合、HTTP 400 が返されます。 無効なリクエストを示します。エラーの最も一般的な理由は 無効なリクエストの例:
- 送信された写真の名前が正しく指定されていません。
- リクエストに
maxHeightPxまたはmaxWidthPxが含まれていない パラメータを指定します。 maxHeightPxパラメータまたはmaxWidthtPxパラメータの値が設定されている 宛先:nullnameの有効期限が切れています。nameが期限切れになった場合は、 Place Details（新版）、Nearby Search（新版）、 または [テキスト検索（新版）] を選択して 新しいname。
試してみよう:
API Explorer を使用すると、サンプル リクエストを作成して、 API と API オプションに慣れることができます。
リクエストを行うには:
- API アイコン
を選択します。
。 nameパラメータを次のように設定します。places/PLACE_ID/photos/PHOTO_RESOURCE/media
- リクエストが JSON を返すように、
skipHttpRedirectをtrueに設定します。 レスポンスが返されます。デフォルトでは、このリクエストは画像を返します。この画像は、 API Explorer。 - [Execute] ボタンを選択します。ポップアップで、削除するアカウントを選択します。 使用します。
[API Explorer] パネルで、展開アイコンを選択します。
: API Explorer ウィンドウを展開します。