Возможности модели Gemini для Places API

Возможности модели Gemini для Places API (новая версия) обеспечивают поддержку LLM в Places API, так что вы можете возвращать данные, связанные с местом (часы работы, отзывы, фотографии), вместе с данными, предоставленными LLM. Эти генеративные данные содержат агрегированные и обобщенные данные из LLM для улучшения данных, уже связанных с местом.

Например, стандартный текстовый поиск (новый) по запросу «Зарядные станции для электромобилей» возвращает список мест, где предлагается зарядка электромобилей. Этот тип ответа подойдет, если вы просто ищете ближайшее зарядное устройство для электромобилей или ближайшее зарядное устройство, совместимое с вашим автомобилем.

Но вам также может потребоваться лучше понять территорию вокруг зарядной станции, особенно если вы собираетесь находиться там час или больше, пока ваш автомобиль заряжается. При использовании возможностей модели 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 улучшает реакцию и предоставляет дополнительную информацию, которая помогает пользователям принять обоснованное решение.

В Places API добавлены новые функции на базе искусственного интеллекта (новинка)

Эти возможности добавляют следующие данные в ответ Places API (новый):

Генеративные описания мест

Генеративные сводки мест относятся к идентификатору места. Сводки по местам объединяют множество различных типов данных в одну сводку по месту.

Places API (новый) предоставляет два типа генеративных сводок мест:

  • Краткое описание : краткий обзор места, в среднем около 100 символов, который может помочь пользователям получить снимок места.

  • Краткое описание : более длинное описание места, в среднем около 400 символов, которое дает подробный обзор, охватывающий основные аспекты этого места.

Сводки мест в настоящее время доступны для типов мест, показанных в разделе «Поддерживаемые типы» для категорий «Культура» , «Развлечения и отдых» , «Еда и напитки» , «Покупки» и «Спорт» .

Резюме генеративной области

Генеративные сводки областей создаются LLM для близлежащей территории вокруг места. Сводная информация о районе для места может содержать всю информацию, необходимую пользователю для принятия решения, без необходимости делать дополнительные запросы для детализации информации о районе.

Помимо описания местности, ответ также содержит список идентификаторов мест, упомянутых в описании, и список мест, отсортированных по различным типам контента. Например, один тип контента содержит список мест, связанных с деятельностью в этом районе, а другой — список ресторанов в этом районе.

Сводные данные по площадям в настоящее время доступны для типов мест, показанных в разделе «Поддерживаемые типы» для категории «Жилье» , а также для конкретных типов мест electric_vehicle_charging_station , geocode и premise .

Создание сводных данных о местах и ​​территориях

Как генеративные сводки мест, так и сводки генеративных областей часто генерируются Google в автономном режиме. Создавая эти сводки в автономном режиме, вы можете воспользоваться преимуществами контента, предоставляемого Gemini, сохраняя при этом ту же производительность API Places (новая), которую вы уже ожидаете.

Google часто обновляет эти сводки, чтобы гарантировать их актуальность на основе последней доступной информации. Это означает, что при вызове API вы будете отображать самые свежие данные в своем сервисе.

Результаты контекстного поиска

Текстовый поиск (новое) возвращает информацию о наборе мест на основе строки — например, «пицца в Нью-Йорке» или «обувные магазины недалеко от Оттавы». Ответ «Текстовый поиск (новый)» содержит список мест, соответствующих текстовой строке, и любые отклонения местоположения, установленные в запросе.

Когда вы добавляете в ответ результаты контекстного поиска, ответ теперь включает обзоры, фотографии и обоснования, которые помогают пользователям отвечать на вопросы:

  • Почему я вижу это место в результатах?
  • Почему я должен выбрать это место?

Например, вы сегодня делаете запрос на информацию о месте (новое), текстовый поиск (новое) или поиск поблизости (новое), который включает в ответ определенное место. Данные ответа для места одинаковы для всех трех запросов, поскольку возвращаемые данные связаны с этим местом.

Однако при текстовом поиске (новом) с использованием новых возможностей ответ может включать данные, полученные из самой входной строки запроса. Это означает, что результаты контекстного поиска уникальны для строки запроса. Например, вы делаете запрос на текстовый поиск (новый) со следующей строкой запроса:

«Острый вегетарианский ресторан в Маунтин-Вью, Калифорния»

Затем вы оставляете все входные параметры прежними и меняете только строку запроса на:

«Пряный веганский ресторан в Маунтин-Вью, Калифорния»

Для ресторана, который появляется в обоих ответах, данные ответа о месте одинаковы, поскольку эти данные связаны с самим местом. Но результаты контекстного поиска уникальны для запроса, поскольку они извлекаются из строки запроса. Затем вы можете отображать отзывы, фотографии и обоснования из результатов контекстного поиска своим пользователям, чтобы помочь им решить, какое место в ответе наиболее применимо к их поисковому запросу.

Включить возможности модели Gemini для Places API (новинка)

Чтобы использовать возможности модели Gemini для Places API (новая версия), необходимо включить Places API (новая версия). Дополнительную информацию см. в разделе Настройка проекта Google Cloud .

Ограничения для экспериментальной версии

В этом выпуске поддерживаются только сводные данные о местах и ​​регионах в США только на английском языке.

Что такое Близнецы?

Дополнительную информацию о модели Gemini см. в разделе Часто задаваемые вопросы о Gemini .

Запросить генеративную сводку места

Сводки мест — это генеративные сводки, созданные LLM для определенного места. Places API (новое) добавляет в ответ два типа сводок:

  • Обзорные генеративные сводки, похожие на статические редакционные сводки, связанные с местом. Генеративные краткие аннотации, в среднем около 100 символов, имеют ряд преимуществ:

    • Во многих местах нет редакционных обзоров, поэтому они заполняют пробел в информации, доступной для места.

    • Они генерируются из LLM, поэтому владельцу места не нужно их поддерживать.

  • Формирующие сводки описаний взяты из многих источников, включая обзоры с Google Maps. Описание, в среднем около 400 символов, включает в себя список отзывов, использованных для создания длинного описания.

    Для создания сводных описаний вручную требуется, чтобы человек агрегировал данные из многих мест, а затем вручную создавал и поддерживал контент. Возможности модели Gemini для Places API (новое) позволяют создавать эти сводки на основе LLM, чтобы поддерживать объем и актуальность создаваемого контента.

Сводки мест поддерживаются функциями «Сведения о месте» (новое) , «Текстовый поиск» (новое) и «Поиск поблизости» (новое) . Чтобы включить в ответ краткую информацию о месте, включите в маску поля запроса следующее поле:

  • Детали места : generativeSummary

  • Текстовый поиск и поиск поблизости : places.generativeSummary

Поле generativeSummary содержит следующие поля:

  • generativeSummary.overview : сводка генеративного обзора.
  • generativeSummary.description : сводка генеративного описания.
  • generativeSummary.references : массив из пяти обзоров, используемый для предоставления содержимого сводного описания. Если сводного описания нет, этот массив пуст.
  • overviewFlagContentUri : ссылка, по которой пользователи могут отметить проблему в сводке обзора.
  • descriptionFlagContentUri : ссылка, по которой пользователи могут отметить проблему со сводкой описания.

Пример запроса сводки обзора и описания

