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

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

Политики

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

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

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

парсинг контента

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

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

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

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

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

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

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

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

Пример указания авторства

Ниже приведён пример указания авторства для Places UI Kit.

Отобразить атрибуцию Google Maps

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

Указано авторство Google Maps.

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

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

Указание авторства логотипа и текста Google Maps

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

Авторство логотипа

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

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

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

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

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

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

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

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

• Обеспечьте приемлемый контраст между логотипом и фоном.
• Добавьте к тексту «Google Maps» пометку о доступности.

Авторство текста

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

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

• Оформите текст в Google Maps в соответствии с описанием в следующей таблице:

  Требования к оформлению текста в Google Maps
  Свойство	Стиль
  Семейство шрифтов	Roboto . Загрузка шрифта необязательна.
  Семейство шрифтов Fallback	Любой шрифт без засечек, уже используемый в вашем продукте, или "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 Maps контент, не относящийся к платформе Google Maps.
• Убедитесь, что указание авторства всегда видно и читаемо. Никогда не удаляйте, не скрывайте, не заслоняйте и не изменяйте его.

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

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

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

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

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

Извлечь информацию об авторстве из определенного места.

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

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

  // 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 , мы рекомендуем также включить фотографию автора и ссылку на его профиль. На следующем изображении показан пример отзыва о парке:

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

  // Use place ID to 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"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }
  

Отзывы о местах можно найти в документации.

Показать авторство фотографии

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

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

Фотографии мест можно посмотреть в документации.

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

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

Заголовок: Информация об этих результатах

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

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

Кнопка 2: ОК

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

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

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

Сводки, созданные с помощью ИИ

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

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

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

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

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

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

Ознакомьтесь с требованиями к сводке.

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

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

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

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

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