Политики и атрибуции для Places API

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

Политики

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

Исключения из ограничений кэширования

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

Страны и территории Европейской экономической зоны

Этот продукт имеет другие Условия обслуживания для клиентов с платежным адресом в Европейской экономической зоне (ЕЭЗ), а также может иметь другие функции. Перед разработкой приложений на платформе Google Карт ознакомьтесь со следующими условиями и информацией, специфичными для ЕЭЗ:

Если ваш платежный адрес не находится в ЕЭЗ, на вас распространяются следующие условия обслуживания:

Требования к атрибуции Google Maps

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

Отображение атрибуции Google Карт

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

Включена атрибуция Google Maps

Для атрибуции Google Maps, которая уже предоставляется платформой Google Maps в пользовательском интерфейсе, например в Places UI Kit:

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

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

Слева: указание логотипа Google Maps, справа: указание текста Google Maps
Слева: указание логотипа Google Maps, справа: указание текста Google Maps

Атрибуция логотипа

Соблюдайте следующие требования при использовании логотипа Google Maps в вашем приложении или на веб-сайте.
Допустимые варианты атрибуции логотипа Google Maps
Допустимые варианты атрибуции логотипа Google Maps

Загрузить логотипы Google Maps

Используйте официальные файлы логотипов Google Карт. Загрузите логотипы ниже и следуйте инструкциям в этом разделе.

Загрузите ресурсы атрибуции Google Maps

При использовании логотипа Google Maps следуйте этим рекомендациям.

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

Спецификация размера логотипа

Соблюдайте следующие требования к размерам логотипа Google Maps:
  • Минимальная высота логотипа: 16dp
  • Максимальная высота логотипа: 19dp
  • Минимальное свободное пространство для логотипа: 10dp слева, справа и сверху, 5dp снизу.

Чтобы узнать больше о dp, ознакомьтесь с разделом Плотность пикселей на сайте Material Design.

Логотип Google Maps с указанием минимального свободного пространства и допустимого диапазона размеров
Логотип Google Maps с указанием минимального свободного пространства и допустимого диапазона размеров

Доступность логотипа

Соблюдайте следующие требования доступности для логотипа Google Maps:
  • Поддерживайте понятный контраст между логотипом и фоном.
  • Добавьте метку доступности с текстом Google Maps .
Неприемлемые вариации и проблемы доступности при указании логотипа Google Maps
Неприемлемые вариации и проблемы доступности при указании логотипа Google Maps

Атрибуция текста

Если размер вашего интерфейса не позволяет разместить логотип Google Maps, вы можете написать название Google Maps прописью. Следуйте этим рекомендациям:

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

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

Пример CSS

Следующий CSS-код отображает Google Maps с соответствующим типографским стилем и цветом на белом или светлом фоне.

@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;
}

Визуальные требования

Соблюдайте следующие требования к визуальной обработке атрибуции Google Maps.
  • Размещайте атрибуцию в верхней или нижней части контента, в пределах одного визуального контейнера. Для одной строки контента атрибуцию можно расположить справа или слева.

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

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

На следующих рисунках показаны примеры этих визуальных требований.

Пример атрибуции Google Maps, размещенной сверху, снизу и сбоку от контента
Пример атрибуции Google Maps, размещенной сверху, снизу и сбоку от контента

Пример трех подходов к дифференциации контента Google Карт (рейтинга места) от другого контента
Пример трех подходов к дифференциации контента Google Карт (рейтинга места) от другого контента

Не скрывайте авторство Google Maps и не смешивайте его с контентом из других источников.
Не скрывайте авторство Google Maps и не смешивайте его с контентом из других источников.

Сторонние поставщики данных

Некоторые данные и изображения в наших картографических продуктах предоставлены поставщиками, не являющимися Google. Для некоторых продуктов, таких как API Map Tiles, мы можем предоставить вам требуемую атрибуцию стороннего поставщика данных. В этом случае текст вашей атрибуции должен содержать название «Google Maps» и соответствующих поставщиков данных, например, «Картографические данные: Google, Maxar Technologies». Если Google предоставляет атрибуцию стороннего поставщика, указание только «Google Maps» или логотипа Google не является корректным.

Другие требования к атрибуции

Следующие требования к атрибуции относятся только к API Places.

Автозаполнение адресов конечных пользователей

Когда конечный пользователь использует функцию автозаполнения в вашем клиентском приложении для ввода адреса, и этот адрес был бы полностью и точно указан этим конечным пользователем без автозаполнения, выбранный конечным пользователем адрес не подпадает под ограничения в отношении контента Google Карт, предусмотренные вашим Соглашением платформы Google Карт. Это исключение применяется только к адресу, выбранному конечным пользователем, и исключительно к конкретной транзакции этого конечного пользователя; оно не распространяется на список предлагаемых адресов, предоставляемый функцией автозаполнения, или на другой контент Google Карт. Это исключение не распространяется на функции поиска точек интереса (POI) или адресов, предлагаемые другими сервисами платформы Google Карт.

