Правила атрибуции текста для инструментов агента Maps Experience

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

Сообщите пользователю об использовании источников Google Карт

С каждым результатом инструментов агентов Maps Experience вы получаете сообщение Attribution, которое поддерживает ответ:

  • search_places: places[].attribution
  • search_along_route: results[].place.attribution
  • compute_routes: routes[].attribution
  • lookup_weather: weather.attribution, airQuality.attribution и pollen.attribution (или attribution верхнего уровня для устаревших запросов погоды)

Каждое сообщение Attribution возвращает следующие метаданные:

  • title – название источника, которое будет показываться пользователям.
  • url – URL, по которому пользователи перенаправляются в Google Карты или Google Поиск, чтобы посмотреть исходный материал (если применимо).

При представлении результатов, полученных с помощью инструментов агентов Maps Experience, вы должны указать связанные источники Google Карт и соблюдать следующие требования:

  • Источники Google Карт должны быть указаны сразу после сгенерированного контента, который они подтверждают. Этот сгенерированный контент также называется результатом работы инструментов агентов Maps Experience.
  • Источники Google Карт должны быть видны в рамках одного взаимодействия с пользователем.

Для голосовых интерфейсов

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

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

В сообщении должно быть указано следующее:

  • Контент, созданный ИИ, может включать информацию из Google Карт.
  • Подробные источники доступны в интерфейсе Companion.

Вы должны сообщить об источниках хотя бы одним из следующих способов:

  • Визуальное отображение. Если голосовое взаимодействие происходит на устройстве с экраном, показывайте на нем активное раскрытие информации каждый раз, когда используются инструменты агента Maps Experience.
  • Голосовое сообщение. Пользователь услышит сообщение о записи. Это объявление должно быть сделано во время первого взаимодействия, поддерживаемого инструментами агента Maps Experience, и повторяться не реже одного раза в шесть месяцев.

Пример сообщения: "Контент, созданный ИИ, может включать информацию из Google Карт. Подробные источники можно найти в сопутствующем приложении.

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

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

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

  1. Общие требования

    Пример предварительного просмотра ссылки на источник в Google Картах.

  2. Дополнительные визуальные улучшения

    • Перед текстом атрибуции Google Карт вставьте значок Google Карт.
    • Добавьте фото из URL источника (og:image).

Рекомендации по указанию авторства Google Карт в тексте

При указании авторства Google Карт или Google в тексте следуйте этим рекомендациям:

  • Не изменяйте текст "Google Карты" или "Google". Не меняйте регистр букв.
  • Не переносите название Google Maps на другую строку.
  • Не переводите названия Google и Google Карты на другие языки.
  • Запретите браузерам переводить Google Карты с помощью HTML-атрибута translate="no".

Оформляйте текст Google Карт, как описано в таблице ниже.

Свойство Стиль
Семейство шрифтов Roboto. Загрузка шрифта необязательна.
Резервное семейство шрифтов Любой шрифт без засечек, который уже используется в вашем продукте, или "Sans-Serif".
Насыщенность шрифта 400
Цвет шрифта Белый, черный (#1F1F1F) или серый (#5E5E5E). Коэффициент контрастности должен быть не менее 4,5:1.
Размер шрифта Минимальный размер шрифта: 12 sp.
Максимальный размер шрифта: 16 sp.
Подробнее о типографике Material Design…

Пример CSS

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

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}