Places API の Gemini モデル機能(新規)により、Places API で LLM がサポートされるため、LLM から提供されるデータとともに、場所に関連付けられたデータ(営業時間、クチコミ、写真)を返すことができます。この生成データには、LLM から集計および要約されたデータが含まれており、すでに場所に関連付けられているデータを補完します。
たとえば、「EV 充電スタンド」の標準のテキスト検索(新規)では、EV 充電サービスを提供する場所のリストが返されます。最寄りの EV 充電器や、車両に対応している最寄りの充電器を検索しているだけの場合は、このタイプのレスポンスで問題ありません。
ただし、特に車両の充電中に 1 時間以上滞在する場合は、充電スタンド周辺の状況を把握しておくこともおすすめします。同じ検索で Gemini モデルの機能を使用すると、レスポンス内の各場所の生成された動的説明(充電スタンド周辺のエリアに関する情報など)がレスポンスに含まれる場合があります。
「徒歩 2 ~ 4 分以内に、Chef Chu's、Gen Korean BBQ House、Amber India、Pacific Catch などの飲食店や、Walmart、Whole Foods Market、Trader Joe's などの複数のスーパーマーケットがあります。」
「徒歩 1 ~ 5 分以内に、Khao Kang Thai Kitchen、Roger's Deli & Donuts、La Costeña など、いくつかの飲食店やショッピング施設があります。寿司なら Joy Sushi がおすすめです。食料品については、Dollar Tree がさまざまな商品を割引価格で提供しています。」
LLM から生成されたこのコンテンツにより、レスポンスが強化され、ユーザーが十分な情報に基づいて判断するための追加情報が提供されます。
AI を活用した新機能が Places API に追加されました(新規)
これらの機能により、Places API(新規)レスポンスに次のデータが追加されます。
特定の場所に関連する生成場所の要約。場所の概要は、Place Details(新)、テキスト検索(新)、Nearby Search(新)でサポートされています。
生成されるエリアのサマリー: 特定の場所の周囲のエリアに関連するもの。エリアの概要は、Place Details(新)、テキスト検索(新)、Nearby Search(新)でサポートされています。
コンテキスト検索 結果はテキスト検索(新版)でサポートされており、場所に直接関連付けられたデータではなく、リクエストで渡された検索文字列に基づくデータが含まれます。このデータは、Text Search(新規)がレスポンスを確定する方法を理解するのに役立ちます。
場所の概要の生成
生成された場所の要約はプレイス ID に固有です。場所の概要は、さまざまな種類のデータを集約して、場所の 1 つの概要にまとめたものです。
Places API(新版)では、次の 2 種類の場所の概要を生成できます。
概要の要約: 場所の簡単な概要(平均約 100 文字)で、ユーザーが場所の概要を把握するのに役立ちます。
Description summary: 場所についての長めのまとめ(平均で約 400 文字)。その場所の主な特徴を網羅した詳細な概要を提供します。
現在、場所の概要は、文化、エンターテイメントとレクリエーション、飲食店、ショッピング、スポーツのカテゴリで、サポートされている種類に表示されている場所の種類で利用できます。
生成されたエリアの概要
生成されたエリアの概要は、場所の周辺エリアに対して LLM によって作成されます。場所のエリアの概要には、ユーザーが意思決定に必要なすべての情報が含まれている場合があります。ユーザーは、エリアの詳細をドリルダウンするために追加のリクエストを行う必要はありません。
レスポンスには、エリアの説明とともに、説明で参照されている場所のプレイス ID のリストと、さまざまなコンテンツ タイプで並べ替えられた場所のリストも含まれます。たとえば、1 つのコンテンツ タイプには、地域内のアクティビティに関連付けられた場所のリストが含まれ、別のコンテンツ タイプには、地域内のレストランのリストが含まれます。
エリアの概要は現在、宿泊施設カテゴリのサポートされているタイプに示されている場所タイプと、特定の場所タイプ electric_vehicle_charging_station
、geocode
、premise
で利用できます。
場所とエリアの要約の生成
生成された場所の概要と生成されたエリアの概要は、どちらも Google によってオフラインで頻繁に生成されます。これらの要約をオフラインで生成することで、Gemini を活用したコンテンツを活用しながら、Places API(新規)で期待されるパフォーマンスを維持できます。
Google は、利用可能な最新の情報に基づいて、これらの概要を頻繁に再生成しています。つまり、API を呼び出すときに、サービスに最新のデータを表示します。
コンテキスト検索結果
Text Search(新版)は、「渋谷 ピザショップ」「表参道 靴店」といった文字列に対して、場所のセットについての情報を返します。テキスト検索(新版)レスポンスには、テキスト文字列と、リクエストで設定された地域バイアスに一致するプレイスのリストが含まれます。
コンテキスト検索結果をレスポンスに追加すると、ユーザーが質問に回答するのに役立つレビュー、写真、根拠がレスポンスに含まれるようになりました。
- 検索結果にこの場所が表示されるのはなぜですか?
- この場所を選択する理由
たとえば、今日、レスポンスに特定のプレイスが含まれる Place Details(新版)、テキスト検索(新版)、または Nearby Search(新版)にリクエストを送信します。返されたデータは場所に関連付けられているため、場所のレスポンス データは 3 つのリクエストですべて同じです。
ただし、新しい機能を使用したテキスト検索(新版)では、入力クエリ文字列自体から取得されたデータがレスポンスに含まれる場合があります。つまり、コンテキスト検索の結果はクエリ文字列に固有のものです。たとえば、次のクエリ文字列を使用して Text Search(新規)リクエストを実行します。
「東京都渋谷区のスパイシーなベジタリアン料理レストラン」
次に、入力パラメータをすべて同じままにして、クエリ文字列を次のように変更します。
「東京都渋谷区のスパイシーなヴィーガン レストラン」
両方のレスポンスに出現するレストランの場合、そのデータは場所自体に関連付けられているため、場所に関するレスポンス データは同じです。一方、コンテキスト検索結果はクエリ文字列から派生するため、クエリに固有のものです。コンテキスト検索結果のクチコミ、写真、根拠をユーザーに表示して、検索リクエストに最も適した場所をユーザーが判断できるようにします。
Places API の Gemini モデル機能を有効にする(新規)
Places API(新版)で Gemini モデルの機能を使用するには、Places API(新版)を有効にする必要があります。詳細については、Google Cloud プロジェクトを設定するをご覧ください。
試験運用版リリースの制限事項
このリリースでは、米国内の場所の場所と地域の概要のみがサポートされています(英語のみ)。
Gemini とは
Gemini モデルの詳細については、Gemini に関するよくある質問をご覧ください。
生成された場所の概要をリクエストする
場所の概要は、特定の場所について LLM によって生成された概要です。Places API(新規)では、レスポンスに次の 2 種類の概要が追加されます。
概要 生成された概要は、場所に関連付けられた静的な編集概要に似ています。生成される短い要約(平均で約 100 文字)には、いくつかの利点があります。
多くの場所には編集者による概要がないため、場所に関する利用可能な情報のギャップを埋めることができます。
LLM から生成されるため、プレイスオーナーがメンテナンスする必要はありません。
説明 - 生成される要約は、Google マップのクチコミなど、さまざまなソースから取得されます。説明は平均で 400 文字程度で、長い説明の生成に使用されたレビューのリストが含まれています。
説明の要約を手動で生成するには、多くの場所からデータを集約し、コンテンツを手作業で作成して管理する必要があります。Places API(新版)向けの Gemini モデル機能により、LLM からこれらの要約が作成され、生成されるコンテンツの範囲と鮮度が維持されます。
場所の概要は、Place Details(新)、テキスト検索(新)、Nearby Search(新)でサポートされています。レスポンスに場所の概要を含めるには、リクエストのフィールド マスクに次のフィールドを含めます。
Place Details:
generativeSummary
テキスト検索と周辺検索:
places.generativeSummary
generativeSummary
フィールドには、次のフィールドがあります。
generativeSummary.overview
: 生成の概要の概要。generativeSummary.description
: 生成された説明の概要。generativeSummary.references
: 最大 5 つのレビューの配列。説明の要約のコンテンツを提供するために使用されます。説明の概要がない場合、この配列は空です。overviewFlagContentUri
: ユーザーが概要の要約に関する問題を報告できるリンク。descriptionFlagContentUri
: ユーザーが説明の概要に関する問題を報告できるリンク。
概要と説明の要約リクエストの例
この例では、places.generativeSummary
のフィールド マスクを使用して、generativeSummary.overview
、generativeSummary.description
、generativeSummary.references
フィールドを含む generativeSummary
オブジェクト全体を返します。
curl -X POST -d '{ "textQuery": "Spicy Vegetarian Food", "location_bias":{ "rectangle":{ "low": { "latitude": 37.415, "longitude": -122.091}, "high":{ "latitude": 37.429, "longitude": -122.065} } }, "maxResultCount": 5 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \ https://places.googleapis.com/v1/places:searchText
レスポンスの形式は次のとおりです。
{ "places": [ { "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts", "displayName": { "text": "Zareen's", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.", "languageCode": "en-US" }, "description": { "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options. Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.", "languageCode": "en-US" }, "references": { "reviews": [ { "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE", "relativePublishTimeDescription": "12 months ago", "rating": 5, "text": { "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!", "languageCode": "en" }, "originalText": { "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!", "languageCode": "en" }, "authorAttribution": { "displayName": "John Smith", "uri": "https://www.google.com/maps/contrib/11685942231/reviews", "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo" }, "publishTime": "2023-05-09T07:24:36Z" "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670" }, . . . ] }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12", "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12" } }, { "id": "ChIJETHw0F-7j4AR85V_I6OobCI", "displayName": { "text": "Hyderabad Dum Biryani", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Indian restaurant offering comfort food including vegetarian and vegan options.", "languageCode": "en-US" }, . . . }
概要の要約リクエストの例
このテキスト検索の例では、カリフォルニア州マウンテンビューのスパイシーなベジタリアン レストランの overview
の概要のみが返されます。
curl -X POST -d '{ "textQuery": "Spicy Vegetarian Food", "location_bias":{ "rectangle":{ "low": { "latitude": 37.415, "longitude": -122.091}, "high":{ "latitude": 37.429, "longitude": -122.065} } }, "maxResultCount": 5 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \ https://places.googleapis.com/v1/places:searchText
レスポンスには、overview.text
と overview.languageCode
を含む generativeSummary.overview
フィールドが含まれます。
{ "places": [ { "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts", "displayName": { "text": "Zareen's", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.", "languageCode": "en-US" } } }, { "id": "ChIJETHw0F-7j4AR85V_I6OobCI", "displayName": { "text": "Hyderabad Dum Biryani", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.", "languageCode": "en-US" } } }, . . . }
生成領域の概要をリクエストする
エリアの概要は、場所の近くのエリアについて LLM によって生成された概要です。エリアの概要は、ユーザーが場所を決める際に重要となる場合があります。
たとえば、新しい都市でホテルを予約しようとしていて、条件を満たすホテルを見つけたうえで、ホテル周辺の地域について詳しく知りたい場合などです。周辺地域の地図を見て、地図上の各場所を調べるのではなく、ホテルの周辺地域の概要を生成できます。
エリアの概要は、Place Details(新版)、Text Search(新版)、Nearby Search(新版) でサポートされています。
レスポンスにエリアの概要を含めるには、リクエストのフィールド マスクに以下を含めます。
areaSummary
(場所の詳細)places.areaSummary
(Text Search と Nearby Search)。
レスポンス内の場所の areaSummary
フィールドには、不適切なコンテンツを報告して Google が削除できるようにする flagContentUri
フィールドが含まれています。また、最大 4 つの contentBlocks
の配列も含まれています。各ブロックのトピックは、場所のタイプに基づいています。
electric_vehicle_charging_station
タイプのプレイスとして定義される EV 充電スタンドの場合、トピック ブロックには"overview"
、"coffee"
、"restaurant"
、"store"
が含まれます。宿泊施設カテゴリで定義された場所のタイプと、特定の場所タイプ
geocode
およびpremise
の場合、トピック ブロックには"overview"
、"activity"
、"restaurant"
、"store"
が含まれます。
EV 充電スタンドのエリア概要のリクエストの例
この Place Details リクエストの例では、プレイス ID ChIJC5b6QKiwj4ARgn2EwlnJnWU
で識別される、マウンテン ビューにある特定の EV 充電スタンドのエリアの概要を返します。
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,areaSummary" \ https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU
レスポンスには、contentBlocks
配列を含む areaSummary
フィールドが含まれます。
topic
フィールドには、コンテンツ ブロックのタイプを指定します。この例の場所は EV 充電スタンドであるため、4 つのコンテンツ ブロックは"overview"
、"coffee"
、"restaurant"
、"store"
です。content
フィールドには、そのトピックの概要(言語コードを含む)が含まれます。references
配列には、コンテンツ ブロックのコンテンツの提供に使用される場所リソース名(places/PLACE_ID
形式)を指定します。
{ "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU", "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "areaSummary": { "contentBlocks": [ { "topic": "overview", "content": { "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY", "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ" ] } }, { "topic": "coffee", "content": { "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY" ] } }, { "topic": "restaurant", "content": { "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ", "places/ChIJETHw0F-7j4AR85V_I6OobCI", "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0", "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk" ] } }, { "topic": "store", "content": { "text": "Safeway provides a range of groceries, along with a deli and a bakery.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12" } }
ホテルのエリアの概要のリクエストの例
次の Text Search リクエストの例では、カリフォルニア州マウンテンビューのホテルをリクエストします。
curl -X POST -d '{ "textQuery": "Hotels", "location_bias":{ "rectangle":{ "low": { "latitude": 37.415, "longitude": -122.091}, "high":{ "latitude": 37.429, "longitude": -122.065} } }, "maxResultCount": 5 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \ https://places.googleapis.com/v1/places:searchText
レスポンスには、contentBlocks
配列を含む areaSummary
フィールドが含まれます。ホテルタイプの場所のレスポンスには、トピック "overview"
、"activity"
、"restaurant"
、"store"
のコンテンツ ブロックが含まれています。
{ "places": [ { "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4", "displayName": { "text": "Shashi Hotel Mountain View, an Urban Resort", "languageCode": "en" }, "areaSummary": { "contentBlocks": [ { "topic": "overview", "content": { "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJOYvCo1W3j4AR1LAifgk13rs", "places/ChIJm7NJkla3j4AR8vR-HWRxgOo", "places/ChIJo4za6vi5j4ARMua093RgGGA", "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU" ] } }, { "topic": "activity", "content": { "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJOYvCo1W3j4AR1LAifgk13rs", "places/ChIJm7NJkla3j4AR8vR-HWRxgOo", "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI" ] } }, { "topic": "restaurant", "content": { "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJC_3cdla3j4ARMgf4Pw8Irek", "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo", "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g" ] } }, { "topic": "store", "content": { "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJh64-r0O3j4ARy1P41IH2j3k", "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12" } }, ... ] }
コンテキスト検索結果をリクエストする
テキスト検索(新版)リクエストのレスポンスには、入力検索文字列の条件に一致する場所の配列が含まれます。これで、API への入力クエリに基づいて、レスポンスでコンテキスト検索データをリクエストできるようになりました。
コンテキスト サマリーをサポートするため、テキスト検索(新規)からのレスポンスには、レスポンスの places
配列と同じレベルに contextualContents
という名前の新しい配列が含まれています。
{ "places": [], "contextualContents":[] }
ContextualContent
型の contextualContents
配列内の各要素は、places
配列内の場所として、対応する配列の場所にあります。つまり、contextualContents[0]
の要素は places[0]
の場所に対応します。
各配列要素には、次の配列フィールドが含まれています。
contextualContents.reviews
: 最大 3 つのレビューの配列。contextualContents.photos
: 最大 5 つの写真の配列。contextualContents.justifications
: 場所の理由の配列。次のものを含む。reviewJustification
: ユーザー レビューの中で、エンドユーザーの関心を引く可能性のあるセクションをハイライト表示します。businessAvailabilityAttributesJustification
: エンドユーザーにとって興味深い可能性があるビジネスの属性が含まれます。
コンテキスト検索結果をレスポンスに含めるには、テキスト検索(新規)リクエストのフィールドマスクに contextualContents
を含めます。
curl -X POST -d '{ "textQuery": "Spicy vegetarian restaurant in Mountain View, CA", "openNow": true, "maxResultCount": 3 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \ https://places.googleapis.com/v1/places:searchText
レスポンスには、レスポンス内の各プレイスに関する contextualContents
配列が含まれます。
{ "places": [ { "id": "ChIJETHw0F-7j4AR85V_I6OobCI", "displayName": { "text": "Hyderabad Dum Biryani", "languageCode": "en" } }, . . . ], "contextualContents": [ { "reviews": [ { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB", "relativePublishTimeDescription": "a year ago", "rating": 5, "text": { "text": "Very tasty! Rich spices and textures. We really appreciated all of the vegan options. We shared samosas (great sauce!) , tofu 65 (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to the tofu 65) and veg pakoras (very crunchy and awesome flavor). We enjoyed all of it, with the pakoras being the table's favorite.", "languageCode": "en" }, "originalText": { "text": "Very tasty! Rich spices and textures. We really appreciated all of the vegan options. We shared samosas (great sauce!) , tofu 65 (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to the tofu 65) and veg pakoras (very crunchy and awesome flavor). We enjoyed all of it, with the pakoras being the table's favorite.", "languageCode": "en" }, "authorAttribution": { "displayName": "Jane Doe", "uri": "https://www.google.com/maps/contrib/113193/reviews", "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100" }, "publishTime": "2023-04-18T02:48:02Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db" }, { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB", "relativePublishTimeDescription": "10 months ago", "rating": 5, "text": { "text": "This is a nice little spot to eat at. I'm a big fan of curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.", "languageCode": "en" }, "originalText": { "text": "This is a nice little spot to eat at. I'm a big fan of curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.", "languageCode": "en" }, "authorAttribution": { "displayName": "Bob Jones", "uri": "https://www.google.com/maps/contrib/11034435/reviews", "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100" }, "publishTime": "2023-07-03T16:51:49Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db" }, . . . ], "photos": [ { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ", "widthPx": 1920, "heightPx": 1080, "authorAttributions": [ { "displayName": "A Google User", "uri": "//maps.google.com/maps/contrib/113010465422", "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo" } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db" }, { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo", "widthPx": 960, "heightPx": 720, "authorAttributions": [ { "displayName": "Toast" } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db" }, . . . ], "justifications": [ { "reviewJustification": { "highlightedText": { "text": "\"Not too spicy or oily.\"", "highlightedTextRanges": [ { "startIndex": 9, "endIndex": 14 } ] }, "review": { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE", "relativePublishTimeDescription": "10 months ago", "rating": 5, "text": { "text": "Not too spicy or oily. We have the mutton dum biryanis and tandoori fish. Very flavorful. The food was served promptly. Clean environment. A little small more like a hole in the wall. We'd come back for sure.", "languageCode": "en" }, "originalText": { "text": "Not too spicy or oily. We have the mutton dum biryanis and tandoori fish. Very flavorful. The food was served promptly. Clean environment. A little small more like a hole in the wall. We'd come back for sure.", "languageCode": "en" }, "authorAttribution": { "displayName": "Stan Davis", "uri": "https://www.google.com/maps/contrib/112959/reviews", "photoUri": "https://lh3.googleuser-cc-rp-mo" }, "publishTime": "2023-06-18T06:12:41Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1", "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db" } } }, { "businessAvailabilityAttributesJustification": { "dineIn": true } } ] }, . . . ] }
自動車ユースケースの実装ガイダンス
ドライバーの安全を確保するため、自動車向けの生成 AI の概要は駐車モードでレンダリングすることをおすすめします。運転モードで概要をレンダリングする場合は、ドライバーの注意がすぐに道路に戻るように、画面上の情報はシンプルで明確かつ簡潔にする必要があります。
- 最大 3 行
- 半角 120 文字(全角 60 文字)以下
- 最小フロントサイズ 24 dp
特に自動車の文脈では、生成 AI の概要を安全に、すべての現地の法律や規制に準拠した方法でレンダリングするのはデベロッパーの責任です。
帰属表示
アプリにレビュー、写真、生成 AI の概要(場所と地域の概要を含む)を表示する場合は、必要な帰属情報も表示する必要があります。
生成された要約のアトリビューションを表示する
アプリに生成 AI サマリー(場所や地域の概要など)を表示する場合は、必要な属性も表示する必要があります。このセクションでは、アプリで生成 AI の概要を表示する方法に基づいて帰属を表示する方法について説明します。
いずれの場合も、帰属表示では大文字と小文字の区別を使用する必要があります。帰属表示と Google ロゴは、すべての色、スタイル、書体基準に準拠している必要があります。これらの標準の詳細については、Places API のポリシー(新規)をご覧ください。
他の Google データのコンテキストで表示される生成 AI の概要
この場合、生成 AI の帰属情報は、概要の上にまたは下に単独で表示できます。他の場所では、コンテンツの Google の帰属情報に依存します。
帰属表示には、次の画像のように「AI による要約」というテキストを使用します。
生成 AI の要約が単独で表示される
生成 AI の概要が Google マップの他のコンテンツとは別に表示される場合は、生成 AI の帰属と Google の帰属の両方を区切り文字で区切って含める必要があります。帰属表示には、次の画像に示すように「AI により要約」というテキストと Google ロゴを使用します。
生成 AI の要約がリスト内で繰り返される
場所のリストで生成 AI の場所の概要を繰り返す場合、次のことを行います。
- リストのコンテンツが Google に帰属している
- 表示される要約は AI によって生成されます
- コンテンツは Google から入手できます
帰属表示は、リストの上部または下部に 1 行で表示する必要があります。AI のアトリビューションは左揃えで、Google のアトリビューションは右揃えです。
リストで長い形式の生成 AI 説明の要約を使用する場合は、各要約に AI の帰属情報(情報アイコン/ボタン付きの「AI による要約」)を指定する必要があります。
生成 AI の要約に関する情報をダイアログに表示する
生成 AI の要約とともに、要約に関する情報を表示するダイアログと、flagContentUri
フィールドに含まれる要約の一意の識別子を使用して問題を報告するためのリンクをエンドユーザーが利用できるようにする必要があります。生成 AI の説明の要約を使用する場合は、要約のソースに関する情報(参照)を含める必要があります。
このダイアログへのアクセスを有効にするには、AI アトリビューション(上記の例を参照)とともに情報アイコン(インタラクティビティのアフォーダンスとして)を含め、AI アトリビューション領域とアイコンを押下/クリックに反応するようにします。
生成された場所の要約の場合は、次のことを表示します。
概要 | AI によるプレイスの概要は、Google のクチコミやその他のデータから生成されます。 |
問題を報告する | 概要の内容に関する問題を Google に報告するには、flagContentUri フィールドに含まれるリンクを使用します。 |
参照 | ソースのレビュー |
例:
生成領域の概要には、次のことを表示します。
概要 | AI によるエリアの概要は、Google のクチコミとローカルデータから生成されます。 |
問題を報告する | 概要の内容に関する問題を Google に報告するには、flagContentUri フィールドに含まれるリンクを使用します。 |