Сводки мест на основе искусственного интеллекта

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

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

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

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

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

Язык Область
Английский

Индия

Соединенные Штаты

Запросить генеративное резюме места

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

  • Подробности места (новые): generativeSummary
  • Текстовый поиск (новый) и поиск поблизости (новый): places.generativeSummary

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

  • generativeSummary : Краткое описание места.
  • overviewFlagContentUri : ссылка, с помощью которой пользователи могут сообщить о проблеме с описанием места.
  • disclosureText : локализованная текстовая строка с текстом раскрытия «Summarized with Gemini», которая должна быть включена в атрибуцию.

Запрос сведений о месте (новый)

Следующий запрос Place Details (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"
    }
  }
}

Запрос на поиск текста (новый)

Следующий запрос на поиск текста (новый) возвращает краткий 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"
        }
      }
    },
    /.../
  ]
}

Запрос на поиск поблизости (новый)

Следующий запрос «Поиск поблизости (новый)» возвращает 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 Places» .