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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вы можете отображать результаты Places SDK для iOS на карте Google или без карты. Если вы хотите отображать результаты Places SDK для iOS на карте, эти результаты должны отображаться на карте Google. Запрещено использовать данные Places SDK для iOS на карте, которая не является картой 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 Maps на устройстве, где отображение авторства нецелесообразно, обратитесь в отдел продаж Google , чтобы обсудить лицензии, подходящие для вашего варианта использования.

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

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

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

Совет: Возможно, вам будет удобно использовать стороннюю библиотеку для визуализации данных NSAttributedString .

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

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

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

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

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

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

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

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

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

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

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

Кнопка 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
    }
  }
}
    

Цель-C

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

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

Чтобы получить доступ к отзывам:

Быстрый

// 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.

  }
})

Цель-C

// 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
}
    

Цель-C

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

#pragma mark - UITextViewDelegate

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

Пример сторонней атрибуции

Сторонняя атрибуция обычно состоит из текста со ссылкой. Например:

Объявления по примерам компаний

В приведенном выше примере текстовый диапазон «Пример компании» покрыт атрибутом NSLink .

Рекомендации по стилю для атрибуции 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;