Правила в отношении Maps JavaScript API

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

Предоставление условий использования и политики конфиденциальности

Если вы разрабатываете приложение Maps JavaScript API, вы должны предоставить Условия использования и Политику конфиденциальности вместе с вашим приложением, которые соответствуют рекомендациям, изложенным в вашем Соглашении с Google:

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

Рекомендуемое место для размещения ваших Условий использования и Политики конфиденциальности зависит от платформы вашего приложения.

Мобильные приложения

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

Веб-приложения

При разработке веб-приложения рекомендуется предоставить ссылку на Условия использования и Политику конфиденциальности в нижнем колонтитуле вашего веб-сайта.

Предварительная загрузка, кэширование или хранение контента

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

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

Отображение результатов Maps JavaScript API

Вы можете отображать результаты Maps JavaScript API на карте Google или без карты. Если вы хотите отображать результаты Maps JavaScript API на карте, эти результаты должны отображаться на карте Google. Запрещено использовать данные Maps JavaScript API на карте, которая не является картой Google.

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

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

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

размещение политики атрибуции

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

Скачать: google_logo.zip

Не изменяйте атрибуцию. Не удаляйте, не скрывайте и не вырезайте информацию об авторстве. Вы не можете использовать встроенные логотипы Google (например, «Эти карты взяты из [Google_logo]»).

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

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

Если вы используете платформу Google Maps на устройстве, где отображение авторства нецелесообразно, обратитесь в отдел продаж Google , чтобы обсудить лицензии, подходящие для вашего варианта использования.

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

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

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

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

Отображение указания автора

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

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

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

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

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

Кнопка 2: ОК

Рекомендации по стилю для атрибуции Google

Ниже приведены рекомендации по стилю атрибутов Google в CSS и HTML, если вы не можете использовать загружаемый логотип Google.

Освободить пространство

Объем свободного пространства вокруг блокировки должен быть равен или превышать высоту буквы «G» в Google.

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

Разборчивость

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

Цвет

Используйте текст Google Material Grey 700 на белом или светлом фоне с максимальным оттенком черного в диапазоне 0–40%.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

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

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Шрифт

Используйте шрифт Roboto .

Пример CSS

Следующий код CSS, примененный к тексту «Google», отобразит «Google» с соответствующим шрифтом, цветом и интервалом на белом или светлом фоне.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;