В этом примере используется маска поля places.generativeSummary для возврата всего объекта generativeSummary , включая поля generativeSummary.overview , generativeSummary.description и generativeSummary.references :

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

Ответ содержит поле generativeSummary.overview , которое включает в себя overview.text и overview.languageCode :

{
  "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 для близлежащей области места. Сводная информация о районе может быть важна для пользователей, принимающих решение о том или ином месте.

Например, вы хотите забронировать отель в новом городе и, хотя вы можете найти отель, соответствующий вашим требованиям, вам также хотелось бы узнать больше о районе вокруг отеля. Вместо того, чтобы смотреть на карту окрестностей, а затем исследовать каждое место на карте, вы можете создать краткую информацию о районе отеля.

Сводные данные о районе поддерживаются функциями «Сведения о месте» (новое) , «Текстовый поиск» (новое) и «Поиск поблизости» (новое) .

Чтобы включить в ответ краткую информацию о регионе, включите в маску поля запроса:

  • areaSummary (подробности о месте)
  • places.areaSummary (текстовый поиск и поиск поблизости).

Поле areaSummary для места в ответе содержит поле flagContentUri , которое можно использовать для обозначения недопустимого контента, чтобы Google мог его удалить. Он также содержит массив, содержащий до четырех contentBlocks . Тематика каждого блока зависит от типа места:

  • Для станции зарядки электромобилей, определенной как место типа electric_vehicle_charging_station , тематические блоки включают в себя: "overview" , "coffee" , "restaurant" и "store" .

  • Для места, тип которого определяется категорией «Жилье », а также конкретными типами мест, geocode и premise , блоки тем включают в себя: "overview" , "activity" , "restaurant" и "store" .

Пример запроса на краткую информацию о территории зарядной станции для электромобилей

В этом примере запрос сведений о месте возвращает сводную информацию о районе для конкретной зарядной станции для электромобилей в Маунтин-Вью, идентифицируемой идентификатором места ChIJC5b6QKiwj4ARgn2EwlnJnWU :

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

Ответ содержит поле areaSummary , включая массив contentBlocks :

  • Поле topic указывает тип блока контента. Поскольку местом в этом примере является станция зарядки электромобилей, четырьмя блоками контента являются "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"
  }
}

Пример запроса краткой информации о районе для отеля

В этом примере запроса текстового поиска запрашиваются отели в Маунтин-Вью, Калифорния:

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

Ответ содержит поле areaSummary , включая массив contentBlocks . Ответ для мест типа отель содержит блоки контента по темам "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.

Для поддержки контекстных сводок ответ текстового поиска (новый) содержит новый массив с именем contextualContents на том же уровне, что и массив places в ответе:

{
  "places": [],
  "contextualContents":[]
}

Каждый элемент в массиве contextualContents типа ContextualContent находится в соответствующем месте массива в качестве места в массиве places . То есть элемент contextualContents[0] соответствует месту places[0] .

Каждый элемент массива содержит следующие поля массива:

  • contextualContents.reviews : Массив, содержащий до трех обзоров .
  • contextualContents.photos : Массив до пяти фотографий .

  • 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
          }
        }
      ]
    },
    . . .
  ]
}

Руководство по внедрению для автомобильных сценариев использования

В целях безопасности водителей Google рекомендует отображать генеративные сводки искусственного интеллекта в режиме парковки для автомобильных впечатлений. При отображении сводных данных в режиме вождения информация на экране должна быть простой, четкой и краткой, чтобы обеспечить быстрое возвращение внимания водителя к дороге.

  • Не более 3 строк
  • 120 символов или 24 слова или меньше.
  • Минимальный размер лицевой стороны 24 dp.

Особенно в автомобильном контексте ответственность разработчика заключается в том, чтобы отображать генеративные сводки ИИ безопасными способами и в соответствии со всеми местными законами и правилами.

Атрибуции

Когда вы отображаете в своем приложении обзоры, фотографии и генеративные сводки AI, включая сводки как о местах, так и о регионах, вы должны убедиться, что вы также отображаете необходимую атрибуцию.

Отображение атрибуции для генеративных сводок

Когда вы отображаете в своем приложении сводки генеративного ИИ, включая сводки мест и территорий, вы также должны отображать необходимые атрибуты. В этом разделе описывается, как отображать атрибуцию на основе того, как вы отображаете сводные данные генеративного ИИ в своем приложении.

Во всех случаях при атрибуции необходимо использовать регистр предложений. Атрибуция и логотип Google должны соответствовать всем стандартам цвета, стиля и шрифта. Дополнительную информацию об этих стандартах см. в разделе Политики для Places API (новая версия) .

Сводка по генеративному ИИ отображается в контексте других данных Google.

В этом случае генеративная атрибуция ИИ может отображаться отдельно над или под сводкой, полагаясь на атрибуцию контента Google в другом месте.

Для указания авторства используйте текст «Обобщено AI», как показано на этом изображении:

Для атрибуции используйте текст Summarized by AI.

Сводка по генеративному ИИ отображается изолированно

Когда сводка о генеративном ИИ появляется изолированно от любого другого контента из Карт Google, она должна включать как атрибуцию генеративного ИИ, так и атрибуцию Google, разделенные межпунктом. Для указания авторства используйте текст «Summarized by AI» и логотип Google, как показано на этом изображении:

Для сводки, отображаемой изолированно, включите генеративную атрибуцию ИИ и Атрибуция Google разделена интерпунктом.

Сводка по генеративному ИИ повторяется в списке

При повторении генеративного ИИ поместите краткий обзор в список мест, где все:

  • Содержимое списка принадлежит Google.
  • Показанные сводки созданы искусственным интеллектом.
  • Контент доступен в Google

Атрибуция должна отображаться над или под списком в одну строку. Атрибуция AI выровнена по левому краю, а атрибуция Google — по правому краю:

Для списка отображайте атрибуцию над или под списком в одну строку.

Если в списке используются более длинные сводные описания генеративного ИИ, каждое резюме должно иметь атрибут ИИ («Сводно ИИ» со значком/кнопкой информации).

Отображение информации о генеративной сводке AI в диалоговом окне.

Наряду с генеративной сводкой AI вы должны сделать доступным для конечных пользователей диалоговое окно, в котором отображается информация о сводке, а также ссылку для сообщения о проблемах с использованием уникального идентификатора сводки, содержащегося в поле flagContentUri . При использовании резюме описания генеративного ИИ необходимо включать информацию об источниках резюме, называемых ссылками .

Включите доступ к этому диалоговому окну, включив значок информации (как возможность интерактивности) в сочетании с атрибуцией ИИ (как показано в приведенных выше примерах) и заставив область атрибуции ИИ и значок реагировать на нажатие/щелчок.

Для создания сводок мест отобразите:

О Сводки мест с помощью искусственного интеллекта генерируются на основе обзоров Google и других данных.
Сообщить о проблеме Чтобы сообщить в Google о проблеме с содержанием сводки, используйте ссылку, содержащуюся в поле flagContentUri .
Ссылки Источники отзывов

Например:

Отображение информации о генеративной сводке AI в диалоговом окне.

Для сводки генеративной области отобразите:

О Сводные данные по области ИИ создаются на основе обзоров Google и местных данных.
Сообщить о проблеме Чтобы сообщить в Google о проблеме с содержанием сводки, используйте ссылку, содержащуюся в поле flagContentUri .

Сводная атрибуция области отображения.

