Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы MapKit ссылка класса MKMapItem

Опции
Развертывание Target:

На этой странице
Язык:

MKMapItem

Наследование

Соответствует

Оператор импорта

Swift

import MapKit

Objective C

@import MapKit;

Доступность

Доступный в iOS 6.0 и позже.

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

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

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

Специальные замечания использования

Чтобы определить, доступен ли класс во время выполнения в данном выпуске iOS, Вы обычно проверяете, является ли тот класс nil. К сожалению, этот тест не чисто точен для MKMapItem. Несмотря на то, что этот класс был общедоступен начиная с iOS 6.0, это было в разработке до этого. Несмотря на то, что класс существует в более ранних выпусках, Вы не должны пытаться использовать его в тех выпусках.

Для определения во время выполнения, можно ли использовать элементы карты в приложении протестируйте ли класс и openMapsWithItems:launchOptions: метод класса существует (что метод не был добавлен к классу до iOS 6.0). Код, чтобы сделать это могло бы быть похожим на следующее:

  • Class itemClass = [MKMapItem class];
  • if (itemClass && [itemClass respondsToSelector:@selector(openMapsWithItems:launchOptions:)]) {
  • // Use class
  • }

Создание и инициализация элементов карты
  • mapItemForCurrentLocation () + mapItemForCurrentLocation

    Создает и возвращает одноэлементный объект элемента карты представление текущего расположения устройства.

    Объявление

    Swift

    class func mapItemForCurrentLocation() -> MKMapItem!

    Objective C

    + (MKMapItem *)mapItemForCurrentLocation

    Возвращаемое значение

    MKMapItem объект, представляющий текущее расположение.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • init (placemark:) - initWithPlacemark:

    Инициализирует и возвращает объект элемента карты использование указанного объекта placemark.

    Объявление

    Swift

    init!(placemark placemark: MKPlacemark!)

    Objective C

    - (instancetype)initWithPlacemark:(MKPlacemark *)placemark

    Параметры

    placemark

    Соответствие объекта placemark желаемому расположению карты. Этот параметр не должен быть nil.

    Возвращаемое значение

    Инициализированный объект элемента карты.

    Обсуждение

    Используйте этот метод для создания элемента карты для существующего placemark. Не используйте его для создания элемента карты, представляющего текущее расположение пользователя. Чтобы сделать это, используйте mapItemForCurrentLocation метод вместо этого.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

Доступ к атрибутам элемента карты
  • placemark Свойство

    Объект placemark, содержащий информацию о расположении.

    Объявление

    Swift

    var placemark: MKPlacemark! { get }

    Objective C

    @property(nonatomic, readonly) MKPlacemark *placemark

    Обсуждение

    Если Вы создали элемент карты с помощью mapItemForCurrentLocation метод, значение этого свойства nil и isCurrentLocation свойство установлено в YEStrue.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • isCurrentLocation Свойство

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

    Объявление

    Swift

    var isCurrentLocation: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL isCurrentLocation

    Обсуждение

    Если значение этого свойства YEStrue, элемент карты представляет текущее расположение пользователя. Если YEStrue, значение в placemark свойство установлено в nil.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • name Свойство

    Описательное имя связалось с элементом карты.

    Объявление

    Swift

    var name: String!

    Objective C

    @property(nonatomic, copy) NSString *name

    Обсуждение

    Используйте это свойство для указания имени, связанного с расположением. Например, если бы существует бизнес в указанном расположении, Вы использовали бы это свойство для указания имени бизнеса.

    Если этот элемент карты представляет текущее расположение пользователя, значение в свойстве установлено в локализованную версию “Текущего Расположения”.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • phoneNumber Свойство

    Телефонный номер связался с бизнесом в указанном расположении.

    Объявление

    Swift

    var phoneNumber: String!

    Objective C

    @property(nonatomic, copy) NSString *phoneNumber

    Обсуждение

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

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • url Свойство

    URL связался с указанным расположением.

    Объявление

    Swift

    var url: NSURL!

    Objective C

    @property(nonatomic, strong) NSURL *url

    Обсуждение

    Если существует соответствующий URL, связанный с расположением, таким как URL для бизнеса в расположении, используйте это свойство для указания того значения.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

