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

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

Политики

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

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

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

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

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

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

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

attributions предоставляется в виде объекта NSAttributedString .

Получить атрибуцию для набора мест

Если ваше приложение отображает информацию, полученную путем запроса текущего местоположения устройства, оно должно отображать сторонние ссылки на данные о местоположении. Вы можете получить ссылки на все места, полученные в результате запроса, из свойства attributions объекта ` GMSPlaceLikelihoodList .

attributions предоставляется в виде объекта NSAttributedString , к которому можно получить доступ и отобразить его так же, как и attributions в одном месте, как описано выше .

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

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

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

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

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

Кнопка 2: ОК

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

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

• Для доступа к информации об авторстве используйте GMSPlacePhotoMetadata.attributions . Это свойство имеет тип NSAttributedString или nil , если для отображения нет информации об авторстве.
• Для доступа к информации об авторстве используйте свойство GMSPlacePhotoMetadata.authorAttributions . Это свойство содержит массив объектов GMSPlaceAuthorAttribution .

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}
    

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
      callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                  NSError *_Nullable error) {
        if (error) {
          // TODO: handle the error.
          NSLog(@"Error: %@", [error description]);
        } else {
          // Get attribution for the first photo in the list.
          if (photos.results.count > 0) {
            GMSPlacePhotoMetadata *photo = photos.results.firstObject;
            NSAttributedString *attributions = photo.attributions;
          }
        }
      }];
    

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

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

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

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

Чтобы ознакомиться с отзывами:

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

Отображение ссылок на сторонние ресурсы

Указание авторства сторонних поставщиков предоставляется в виде объектов NSAttributedString , содержащих контент и ссылки, которые необходимо сохранить и отобразить пользователю.

Рекомендуемый способ отображения информации об авторстве — использование UITextView , поскольку ссылки в этой информации должны работать. Чтобы гарантировать работоспособность ссылок, установите делегат для UITextView и настройте метод shouldInteractWithURL вашего UITextViewDelegate на возврат значения YES .

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}
    

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}
    

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

Указание источника (третьей стороны) обычно представляет собой текст со ссылкой. Например:

Объявления от компании Example Company

В приведенном выше примере текстовый диапазон Example Company охватывается атрибутом NSLink .

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

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

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