,

Возможности модели Gemini для Places API (новая версия) обеспечивают поддержку LLM в Places API, так что вы можете возвращать данные, связанные с местом (часы работы, отзывы, фотографии), вместе с данными, предоставленными LLM. Эти генеративные данные содержат агрегированные и обобщенные данные из LLM для улучшения данных, уже связанных с местом.

Например, стандартный текстовый поиск (новый) по запросу «Зарядные станции для электромобилей» возвращает список мест, где предлагается зарядка электромобилей. Этот тип ответа подойдет, если вы просто ищете ближайшее зарядное устройство для электромобилей или ближайшее зарядное устройство, совместимое с вашим автомобилем.

Но вам также может потребоваться лучше понять территорию вокруг зарядной станции, особенно если вы собираетесь находиться там час или больше, пока ваш автомобиль заряжается. При использовании возможностей модели 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 улучшает реакцию и предоставляет дополнительную информацию, которая помогает пользователям принять обоснованное решение.

В Places API добавлены новые функции на базе искусственного интеллекта (новинка)

Эти возможности добавляют следующие данные в ответ Places API (новый):

Генеративные описания мест

Генеративные сводки мест относятся к идентификатору места. Сводки по местам объединяют множество различных типов данных в одну сводку по месту.

Places API (новый) предоставляет два типа генеративных сводок мест:

  • Краткое описание : краткий обзор места, в среднем около 100 символов, который может помочь пользователям получить снимок места.

  • Краткое описание : более длинное описание места, в среднем около 400 символов, которое дает подробный обзор, охватывающий основные аспекты этого места.

Сводки мест в настоящее время доступны для типов мест, показанных в разделе «Поддерживаемые типы» для категорий «Культура» , «Развлечения и отдых» , «Еда и напитки» , «Покупки» и «Спорт» .

Резюме генеративной области

Генеративные сводки областей создаются LLM для близлежащей территории вокруг места. Сводная информация о районе для места может содержать всю информацию, необходимую пользователю для принятия решения, без необходимости делать дополнительные запросы для детализации информации о районе.

Помимо описания местности, ответ также содержит список идентификаторов мест, упомянутых в описании, и список мест, отсортированных по различным типам контента. Например, один тип контента содержит список мест, связанных с деятельностью в этом районе, а другой — список ресторанов в этом районе.

Сводные данные по площадям в настоящее время доступны для типов мест, показанных в разделе «Поддерживаемые типы» для категории «Жилье» , а также для конкретных типов мест electric_vehicle_charging_station , geocode и premise .

Создание сводных данных о местах и ​​территориях

Как генеративные сводки мест, так и сводки генеративных областей часто генерируются Google в автономном режиме. Создавая эти сводки в автономном режиме, вы можете воспользоваться преимуществами контента, предоставляемого Gemini, сохраняя при этом ту же производительность API Places (новая), которую вы уже ожидаете.

Google часто обновляет эти сводки, чтобы гарантировать их актуальность на основе последней доступной информации. Это означает, что при вызове API вы будете отображать самые свежие данные в своем сервисе.

Результаты контекстного поиска

Текстовый поиск (новое) возвращает информацию о наборе мест на основе строки — например, «пицца в Нью-Йорке» или «обувные магазины недалеко от Оттавы». Ответ «Текстовый поиск (новый)» содержит список мест, соответствующих текстовой строке, и любые отклонения местоположения, установленные в запросе.

Когда вы добавляете в ответ результаты контекстного поиска, ответ теперь включает обзоры, фотографии и обоснования, которые помогают пользователям отвечать на вопросы:

  • Почему я вижу это место в результатах?
  • Почему я должен выбрать это место?

Например, вы сегодня делаете запрос на информацию о месте (новое), текстовый поиск (новое) или поиск поблизости (новое), который включает в ответ определенное место. Данные ответа для места одинаковы для всех трех запросов, поскольку возвращаемые данные связаны с этим местом.

Однако при текстовом поиске (новом) с использованием новых возможностей ответ может включать данные, полученные из самой входной строки запроса. Это означает, что результаты контекстного поиска уникальны для строки запроса. Например, вы делаете запрос на текстовый поиск (новый) со следующей строкой запроса:

«Острый вегетарианский ресторан в Маунтин-Вью, Калифорния»

Затем вы оставляете все входные параметры прежними и меняете только строку запроса на:

«Пряный веганский ресторан в Маунтин-Вью, Калифорния»

Для ресторана, который появляется в обоих ответах, данные ответа о месте одинаковы, поскольку эти данные связаны с самим местом. Но результаты контекстного поиска уникальны для запроса, поскольку они извлекаются из строки запроса. Затем вы можете отображать отзывы, фотографии и обоснования из результатов контекстного поиска своим пользователям, чтобы помочь им решить, какое место в ответе наиболее применимо к их поисковому запросу.

Включить возможности модели Gemini для Places API (новинка)

Чтобы использовать возможности модели Gemini для Places API (новая версия), необходимо включить Places API (новая версия). Дополнительную информацию см. в разделе Настройка проекта Google Cloud .

Ограничения для экспериментальной версии

В этом выпуске поддерживаются только сводные данные о местах и ​​регионах в США только на английском языке.

Что такое Близнецы?

Дополнительную информацию о модели Gemini см. в разделе Часто задаваемые вопросы о Gemini .

Запросить генеративную сводку места

Сводки мест — это генеративные сводки, созданные LLM для определенного места. Places API (новое) добавляет в ответ два типа сводок:

  • Обзорные генеративные сводки, похожие на статические редакционные сводки, связанные с местом. Генеративные краткие аннотации, в среднем около 100 символов, имеют ряд преимуществ:

    • Во многих местах нет редакционных обзоров, поэтому они заполняют пробел в информации, доступной для места.

    • Они генерируются из LLM, поэтому владельцу места не нужно их поддерживать.

  • Формирующие сводки описаний взяты из многих источников, включая обзоры с Google Maps. Описание, в среднем около 400 символов, включает в себя список отзывов, использованных для создания длинного описания.

    Для создания сводных описаний вручную требуется, чтобы человек агрегировал данные из многих мест, а затем вручную создавал и поддерживал контент. Возможности модели Gemini для Places API (новое) позволяют создавать эти сводки на основе LLM, чтобы поддерживать объем и актуальность создаваемого контента.

Сводки мест поддерживаются функциями «Сведения о месте» (новое) , «Текстовый поиск» (новое) и «Поиск поблизости» (новое) . Чтобы включить в ответ краткую информацию о месте, включите в маску поля запроса следующее поле:

  • Детали места : generativeSummary

  • Текстовый поиск и поиск поблизости : places.generativeSummary

Поле generativeSummary содержит следующие поля:

  • generativeSummary.overview : сводка генеративного обзора.
  • generativeSummary.description : сводка генеративного описания.
  • generativeSummary.references : массив из пяти обзоров, используемый для предоставления содержимого сводного описания. Если сводного описания нет, этот массив пуст.
  • overviewFlagContentUri : ссылка, по которой пользователи могут отметить проблему в сводке обзора.
  • descriptionFlagContentUri : ссылка, по которой пользователи могут отметить проблему со сводкой описания.

Пример запроса сводки обзора и описания

В этом примере используется маска поля places.generativeSummary для возврата всего объекта generativeSummary , включая поля generativeSummary.overview , generativeSummary.description и generativeSummary.references :

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

