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

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

Условия использования и политика конфиденциальности

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

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

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

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

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

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

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

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

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

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

Показ результатов, полученных с помощью Maps JavaScript API

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

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

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

Как получать сведения об авторстве из объекта 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 есть эти данные. Ниже приведен пример отзыва на парк.

Показ сведений об авторстве

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

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen, 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 в 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" на белом или светлом фоне с использованием подходящего шрифта, цвета и отступов.

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;