Правила и атрибуция для Maps JavaScript API

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

Правила

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

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

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

Сбор контента

Название места может быть возвращено вам на основе взаимодействия пользователя с вашим приложением. Если вы сохраните название места для использования в любом другом контексте за пределами сеанса пользователя, это будет считаться сбором данных, что запрещено нашими условиями.

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

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

• Условия использования платформы Google Карт в ЕЭЗ
• Условия использования сервисов платформы Google Карт в ЕЭЗ
• Часто задаваемые вопросы о ЕЭЗ
• Требования платформы Google Карт к безопасности дорожного движения

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

• Условия использования платформы Google Карт
• Условия использования отдельных сервисов платформы Google Карт

Требования к указанию авторства в Google Картах

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

Пример атрибуции

Ниже приведен пример атрибуции для Places UI Kit.

Как показывать информацию об авторстве Google Карт

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

Указание авторства Google Карт

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

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

Логотип Google Карт и текстовая атрибуция

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

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

Скачать логотипы Google Карт

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

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

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

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

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

Подробнее о dp можно узнать на странице Плотность пикселей на сайте Material Design.

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

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

Указание авторства текста

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

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

• Стиль текста на Картах Google можно задать так, как описано в таблице ниже.

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

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

• Размещайте атрибуцию вверху или внизу контента в том же визуальном контейнере. Если контент занимает одну строку, атрибуцию можно разместить справа или слева.

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

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

На рисунках ниже показаны примеры таких требований.

от независимых поставщиков,

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

Другие требования по указанию авторства

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

Как получать сведения об авторстве из объекта Place

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

API возвращает объект Place. Чтобы получить сведения об авторстве из объекта Place, используйте свойство Place.attributions, которое возвращается при каждом запросе (указывать его с помощью полей не нужно). Свойство возвращает List (список) объектов типа String. Если сведения об авторстве отсутствуют, возвращается значение null. Ниже приведен пример кода, с помощью которого можно получить сведения о месте с указанием авторства.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

Как показывать отзывы

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

При показе отзывов, оставленных пользователями Google, рядом обязательно должно быть указано имя автора. Мы также рекомендуем добавлять фотографию пользователя и ссылку на его профиль, если в поле с указанием автора в объекте Review есть эти данные. Ниже приведен пример отзыва на парк.

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

// Create a new Place instance.
const place = new Place({
    id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA
});

// Call fetchFields, passing 'reviews' and other needed fields.
await place.fetchFields({
    fields: ['displayName', 'formattedAddress', 'location', 'reviews'],
});

// Create an HTML container.
const content = document.createElement('div');
const title = document.createElement('div');
const rating = document.createElement('div');
const address = document.createElement('div');
const review = document.createElement('div');
const authorLink = document.createElement('a');

// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
    // Get info for the first review.
    const reviewRating = place.reviews[0].rating;
    const reviewText = place.reviews[0].text;
    const authorName = place.reviews[0].authorAttribution.displayName;
    const authorUri = place.reviews[0].authorAttribution.uri;

    // Safely populate the HTML.
    title.textContent = place.displayName || '';
    address.textContent = place.formattedAddress || '';
    rating.textContent = `Rating: ${reviewRating} stars`;
    review.textContent = reviewText || '';
    authorLink.textContent = authorName;
    authorLink.href = authorUri || '';
    authorLink.target = '_blank';

    content.appendChild(title);
    content.appendChild(address);
    content.appendChild(rating);
    content.appendChild(review);
    content.appendChild(authorLink);
} else {
    content.textContent = `No reviews were found for ${place.displayName}.`;
}

// Create an infoWindow to display the review.
infoWindow = new InfoWindow({
    content,
    ariaLabel: place.displayName,
});
index.js

Документация по отзывам о местах

Как показывать сведения об авторах фотографий

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

Каждый элемент массива photos является экземпляром Photo, который содержит массив authorAttributions типа AuthorAttribution. Поля объекта AuthorAttribution представляют собой строки, содержащие следующие сведения об авторстве: displayName, uri и photoUri. Если эти данные отсутствуют, возвращается пустая строка.

Документация по фотографиям мест

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

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

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

Текст: Если вы будете искать компании или места рядом с определенным местоположением, Google Карты покажут местные результаты. Выбор результатов зависит от разных факторов, в основном от соответствия запросу, расстояния и известности компании.

Кнопка 1: "Подробнее"
Текст "Подробнее" должен вести на статью Справочного центра.

Кнопка 2: OK

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

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

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

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

Если вы показываете в приложении сгенерированные ИИ краткие описания мест, районов и отзывов, вы должны:

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

Показывать текст раскрытия информации об обзорах на основе ИИ

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

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

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

Требования к сводкам отзывов

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

Рекомендации по использованию дисплея в автомобиле

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

• Не более трех строк
• не более 120 символов или 24 слов;
• Минимальный размер шрифта – 24 dp.

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