Ответ содержит поле generativeSummary.overview , которое включает в себя overview.text и overview.languageCode :

{
  "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 для близлежащей области места. Сводная информация о районе может быть важна для пользователей, принимающих решение о том или ином месте.

Например, вы хотите забронировать отель в новом городе и, хотя вы можете найти отель, отвечающий вашим требованиям, вам также хотелось бы узнать больше о районе вокруг отеля. Вместо того, чтобы смотреть на карту окрестностей, а затем исследовать каждое место на карте, вы можете создать краткую информацию о районе отеля.

Сводные данные о районе поддерживаются функциями «Сведения о месте» (новое) , «Текстовый поиск» (новое) и «Поиск поблизости» (новое) .

Чтобы включить в ответ краткую информацию о регионе, включите в маску поля запроса:

  • areaSummary (подробности о месте)
  • places.areaSummary (текстовый поиск и поиск поблизости).

Поле areaSummary для места в ответе содержит поле flagContentUri , которое можно использовать для обозначения недопустимого контента, чтобы Google мог его удалить. Он также содержит массив, содержащий до четырех contentBlocks . Тематика каждого блока зависит от типа места:

  • Для станции зарядки электромобилей, определенной как место типа electric_vehicle_charging_station , тематические блоки включают в себя: "overview" , "coffee" , "restaurant" и "store" .

  • Для места, тип которого определяется категорией «Жилье », а также конкретными типами мест, geocode и premise , блоки тем включают в себя: "overview" , "activity" , "restaurant" и "store" .

Пример запроса на краткую информацию о территории зарядной станции для электромобилей

В этом примере запрос сведений о месте возвращает сводную информацию о районе для конкретной зарядной станции для электромобилей в Маунтин-Вью, идентифицируемой идентификатором места ChIJC5b6QKiwj4ARgn2EwlnJnWU :

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

Ответ содержит поле areaSummary , включая массив contentBlocks :

  • Поле topic указывает тип блока контента. Поскольку местом в этом примере является станция зарядки электромобилей, четырьмя блоками контента являются "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"
  }
}

Пример запроса краткой информации о районе для отеля

В этом примере запроса текстового поиска запрашиваются отели в Маунтин-Вью, Калифорния:

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

Ответ содержит поле areaSummary , включая массив contentBlocks . Ответ для мест типа отель содержит блоки контента по темам "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.

Для поддержки контекстных сводок ответ текстового поиска (новый) содержит новый массив с именем contextualContents на том же уровне, что и массив places в ответе:

{
  "places": [],
  "contextualContents":[]
}

Каждый элемент массива contextualContents типа ContextualContent находится в соответствующем месте массива в качестве места в массиве places . То есть элемент contextualContents[0] соответствует месту places[0] .

Каждый элемент массива содержит следующие поля массива:

  • contextualContents.reviews : Массив, содержащий до трех обзоров .
  • contextualContents.photos : Массив до пяти фотографий .

  • 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
          }
        }
      ]
    },
    . . .
  ]
}

Руководство по реализации для автомобильных вариантов использования

Для безопасности водителя Google рекомендует отображать генеративные резюме ИИ в припаркованном режиме для автомобильного опыта. Если в режиме вождения в режиме вождения информация на экране должна быть простой, ясной и краткой, чтобы убедиться, что внимание водителя быстро вернется на дорогу.

  • Не более 3 строк
  • 120 символов или 24 слова или меньше
  • Минимальный размер переднего размера 24 д.

Особенно в автомобильном контексте, это обязанность разработчика за то, чтобы сделать генеративные резюме ИИ способами, которые безопасны и соответствуют всем местным законам и правилам.

Атрибуты

Когда вы отображаете отзывы, фотографии и генеративные резюме ИИ в вашем приложении, включая как места, так и резюме области, вы должны убедиться, что вы также отображаете необходимые атрибуты.

Отображать атрибуции для генеративных резюме

Когда вы отображаете генеративные резюме ИИ в вашем приложении, включая резюме по месту и области, вы также должны отобразить необходимые атрибуты. В этом разделе описывается, как отображать атрибуты в зависимости от того, как вы отображаете генеративные резюме ИИ в вашем приложении.

Во всех случаях атрибуция должна использовать корпус предложений. Атрибуция и логотип Google должны соответствовать всем стандартам цвета, стиля и шрифтов. Для получения дополнительной информации об этих стандартах см. Политики для мест API (новый) .

Генеративное резюме ИИ отображается в контексте других данных Google

В этом случае генеративная атрибуция искусственного интеллекта может отображаться отдельно выше или ниже резюме, полагаясь на атрибуцию Google контента в других местах.

Для атрибуции используйте текст «суммированный AI», как показано на этом изображении:

Для атрибуции используйте текст, обобщенный AI.

Генеративное резюме ИИ отображается в изоляции

Когда генеративное резюме ИИ появляется в изоляции любого другого контента от карт Google, оно должно включать как генеративную атрибуцию ИИ, так и атрибуцию к Google, разделенному в результате взаимодействия. Для атрибуции используйте текст «суммированный AI» и логотип Google, как показано на этом изображении:

Для резюме, отображаемого в изоляции, включают генеративную атрибуцию ИИ и Атрибуция Google, разделенная внедорожным.

Генеративное резюме ИИ повторяется в списке

Повторяя обзор сводного обзора генеративного места в списке мест, где все:

  • Содержание списка приписывается Google
  • Показанные резюме созданы ИИ
  • Контент доступен в Google

Атрибуция должна отображаться выше или ниже списка на одной строке. Атрибуция ИИ является выровнением левой стороны, а атрибуция Google выровняется:

Для списка отображение атрибуции выше или ниже списка на одной строке.

Если в списке используются краткие сведения о генеративном образовании ИИ, в списке каждое резюме должна иметь атрибуцию ИИ («суммировано с помощью ИИ» с помощью значка/кнопки информации).

Показать информацию о генеративном резюме ИИ в диалоге

Наряду с генеративным резюме ИИ, вы должны сделать диалог, доступный для конечных пользователей, которые отображают информацию о резюме, и ссылку для сообщений о проблемах с использованием уникального идентификатора резюме, содержащегося в поле flagContentUri . При использовании генеративного резюме описания ИИ вы должны включить информацию об источниках резюме, называемую ссылками .

Включите доступ к этому диалогу, включив значок информации (в качестве предоставления интерактивности) в сочетании с атрибуцией искусственного интеллекта (как показано в приведенных выше примерах) и создание области атрибуции ИИ и значка реагировать на нажжение/щелчок.

Для генеративных резюме места отображение:

О Резюме AI Place генерируются из обзоров Google и других данных.
Сообщить о проблеме Чтобы сообщить о проблеме Google о содержании резюме, используйте ссылку, содержащуюся в поле flagContentUri .
Ссылки Обзоры источников

Например:

Отображение информации о генеративном резюме ИИ в диалоговом окне.

Для резюме генеративной зоны отображение:

О Резюме области ИИ генерируются из обзоров Google и локальных данных.
Сообщить о проблеме Чтобы сообщить о проблеме Google о содержании резюме, используйте ссылку, содержащуюся в поле flagContentUri .

Сводная атрибуция площади отображения.

,