Автозаполнение адреса конечного пользователя

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

Атрибуция третьих лиц

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

Получить атрибуцию из места

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

Атрибуция в объекте Place ответа представлена ​​объектом Attribution . Чтобы добавить Attribution в ответ, включите places.attributions (поиск поблизости и текстовый поиск) или attributions (информация о месте) в маску поля запроса.

Поля объекта Attribution представляют собой строки, содержащие provider и providerUri атрибуции, или пустую строку, если нет атрибуций для отображения.

Отображение атрибуции фотографии

Если ваше приложение отображает фотографии, вы должны указать автора каждой фотографии, на которой они размещены.

Подробная информация о фотографии в объекте Place ответа содержится в массиве photos . Чтобы добавить массив photos в ответ, включите places.photos (поиск поблизости и текстовый поиск) или photos (информация о месте) в маску поля запроса.

Каждый элемент массива photos является экземпляром Photo , который содержит массив authorAttributions типа AuthorAttribution .

Поля объекта AuthorAttribution представляют собой строки, содержащие displayName , uri и photoUri атрибуции, или пустую строку, если нет атрибуций для отображения.

Показать обзор

Объект Place в ответе может содержать до пяти отзывов. При желании вы можете отображать эти отзывы в своём приложении.

При отображении отзывов пользователей Google необходимо размещать имя автора в непосредственной близости. Если оно доступно в поле «Атрибуция автора» объекта Review , мы рекомендуем также включить фотографию автора и ссылку на его профиль. На следующем изображении показан пример отзыва о парке:

Отображение авторства автора

Google также рекомендует демонстрировать конечному пользователю, как сортируются отзывы.

Каждый отзыв в объекте Place ответа представлен объектом Review . Чтобы добавить объект Review в ответ, включите places.reviews (поиск поблизости и текстовый поиск) или reviews (информация о месте) в маску поля запроса.

Поля объекта Review содержат информацию об авторстве или остаются пустыми, если информация об авторстве не отображается.

Атрибуция результатов поиска

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

Заголовок: Об этих результатах

Текст: При поиске компаний или мест рядом с определённым местоположением Google Карты покажут вам локальные результаты. Для поиска наилучших результатов учитываются несколько факторов, в первую очередь релевантность, расстояние и известность.

Кнопка 1: Узнать больше
Текст «Узнать больше» должен ссылаться на статью Справочного центра .

Кнопка 2: ОК

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

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

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

Отображение текста раскрытия информации с помощью ИИ

При отображении любого типа сводки, созданной с помощью ИИ, всегда включайте локализованный текст раскрытия (указанный в поле disclosureText текста ответа) непосредственно под сводкой. Никогда не изменяйте и не дополняйте текст раскрытия, предоставленный API.

Раскрытие информации обо всех типах сводок, созданных с помощью ИИ
Рисунок 1 : Текст раскрытия информации правильно отображается под каждым из трех типов сводок на основе ИИ.

Дополнительные требования к месту и площади

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

Текст Требование
Об этом резюме Воспользуйтесь следующей ссылкой на раздел «Как Google получает и использует информацию в местных листингах»: https://support.google.com/local-listings/answer/9851099 .
Резюме отчета

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

Примечание: Сводки на основе искусственного интеллекта, предоставляемые через API Places (новый), регулируются политиками Google в отношении контента и продуктов, где бы вы ни находились. Вам необходимо уведомить своих конечных пользователей о том, что для сообщения о контенте, который должен быть удален из сервисов Google в соответствии с действующим законодательством, им следует использовать предоставленный URL-адрес для флага контента ( flagContentUri ).

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

Требования к краткому обзору

Краткое содержание отзывов, отображаемое в вашем приложении, должно сопровождаться заголовком с текстом «Краткое содержание отзывов». Кроме того, необходимо использовать следующий текст и необходимые ссылки:

Текст Требование
Об этом резюме Воспользуйтесь следующей ссылкой на статью «Как Google получает и использует информацию в местных каталогах»: https://support.google.com/local-listings/answer/9851099
Резюме отчета

Используйте ссылку, содержащуюся в поле flagContentUri ответа.

Примечание: Сводки на основе искусственного интеллекта, предоставляемые через API Places (новый), регулируются политиками Google в отношении контента и продуктов, где бы вы ни находились. Вам необходимо уведомить своих конечных пользователей о том, что для сообщения о контенте, который должен быть удален из сервисов Google в соответствии с действующим законодательством, им следует использовать предоставленный URL-адрес для флага контента ( flagContentUri ).

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

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

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

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

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