Правила для Places SDK для Android

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

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

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

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

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

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

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

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

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

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

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

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

Отображение результатов Places SDK для Android

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

Отображение логотипа 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 Карт на устройстве, где отображение атрибуции нецелесообразно, свяжитесь с отделом продаж Google, чтобы обсудить лицензии, подходящие для вашего варианта использования.

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

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

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

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

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

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

Кнопка 2: ОК

Показать обзор

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

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

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

Примечание: По умолчанию отзывы сортируются по релевантности. Для нового SDK сортировка по релевантности — единственный вариант.

Чтобы получить доступ к отзывам, вызовите 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, а не для каждого места.

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

Один из способов отображения атрибуции — с помощью 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

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

Очистить место

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

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

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

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

Цвет

Используйте текст Google Material Gray 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;