Возможности модели Gemini для Places API (новый) обеспечивает поддержку LLMS в API Place, чтобы вы могли вернуть данные, связанные с местом (часы работы, обзоры, фотографии) вместе с данными, предоставленными LLMS. Эти генеративные данные содержат агрегированные и суммированные данные из LLMS для улучшения данных, уже связанных с местом.

Например, стандартный текстовый поиск (новый) для "EV -зарядных станций" возвращает список мест, которые предлагают зарядку EV. Этот тип ответа в порядке, если вы просто ищете ближайшее зарядное устройство EV или ближайшее, совместимое с вашим автомобилем.

Но вы также можете лучше понять область вокруг зарядной станции, особенно если вы собираетесь быть там в течение часа или более, пока ваш автомобиль взимает. При использовании возможностей модели Близнецов для того же поиска ответ может содержать динамические, генеративные описания каждого места в ответе, включая информацию о области вокруг зарядной станции:

  • «В течение 2-4-минутной прогулки есть несколько вариантов столовой и покупок, в том числе шеф-повара Чу, Gen Korean Bbq House, Amber India, Pacific Catch и несколько продуктовых магазинов, таких как Walmart, Whole Foods Market и Trader Joe's».

  • «В течение 1-5-минутной прогулки есть несколько вариантов столовой и покупок, в том числе Khao Kang Thai Kitchen, Deli & Donuts Roger, а также La Costeña. Для Sushi Joy Sushi-хороший вариант. Для продуктов, Dollar Tree предлагает разнообразные продукты по дисконтным ценам».

Этот генеративный контент из LLMS улучшает ответ и предоставляет дополнительную информацию, чтобы помочь пользователям принять обоснованное решение.

Новые функции с AI, добавленные в API Places (новый)

Эти возможности добавляют следующие данные в ответ API (новый):

Генеративные резюме места

Генеративные резюме места являются специфичными для идентификатора места. Установите резюме, объединяйте множество различных типов данных в одну резюме для этого места.

Места API (новый) предоставляет два типа генеративных резюме места:

  • Обзор Сводка : Краткий обзор места, в среднем около 100 символов, которое может помочь пользователям получить снимок места.

  • Описание Резюме : более длинные резюме места, в среднем около 400 символов, которые предоставляют подробный обзор, охватывающий главные аспекты этого места.

В настоящее время доступно для типов мест, показанных в поддерживаемых типах для категорий культуры , развлечений и отдыха , еды и напитков , покупок и спорта .

Генеративные резюме

Резюме генеративной площади создаются LLM для близлежащей области вокруг места. Краткое изложение области для места может содержать всю информацию, необходимую пользователю, чтобы принять решение, если пользователь должен сделать дополнительные запросы, чтобы свернуть в детали области.

Наряду с описанием области, ответ также содержит список идентификаторов места для мест, упомянутых в описании, и список мест, отсортированных по различным типам контента. Например, один тип контента содержит список мест, связанных с действиями в этом районе, а другой содержит список ресторанов в этом районе.

Резюме площадей в настоящее время доступны для типов мест, показанных в поддерживаемых типах для категории жилья , а также для конкретных типов мест electric_vehicle_charging_station , geocode и premise .

Генерация расписания и зоны

Как генеративные резюме места, так и резюме генеративной области генерируются в автономном режиме часто Google. Генерируя эти резюме в автономном режиме, вы можете воспользоваться контентом, питаемым Близнецами, в то же время видя такую ​​же производительность из API (нового), которые вы уже ожидаете.

Google часто восстанавливает эти резюме, чтобы гарантировать, что они свежи на основе последней доступной информации. Это означает, что вы будете отображать самые свежие данные в своем сервисе при вызове API.

Результаты контекстуального поиска

Текстовый поиск (новый) возвращает информацию о наборе мест, основанных на строке - например, «Пицца в Нью -Йорке» или «Обу обувные магазины возле Оттавы». Ответ текстового поиска (новый) содержит список мест, соответствующих текстовой строке, и любого смещения местоположения, установленного в запросе.

Когда вы добавляете результаты контекстуального поиска в ответ, ответ теперь включает в себя обзоры, фотографии и оправдания, которые помогают пользователям ответить на вопросы:

  • Почему я вижу это место в результатах?
  • Почему я должен выбрать это место?

Например, вы делаете запрос, чтобы разместить подробности (новый), текстовый поиск (новый) или ближайший поиск (новый) сегодня, который включает в себя конкретное место в ответе. Данные ответа для этого места одинаковы для всех трех запросов, поскольку возвращаемые данные связаны с этим местом.

Однако для текстового поиска (нового) с использованием новых возможностей ответ может включать данные, полученные из самой строки запроса ввода. Это означает, что результаты контекстуального поиска уникальны для строки запроса. Например, вы делаете запрос на текстовый поиск (новый) со следующей строкой запроса:

"Острый вегетарианский ресторан в Маунтин -Вью, Калифорния"

Затем вы оставляете все входные параметры одинаковыми и только измените строку запроса на:

"Острый веганский ресторан в Маунтин -Вью, Калифорния"

Для ресторана, который появляется в обоих ответах, данные ответа о месте одинаковы, потому что эти данные связаны с самим местом. Но результаты контекстуального поиска уникальны для запроса, потому что они получены из строки запроса. Затем вы можете отобразить отзывы, фотографии и оправдания от результатов контекстуального поиска до ваших пользователей, чтобы помочь им решить, какое место в ответе наиболее применимо к их запросу на поиск.

Включить возможности модели Близнецов для мест API (новый)

Вы должны позволить местам API (новым) использовать возможности модели Близнецов для мест API (новый). Для получения дополнительной информации см. Настройка вашего Google Cloud Project .

Ограничения для экспериментального выпуска

Этот релиз поддерживает только места для места и зоны для мест в Соединенных Штатах только на английском языке.

Что такое Близнецы?

Чтобы узнать о модели Близнецов, см. FAQ Близнецов .

Запросить сводку с генеративным местом

Краткое сооружение - это генеративные резюме, созданные LLM для определенного места. Размещает API (новый) добавляет два типа резюме в ответ:

  • Обзор генеративных резюме, которые похожи на статическую редакционную сумму, связанную с местом. Генеративные краткие резюме, в среднем около 100 символов, имеют несколько преимуществ:

    • Во многих местах нет редакционных резюме, поэтому они заполняют пробел в информации, доступной для места.

    • Они генерируются из LLM, поэтому владельцу места не нужно сохранить их.

  • Описание Генеративные резюме получены из многих источников, включая отзывы от Google Maps. Описание, в среднем около 400 символов, включает в себя список обзоров, используемых для создания длинного описания.

    Для создания описания резюме вручную требуется, чтобы человек собирал данные из многих мест, а затем вручную и поддержал содержание. Возможности модели Gemini для Places API (New) создают эти резюме из LLMS, чтобы сохранить объем и свежесть сгенерированного контента.

Резюме места поддерживаются сведениями о месте (новое) , текстовый поиск (новый) и близлежащий поиск (новый) . Чтобы включить сводку места в ответ, включите следующее поле в полевой маски запроса:

  • Детали размещения : generativeSummary

  • Поиск текста и поблизости поиск : places.generativeSummary

