Правила для API мест

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

Политики

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Некоторые данные и изображения в наших картографических продуктах поступают от поставщиков, отличных от Google. Для некоторых продуктов, таких как API Map Tiles, мы можем предоставить вам требуемую атрибуцию стороннего поставщика данных. Когда мы это делаем, текст вашей атрибуции должен содержать название «Google Maps» и соответствующих поставщиков данных, например «Данные карты: Google, Maxar Technologies». Когда Google предоставляет атрибуцию третьей стороны, включение только «Google Maps» или логотипа 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 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 Maps
    • Не размещайте Google Maps на нескольких строках
    • Не локализуйте Google Maps на другой язык.
    • Запретите браузерам переводить Google Maps с помощью HTML-атрибута translate="no" .
Неприемлемые вариации атрибуции текста Google Maps
Неприемлемые вариации атрибуции текста Google Maps
  • Оформите текст Google Карт, как описано в следующей таблице:

    Требования к оформлению текста в Google Maps
    Свойство Стиль
    Семейство шрифтов Roboto . Загрузка шрифта необязательна.
    Резервное семейство шрифтов Любой шрифт без засечек, который уже используется в вашем продукте, или «Sans-Serif» для вызова системного шрифта по умолчанию
    Стиль шрифта Нормальный
    Шрифт 400
    Цвет шрифта Белый, черный (#1F1F1F) или серый (#5E5E5E). Поддерживайте доступный (4,5:1) контраст по отношению к фону.
    Размер шрифта Минимальный размер шрифта: 12sp
    Максимальный размер шрифта: 16sp
    Чтобы узнать больше о 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, размещенного сверху, снизу и сбоку от контента
Пример указания источника на Картах Google, размещенного сверху, снизу и сбоку от контента

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

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

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

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

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

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

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

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

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

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

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

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

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

Текст: Когда вы ищете компании или места рядом с местоположением, Google Maps покажет вам локальные результаты. Несколько факторов — в первую очередь релевантность, расстояние и известность — объединяются, чтобы помочь найти лучшие результаты для вашего поиска.

Кнопка 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 ).

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

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

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

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

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