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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

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

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

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

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

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

Предварительная выборка, кэширование или хранение контента

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

Отображение результатов 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 в левом нижнем углу карты и атрибуция в правом нижнем углу.

Следующий 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 и атрибуции .

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

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

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

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

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

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

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

Отображение атрибутов для фотографии

Если ваше приложение отображает фотографии , вы должны указать авторство для каждой фотографии, на которой они есть. Чтобы получить атрибуцию фотографии, вызовите GMSPlacePhotoMetadata.attributions . Это свойство имеет значение NSAttributedString или nil , если атрибуты для отображения отсутствуют.

Быстрый

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;
                      }
                    }
                  }];
    

Отображение сторонних атрибутов

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

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

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

Списки компаний- примеров

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

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

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