Поле generativeSummary содержит следующие поля:

  • generativeSummary.overview : Генеративное обзор резюме.
  • generativeSummary.description : Генеративное описание резюме.
  • generativeSummary.references : массив из пяти обзоров, используемых для предоставления контента для краткого описания. Если нет краткого описания, этот массив пуст.
  • overviewFlagContentUri : ссылка, в которой пользователи могут пометить проблему с обзором.
  • descriptionFlagContentUri : ссылка, в которой пользователи могут пометить проблему с краткой описанием.

Пример обзора и описание сводного запроса

В этом примере используется полевая маска places.generativeSummary GenerativeMary, чтобы вернуть весь объект generativeSummary , включая generativeSummary.overview , generativeSummary.description и generativeSummary.references Fields:

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

Ответ содержит поле generativeSummary.overview , которое включает в себя overview.text и overview.languageCode :

{
  "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 для близлежащей области места. Резюме области могут быть важны для пользователей, принимающих решение о месте.

Например, вы хотите забронировать отель в новом городе, и хотя вы можете найти отель, который соответствует вашим требованиям, вы также хотели бы узнать больше о районе вокруг отеля. Вместо того, чтобы смотреть на карту окрестностей, а затем исследовать каждое место на карте, вы можете вместо этого генерировать резюме для отеля.

Резюме области поддерживаются сведениями о месте (новое) , поиск текста (новый) и близлежащий поиск (новый) .

Чтобы включить резюме в ответ в ответ, включите в полевую маску запроса:

  • areaSummary (детали размещения)
  • places.areaSummary (текстовый поиск и близлежащий поиск).

areaSummary поля для места для места в ответе содержит поле flagContentUri , которое вы можете использовать для помещения неподходящего контента, чтобы Google мог его удалить. Он также содержит массив до четырех contentBlocks . Тема для каждого блока основана на типе места:

  • Для зарядной станции EV, определяемой как место типа electric_vehicle_charging_station , тематические блоки включают в себя: "overview" , "coffee" , "restaurant" и "store" .

  • Для места с типом, определенным категорией жилья , и конкретными типами мест geocode and premise , тематические блоки включают в себя: "overview" , "activity" , "restaurant" и "store" .

Пример запроса на резюме зоны зарядной станции EV

В этом примере запрос сведений о том, что данные о том, что сведения возвращает резюме для конкретной зарядной станции EV в Mountain View, идентифицированном ID места ChIJC5b6QKiwj4ARgn2EwlnJnWU :

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

Ответ содержит areaSummary , в том числе массив contentBlocks :

  • Поле topic указывает тип блока контента. Поскольку место в этом примере является зарядной станцией EV, четыре блока контента - "overview" , "coffee" , "restaurant" и "store" .

  • Поле content включает в себя резюме для этой темы, включая языковой код.

  • В массиве references указывается имена ресурсов Place в 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"
  }
}

Пример запроса на резюме области для отеля

В этом примере запросы на запрос на поиск текстового поиска отелей в Маунтин -Вью, Калифорния:

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

Ответ содержит areaSummary , в том числе массив contentBlocks . Ответ для мест отеля типа содержит блоки контента для тем, "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.

Для поддержки контекстуальных резюме ответ от текстового поиска (новый) содержит новый массив с именем contextualContents на том же уровне, что и в ответе массивы places :

{
  "places": [],
  "contextualContents":[]
}

Каждый элемент в массиве contextualContents , типа ContextualContent , находится в соответствующем месте массива в качестве места в массиве places . То есть элемент в contextualContents[0] соответствует месту в places[0] .

Каждый элемент массива содержит следующие поля массива:

  • contextualContents.reviews : массив из трех обзоров .
  • contextualContents.photos : массив из пяти фотографий .

  • 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
          }
        }
      ]
    },
    . . .
  ]
}

Руководство по реализации для автомобильных вариантов использования

Для безопасности водителя Google рекомендует отображать генеративные резюме ИИ в припаркованном режиме для автомобильного опыта. Если в режиме вождения в режиме вождения информация на экране должна быть простой, ясной и краткой, чтобы убедиться, что внимание водителя быстро вернется на дорогу.

  • Не более 3 строк
  • 120 символов или 24 слова или меньше
  • Минимальный размер переднего размера 24 д.

Особенно в автомобильном контексте, это обязанность разработчика за то, чтобы сделать генеративные резюме ИИ способами, которые безопасны и соответствуют всем местным законам и правилам.

Атрибуты

Когда вы отображаете отзывы, фотографии и генеративные резюме ИИ в вашем приложении, включая как места, так и резюме области, вы должны убедиться, что вы также отображаете необходимые атрибуты.

Отображать атрибуции для генеративных резюме

Когда вы отображаете генеративные резюме ИИ в вашем приложении, включая резюме по месту и области, вы также должны отобразить необходимые атрибуты. В этом разделе описывается, как отображать атрибуты в зависимости от того, как вы отображаете генеративные резюме ИИ в вашем приложении.

Во всех случаях атрибуция должна использовать корпус предложений. Атрибуция и логотип Google должны соответствовать всем стандартам цвета, стиля и шрифтов. Для получения дополнительной информации об этих стандартах см. Политики для мест API (новый) .

Генеративное резюме ИИ отображается в контексте других данных Google

В этом случае генеративная атрибуция искусственного интеллекта может отображаться отдельно выше или ниже резюме, полагаясь на атрибуцию Google контента в других местах.

Для атрибуции используйте текст «суммированный AI», как показано на этом изображении:

Для атрибуции используйте текст, обобщенный AI.

Генеративное резюме ИИ отображается в изоляции

Когда генеративное резюме ИИ появляется в изоляции любого другого контента от карт Google, оно должно включать как генеративную атрибуцию ИИ, так и атрибуцию к Google, разделенному в результате взаимодействия. Для атрибуции используйте текст «суммированный AI» и логотип Google, как показано на этом изображении:

Для резюме, отображаемого в изоляции, включают генеративную атрибуцию ИИ и Атрибуция Google, разделенная внедорожным.

Генеративное резюме ИИ повторяется в списке

Повторяя обзор сводного обзора генеративного места в списке мест, где все:

  • Содержание списка приписывается Google
  • Показанные резюме созданы ИИ
  • Контент доступен в Google

Атрибуция должна отображаться выше или ниже списка на одной строке. Атрибуция ИИ является выровнением левой стороны, а атрибуция Google выровняется:

Для списка отображение атрибуции выше или ниже списка на одной строке.

Если в списке используются краткие сведения о генеративном образовании ИИ, в списке каждое резюме должна иметь атрибуцию ИИ («суммировано с помощью ИИ» с помощью значка/кнопки информации).

Показать информацию о генеративном резюме ИИ в диалоге

Наряду с генеративным резюме ИИ, вы должны сделать диалог, доступный для конечных пользователей, которые отображают информацию о резюме, и ссылку для сообщений о проблемах с использованием уникального идентификатора резюме, содержащегося в поле flagContentUri . При использовании генеративного резюме описания ИИ вы должны включить информацию об источниках резюме, называемую ссылками .

Включите доступ к этому диалогу, включив значок информации (в качестве предоставления интерактивности) в сочетании с атрибуцией искусственного интеллекта (как показано в приведенных выше примерах) и создание области атрибуции ИИ и значка реагировать на нажжение/щелчок.

Для генеративных резюме места отображение:

