Краткие пересказы мест на основе искусственного интеллекта

Краткие описания мест на основе искусственного интеллекта – это обзоры длиной до 100 символов, относящиеся к определенному идентификатору места. Сводки мест содержат обобщенные данные разных типов, которые помогают пользователям получить общее представление о месте.

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

  • "Ресторан в торговом центре Forum Shops, где подают большие порции традиционных итальянских блюд в непринужденной обстановке".
  • "Стильный салон, предлагающий стрижки, окрашивание и укладку".
  • "Большой магазин с множеством продавцов, предлагающих разнообразные винтажные предметы интерьера, мебель и одежду".

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

Краткие описания мест доступны на следующих языках и в следующих регионах:

Язык Регион
Английский

Индия

США

Как запросить краткий пересказ от ИИ

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

  • Информация о местах (новые): generativeSummary
  • Новая версия текстового поиска и новая версия поиска поблизости places.generativeSummary

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

  • generativeSummary – краткое описание места.
  • overviewFlagContentUri: Ссылка, по которой пользователи могут сообщить о проблеме с описанием места.
  • disclosureText – локализованная текстовая строка с текстом раскрытия информации "Пересказано с помощью Gemini", который необходимо включить в атрибуцию.

Запрос информации о местах (New)

Следующий запрос информации о местах (New) возвращает краткое описание overview для суши-ресторана в Чикаго, штат Иллинойс:

curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"

Ответ имеет следующий вид:

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Запрос к новой версии текстового поиска

Следующий запрос текстового поиска (New) возвращает краткий пересказ 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" \
'https://places.googleapis.com/v1/places:searchText'

Ответ имеет следующий вид:

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Запрос "Поиск поблизости (новая версия)"

Следующий запрос поиска поблизости (New) возвращает краткую информацию overview о ресторанах и кафе в Портленде, штат Орегон:

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'

Ответ имеет следующий вид:

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Атрибуции

Все сводки, созданные искусственным интеллектом и показываемые в вашем приложении, должны сопровождаться соответствующей атрибуцией в соответствии с правилами и стандартами Google. Подробнее о правилах в отношении API Мест…