Политики и атрибуции для Places SDK для Android

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

Политики

В этом разделе описаны правила, относящиеся к Places SDK для Android. Правила содержат практические рекомендации и требования по внедрению, которые помогут вам правильно использовать Сервис в соответствии с ожиданиями платформы 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 не является надлежащим указанием.

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

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

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

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

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

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);
FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
  Place place = response.getPlace();
  textView.append("Place found: " + place.getName());
  List<String> attributions = place.getAttributions();
  if (attributions != null) {
    StringBuilder stringBuilder = new StringBuilder("Attributions: ");
    for (String attribution : attributions) {
      stringBuilder.append(attribution).append("\n");
    }
    textView.append(stringBuilder.toString());
  }}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
      // Handle the error.
    }
  }
);

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

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

• Attributions — строка с указанием авторства, доступ к которой осуществляется с помощью PhotoMetadata.getAttributions() .
• AuthorAttributions — объект AuthorAttributions , доступ к которому осуществляется методом PhotoMetadata.getAuthorAttributions() .

Чтобы получить строковые данные об авторстве фотографии, вызовите метод PhotoMetadata.getAttributions() . Метод возвращает последовательность символов HTML или пустую строку, если для отображения нет данных об авторстве.

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the attribution text.
String attributions = photoMetadata.getAttributions();

Чтобы получить информацию об авторстве фотографии, вызовите метод PhotoMetadata.getAuthorAttributions() . Метод возвращает объект AuthorAttributions . Этот объект содержит List объектов AuthorAttribution , по одному для каждого автора.

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the author attributions object.
AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();
List<AuthorAttribution> authorAttributionList = authorAttributions.asList();

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

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

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

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

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

Кнопка 2: ОК

Показать отзыв

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

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

Google также рекомендует показывать конечному пользователю, как именно происходит сортировка отзывов.

Чтобы получить доступ к отзывам, вызовите метод Place.getReviews() :

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    List<Review> reviews = place.getReviews();
    // For loop for iterating over the List
    for (int i = 0; i < reviews.size(); i++) {
      // For each review, get the Review object.
        Review placeReview = reviews.get(i);

      // Get any attribution and author attribution.
        String reviewAttribution = placeReview.getAttribution();
        AuthorAttribution authorAttribution = placeReview.getAuthorAttribution();

        // Display the review contents and attributions as necessary.
    }
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        // Handle the error.
    }
});

Отображение ссылок на третьих лиц

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

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

Один из способов отображения атрибуции — использование TextView . Например:

TextView attributionsText = (TextView) findViewById(R.id.attributions);
String thirdPartyAttributions = place.getAttributions();
attributionsText.setText(thirdPartyAttributions);

Пример указания авторства третьей стороны.

Listings by <a href="https://www.example.com/">Example Company</a>

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

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

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