О Резюме AI Place генерируются из обзоров Google и других данных.
Сообщить о проблеме Чтобы сообщить о проблеме Google о содержании резюме, используйте ссылку, содержащуюся в поле flagContentUri .
Ссылки Обзоры источников

Например:

Отображение информации о генеративном резюме ИИ в диалоговом окне.

Для резюме генеративной зоны отображение:

О Резюме области ИИ генерируются из обзоров Google и локальных данных.
Сообщить о проблеме Чтобы сообщить о проблеме Google о содержании резюме, используйте ссылку, содержащуюся в поле flagContentUri .

Сводная атрибуция площади отображения.

,

Возможности модели Gemini для Places API (новый) обеспечивает поддержку LLMS в API Place, чтобы вы могли вернуть данные, связанные с местом (часы работы, обзоры, фотографии) вместе с данными, предоставленными LLMS. Эти генеративные данные содержат агрегированные и суммированные данные из LLMS для улучшения данных, уже связанных с местом.

Например, стандартный текстовый поиск (новый) для "EV -зарядных станций" возвращает список мест, которые предлагают зарядку EV. Этот тип ответа в порядке, если вы просто ищете ближайшее зарядное устройство EV или ближайшее, совместимое с вашим автомобилем.

Но вы также можете лучше понять область вокруг зарядной станции, особенно если вы собираетесь быть там в течение часа или более, пока ваш автомобиль взимает. При использовании возможностей модели Близнецов для того же поиска ответ может содержать динамические, генеративные описания каждого места в ответе, включая информацию о области вокруг зарядной станции:

  • «В течение 2-4-минутной прогулки есть несколько вариантов столовой и покупок, в том числе шеф-повара Чу, Gen Korean Bbq House, Amber India, Pacific Catch и несколько продуктовых магазинов, таких как Walmart, Whole Foods Market и Trader Joe's».

  • «В течение 1-5-минутной прогулки есть несколько вариантов столовой и покупок, в том числе Khao Kang Thai Kitchen, Deli & Donuts Roger, а также La Costeña. Для Sushi Joy Sushi-хороший вариант. Для продуктов, Dollar Tree предлагает разнообразные продукты по дисконтным ценам».

Этот генеративный контент из LLMS улучшает ответ и предоставляет дополнительную информацию, чтобы помочь пользователям принять обоснованное решение.

Новые функции с AI, добавленные в API Places (новый)

Эти возможности добавляют следующие данные в ответ API (новый):

Генеративные резюме места

Генеративные резюме места являются специфичными для идентификатора места. Установите резюме, объединяйте множество различных типов данных в одну резюме для этого места.

Места API (новый) предоставляет два типа генеративных резюме места:

  • Обзор Сводка : Краткий обзор места, в среднем около 100 символов, которое может помочь пользователям получить снимок места.

  • Описание Резюме : более длинные резюме места, в среднем около 400 символов, которые предоставляют подробный обзор, охватывающий главные аспекты этого места.

В настоящее время доступно для типов мест, показанных в поддерживаемых типах для категорий культуры , развлечений и отдыха , еды и напитков , покупок и спорта .

Генеративные резюме

Резюме генеративной площади создаются LLM для близлежащей области вокруг места. Краткое изложение области для места может содержать всю информацию, необходимую пользователю, чтобы принять решение, если пользователь должен сделать дополнительные запросы, чтобы свернуть в детали области.

Наряду с описанием области, ответ также содержит список идентификаторов места для мест, упомянутых в описании, и список мест, отсортированных по различным типам контента. Например, один тип контента содержит список мест, связанных с действиями в этом районе, а другой содержит список ресторанов в этом районе.

Резюме площадей в настоящее время доступны для типов мест, показанных в поддерживаемых типах для категории жилья , а также для конкретных типов мест electric_vehicle_charging_station , geocode и premise .

Генерация расписания и зоны

Как генеративные резюме места, так и резюме генеративной области генерируются в автономном режиме часто Google. Генерируя эти резюме в автономном режиме, вы можете воспользоваться контентом, питаемым Близнецами, в то же время видя такую ​​же производительность из API (нового), которые вы уже ожидаете.

Google часто восстанавливает эти резюме, чтобы гарантировать, что они свежи на основе последней доступной информации. Это означает, что вы будете отображать самые свежие данные в своем сервисе при вызове API.

Результаты контекстуального поиска

Текстовый поиск (новый) возвращает информацию о наборе мест, основанных на строке - например, «Пицца в Нью -Йорке» или «Обу обувные магазины возле Оттавы». Ответ текстового поиска (новый) содержит список мест, соответствующих текстовой строке, и любого смещения местоположения, установленного в запросе.

Когда вы добавляете результаты контекстуального поиска в ответ, ответ теперь включает в себя обзоры, фотографии и оправдания, которые помогают пользователям ответить на вопросы:

  • Почему я вижу это место в результатах?
  • Почему я должен выбрать это место?

Например, вы делаете запрос, чтобы разместить подробности (новый), текстовый поиск (новый) или ближайший поиск (новый) сегодня, который включает в себя конкретное место в ответе. Данные ответа для этого места одинаковы для всех трех запросов, поскольку возвращаемые данные связаны с этим местом.

Однако для текстового поиска (нового) с использованием новых возможностей ответ может включать данные, полученные из самой строки запроса ввода. Это означает, что результаты контекстуального поиска уникальны для строки запроса. Например, вы делаете запрос на текстовый поиск (новый) со следующей строкой запроса:

"Острый вегетарианский ресторан в Маунтин -Вью, Калифорния"

Затем вы оставляете все входные параметры одинаковыми и только измените строку запроса на:

"Острый веганский ресторан в Маунтин -Вью, Калифорния"

Для ресторана, который появляется в обоих ответах, данные ответа о месте одинаковы, потому что эти данные связаны с самим местом. Но результаты контекстуального поиска уникальны для запроса, потому что они получены из строки запроса. Затем вы можете отобразить отзывы, фотографии и оправдания от результатов контекстуального поиска до ваших пользователей, чтобы помочь им решить, какое место в ответе наиболее применимо к их запросу на поиск.

Включить возможности модели Близнецов для мест API (новый)

Вы должны позволить местам API (новым) использовать возможности модели Близнецов для мест API (новый). Для получения дополнительной информации см. Настройка вашего Google Cloud Project .

Ограничения для экспериментального выпуска

Этот релиз поддерживает только места для места и зоны для мест в Соединенных Штатах только на английском языке.

Что такое Близнецы?

Чтобы узнать о модели Близнецов, см. FAQ Близнецов .

Запросить сводку с генеративным местом

Краткое сооружение - это генеративные резюме, созданные LLM для определенного места. Размещает API (новый) добавляет два типа резюме в ответ:

  • Обзор генеративных резюме, которые похожи на статическую редакционную сумму, связанную с местом. Генеративные краткие резюме, в среднем около 100 символов, имеют несколько преимуществ:

    • Во многих местах нет редакционных резюме, поэтому они заполняют пробел в информации, доступной для места.

    • Они генерируются из LLM, поэтому владельцу места не нужно сохранить их.

  • Описание Генеративные резюме получены из многих источников, включая отзывы от Google Maps. Описание, в среднем около 400 символов, включает в себя список обзоров, используемых для создания длинного описания.

    Для создания описания резюме вручную требуется, чтобы человек собирал данные из многих мест, а затем вручную и поддержал содержание. Возможности модели Gemini для Places API (New) создают эти резюме из LLMS, чтобы сохранить объем и свежесть сгенерированного контента.

