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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Результаты поиска атрибуции

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

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

Текст: Когда вы ищете компании или места рядом с местоположением, 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
    }
  }
}

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

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

Быстрый 

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

  }
})

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

Objective-C 

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

#pragma mark - UITextViewDelegate

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

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

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

Листинги по примерам компаний

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

Руководство по стилю для атрибуции Google

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

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

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

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

Расстояние между логотипом Google и текстом атрибуции

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

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

Цвет

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