Запуск приложения карт
  • openMapsWithItems (_: launchOptions:) + openMapsWithItems:launchOptions:

    Откройте приложение Карт и выведите на экран указанные элементы карты.

    Объявление

    Swift

    class func openMapsWithItems(_ mapItems: [AnyObject]!, launchOptions launchOptions: [NSObject : AnyObject]!) -> Bool

    Objective C

    + (BOOL)openMapsWithItems:(NSArray *)mapItems launchOptions:(NSDictionary *)launchOptions

    Параметры

    mapItems

    Массив, содержащий один или больше MKMapItem объекты, представляющие элементы, Вы хотите вывести на экран на карте. Этот параметр может быть nil.

    launchOptions

    Дополнительная информация, которую приложение Карт может использовать для конфигурирования дисплея карты. Например, можно использовать опции запуска указать видимую область карты, 3D перспективу и тип карты. Для списка ключей можно поместить в этот словарь, видеть “Launch Options Dictionary Keys”.

    Можно указать nil для этого параметра.

    Возвращаемое значение

    YEStrue если элементы карты были успешно открыты приложением Карт, или NOfalse если была ошибка.

    Обсуждение

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

    Если Вы указываете MKLaunchOptionsDirectionsModeKey опция в launchOptions словарь, mapItems массив должен иметь не больше, чем два элемента в нем. Если массив содержит один элемент, приложение Карт генерирует направления от текущего расположения пользователя до расположения, указанного элементом карты. Если массив содержит два элемента, приложение Карт генерирует направления от расположения первого элемента к расположению второго элемента в массиве.

    Если Вы не включаете MKLaunchOptionsMapCenterKey и MKLaunchOptionsMapSpanKey ключи в Вашем launchOptions словарь, Карты создают область, охватывающую предоставленные элементы. Это использует эту область для установки видимой части карты.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • openInMapsWithLaunchOptions (_:) - openInMapsWithLaunchOptions:

    Откройте приложение Карт и выведите на экран этот элемент карты.

    Объявление

    Swift

    func openInMapsWithLaunchOptions(_ launchOptions: [NSObject : AnyObject]!) -> Bool

    Objective C

    - (BOOL)openInMapsWithLaunchOptions:(NSDictionary *)launchOptions

    Параметры

    launchOptions

    Дополнительная информация, которую приложение Карт может использовать для конфигурирования дисплея карты. Например, можно использовать опции запуска указать видимую область карты и тип карты. Для списка ключей можно поместить в этот словарь, видеть “Launch Options Dictionary Keys”.

    Этот параметр может быть nil.

    Возвращаемое значение

    YEStrue если этот элемент карты был успешно открыт приложением Карт, или NOfalse если была ошибка.

    Обсуждение

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

    Если Вы указываете MKLaunchOptionsDirectionsModeKey опция в launchOptions словарь, приложение Карт интерпретирует это как попытку отобразиться от текущего расположения пользователя до расположения, указанного этим элементом карты.

    Если Вы не включаете MKLaunchOptionsMapCenterKey и MKLaunchOptionsMapSpanKey ключи в Вашем launchOptions словарь, Карты создают область вокруг текущего элемента. Это использует ту область для установки видимой части карты.

    Оператор импорта

    Objective C

    @import MapKit;

    Swift

    import MapKit

    Доступность

    Доступный в iOS 6.0 и позже.

Константы
  • Ключи словаря опций запуска

    Опции запуска указать при открытии элементов карты в приложении Карт.

    Объявление

    Swift

    let MKLaunchOptionsDirectionsModeKey: String let MKLaunchOptionsMapTypeKey: String let MKLaunchOptionsMapCenterKey: String let MKLaunchOptionsMapSpanKey: String let MKLaunchOptionsShowsTrafficKey: String let MKLaunchOptionsCameraKey: String

    Objective C

    NSString * const MKLaunchOptionsDirectionsModeKey; NSString * const MKLaunchOptionsMapTypeKey; NSString * const MKLaunchOptionsMapCenterKey; NSString * const MKLaunchOptionsMapSpanKey; NSString * const MKLaunchOptionsShowsTrafficKey; NSString * const MKLaunchOptionsCameraKey

    Константы

    • MKLaunchOptionsDirectionsModeKey

      Значение этого ключа NSString соответствие одному из значений, описанных в “Directions Mode Values”. Вы указываете этот ключ, чтобы сказать приложению Карт обрабатывать предоставленные элементы карты, как запускаются и конечные точки для направлений маршрутизации. Если этот ключ не присутствует, контакты дисплеев Карт в указанных расположениях.

      Доступный в iOS 6.0 и позже.

    • MKLaunchOptionsMapTypeKey

      Значение этого ключа NSNumber возразите, чье значение является целым числом, соответствующим MKMapType значение. Это значение представляет тип карты (стандарт, спутник или гибрид) для отображения.

      Доступный в iOS 6.0 и позже.

    • MKLaunchOptionsMapCenterKey

      Значение этого ключа NSValue объект, содержащий закодированный CLLocationCoordinate2D структура. Это значение представляет расположение, на котором должно центрироваться представление карты.

      Доступный в iOS 6.0 и позже.

    • MKLaunchOptionsMapSpanKey

      Значение этого ключа NSValue объект, содержащий закодированный MKCoordinateSpan структура. Это значение представляет область, которую должно вывести на экран представление карты.

      Доступный в iOS 6.0 и позже.

    • MKLaunchOptionsShowsTrafficKey

      Значение этого ключа NSNumber объект, содержащий булево значение. Это значение указывает, должна ли информация о трафике быть выведена на экран на карте. Если Вы не указываете этот ключ, Карты использует его текущие настройки, чтобы определить, вывести ли на экран трафик.

      Доступный в iOS 6.0 и позже.

    • MKLaunchOptionsCameraKey

      Значение этого ключа MKMapCamera объект, описывающий виртуальную камеру, которая может указать 3D перспективу для карты. Если Вы не указываете этот ключ, Карты использует его текущие настройки для определения появления карты.

      Доступный в iOS 7.1 и позже.

    Обсуждение

    Вы указываете эти ключи в словаре опций запуска для openMapsWithItems:launchOptions: или openInMapsWithLaunchOptions: метод.

  • Значения режима направлений

    Строки, представляющие возможные значения MKLaunchOptionsDirectionsModeKey ключ.

    Объявление

    Swift

    let MKLaunchOptionsDirectionsModeDriving: String let MKLaunchOptionsDirectionsModeWalking: String

    Objective C

    NSString * const MKLaunchOptionsDirectionsModeDriving; NSString * const MKLaunchOptionsDirectionsModeWalking;

    Константы

    • MKLaunchOptionsDirectionsModeDriving

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

      Доступный в iOS 6.0 и позже.

    • MKLaunchOptionsDirectionsModeWalking

      Говорит приложению Карт отображать направления обхода между запуском и конечными точками.

      Доступный в iOS 6.0 и позже.