Резюме места поддерживаются сведениями о месте (новое) , текстовый поиск (новый) и близлежащий поиск (новый) . Чтобы включить сводку места в ответ, включите следующее поле в полевой маски запроса:

  • Детали размещения : generativeSummary

  • Поиск текста и поблизости поиск : places.generativeSummary

Поле generativeSummary содержит следующие поля:

  • generativeSummary.overview : The generative overview summary.
  • generativeSummary.description : The generative description summary.
  • generativeSummary.references : An array of up to five reviews used to provide content for the description summary. If there is no description summary, this array is empty.
  • overviewFlagContentUri : A link where users can flag a problem with the overview summary.
  • descriptionFlagContentUri : A link where users can flag a problem with the description summary.

Example overview and description summary request

This example uses a field mask of places.generativeSummary to return the entire generativeSummary object, including the generativeSummary.overview , generativeSummary.description , and generativeSummary.references fields:

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

The response is in the form:

{
  "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"
        },
        . . .
}

Example overview summary request

This example Text Search returns just the overview summary for spicy vegetarian restaurants in Mountain View, CA:

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

The response contains the generativeSummary.overview field which includes the overview.text and the overview.languageCode :

{
  "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"
        }
      }
    },
  . . .
}

Request a generative area summary

Area summaries are generative summaries created by the LLM for the nearby area of a place. Area summaries can be important to users making a decision about a place.

For example, you are looking to book a hotel in a new city and while you can find a hotel that meets your requirements, you would also like to find out more about the area around the hotel. Rather than look at a map of the surrounding area, and then having to investigate each place on the map, you can instead generate an area summary for the hotel.

Area summaries are supported by Place Details (New) , Text Search (New) , and Nearby Search (New) .

To include the area summary in the response, include in the field mask of the request:

  • areaSummary (Place Details)
  • places.areaSummary (Text Search and Nearby Search).

The areaSummary field for a place in the response contains the flagContentUri field that you can use to flag inappropriate content so that Google can remove it. It also contains an array of up to four contentBlocks . The topic for each block is based on the type of the place:

  • For an EV charging station, defined as a place of type electric_vehicle_charging_station , the topic blocks include: "overview" , "coffee" , "restaurant" , and "store" .

  • For a place with a type defined by the Lodging category, and the specific place types geocode and premise , the topic blocks include: "overview" , "activity" , "restaurant" , and "store" .

Example request for area summary of an EV charging station

This example Place Details request returns the area summary for a specific EV charging station in Mountain View, identified by the place ID ChIJC5b6QKiwj4ARgn2EwlnJnWU :

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

The response contains the areaSummary field, including the contentBlocks array:

  • The topic field specifies the type of content block. Because the place in this example is an EV charging station, the four content blocks are "overview" , "coffee" , "restaurant" , and "store" .

  • The content field includes the summary for that topic, including the language code.

  • The references array specifies the place resource names, in the form places/ PLACE_ID , used to provide content for the content block.

{
  "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"
  }
}

Example request for area summary for a hotel

This example Text Search request requests hotels in Mountain View, CA:

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

The response contains the areaSummary field, including the contentBlocks array. The response for places of type hotel contains content blocks for the topics "overview" , "activity" , "restaurant" , and "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"
      }
    },
    ...
  ]
}

Request contextual search results

The response to a Text Search (New) request contains an array of places that match the criteria of the input search string. Now you can request contextual search data in the response based on the input query to the API.

To support contextual summaries, the response from Text Search (New) contains a new array named contextualContents at the same level as the places array in the response:

{
  "places": [],
  "contextualContents":[]
}

Each element in the contextualContents array, of type ContextualContent , is at the corresponding array location as the place in the places array. That is, the element at contextualContents[0] corresponds to the place at places[0] .

Each array element contains the following array fields:

  • contextualContents.reviews : An array of up to three reviews .
  • contextualContents.photos : An array of up to five photos .

  • contextualContents.justifications : An array of justifications for the place, including:

    • reviewJustification : Highlight a section of a user review that could be of interest to an end user.
    • businessAvailabilityAttributesJustification : Includes attributes for a business that could be of interest to an end user.

To include the contextual search results in the response, include contextualContents in the field mask of the Text Search (New) request: 

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

The response contains the contextualContents array for each place in the response:

{
  "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
          }
        }
      ]
    },
    . . .
  ]
}

Implementation guidance for automotive use cases

For driver safety, Google recommends rendering generative AI summaries in parked mode for automotive experiences. If rendering summaries in driving mode, on-screen information should be simple, clear, and concise to ensure that the driver's attention returns quickly to the road.

  • No more than 3 lines
  • 120 characters or 24 words or less
  • Minimum front size of 24dp

Especially in automotive contexts, it's the developer's responsibility to render generative AI summaries in ways that are safe and compliant with all local laws and regulations.

Attributions

When you display reviews, photos, and generative AI summaries in your app, including both place and area summaries, you must ensure that you also display the required attributions.

Display attributions for generative summaries

When you display generative AI summaries in your app, including place and area summaries, you must also display the necessary attributions. This section describes how to display attributions based on how you display the generative AI summaries in your app.

In all cases, the attribution must use sentence casing. The attribution and Google logo must conform to all color, style and typeface standards. For more information on these standards, see Policies for Places API (New) .

Generative AI summary displayed in the context of other Google data

In this case, the generative AI attribution can be displayed alone above or below the summary, relying on Google attribution of the content elsewhere.

For the attribution, use the text "Summarized by AI" as shown in this image:

For the attribution, use the text Summarized by AI.

Generative AI summary displayed in isolation

When a generative AI summary appears in isolation of any other content from Google Maps, it must include both generative AI attribution and attribution to Google separated by an interpunct. For the attribution, use the text "Summarized by AI" and the Google logo as shown in this image:

For summary displayed in isolation, include generative AI attribution and Google attribution separated by an interpunct.

Generative AI summary repeated in a list

When repeating a generative AI place summary overview in a list of places, where all:

  • List content is attributed to Google
  • Summaries shown are AI generated
  • Content is available from Google

The attribution should be displayed above or below the list on a single line. The AI attribution is left-aligned and the Google attribution is right-aligned:

For a list, display attribution above or below the list on a single line.

If longer form generative AI description summaries are used in a list, each summary must have AI attribution ("Summarized by AI" with the info icon/button).

Display information about a generative AI summary in a dialog

Along with a generative AI summary, you must make a dialog available to end users that displays information about the summary, and a link to report issues using the summary's unique identifier contained in the flagContentUri field. When using a generative AI description summary , you must include information about sources of the summary, called the references .

Enable access to this dialog by including an info icon (as an interactivity affordance) in conjunction with AI attribution (as depicted in the above examples) and making the AI attribution area and icon respond to a press/click.

For generative place summaries, display:

О AI place summaries are generated from Google reviews and other data.
Сообщить о проблеме To report an issue to Google about the content of a summary, use the link contained in the flagContentUri field.
Ссылки Source reviews

Например:

Display information about a generative AI summary in a dialog.

For generative area summaries, display:

О AI area summaries are generated from Google reviews and local data.
Сообщить о проблеме To report an issue to Google about the content of a summary, use the link contained in the flagContentUri field.

Display area summary attribution.