MKTileOverlay
MKTileOverlay
класс реализует наложение, оптимизированное для покрытия области карты с помощью отдельных растровых мозаик. (В целом мозаика карты является предварительно представленным изображением карты, покрывающим определенную географическую область.) Можно использовать объекты наложения мозаики, чтобы представлять собственное основанное на мозаике содержание и скоординировать дисплей того содержания в представлении карты. Ваши мозаики могут дополнить базовое содержание карты или заменить его полностью. Объект наложения мозаики координирует загрузку и управление мозаиками в то время как соответствие MKTileOverlayRenderer
возразите обрабатывает фактическое получение мозаик на карте.
Можно использовать единственный объект наложения мозаики для представления всех мозаик на одном или более уровнях изменения масштаба карты. Объект наложения мозаики по умолчанию использует шаблонную строку для создания URLs так, чтобы он мог определить местоположение мозаик карты, в которых он нуждается. Каждый URL включает индекс x и y мозаики карты, уровень изменения масштаба, это предназначается для, и масштабный коэффициент, соответствующий разрешению экрана, на котором можно вывести на экран мозаику. Класс по умолчанию позволяет Вам указать мозаики карты, индексы которых запускаются или в верхнем левом углу или в нижнем левом углу карты. При использовании различной схемы индексации мозаик можно также разделить на подклассы и переопределить URLForTilePath:
или loadTileAtPath:result:
методы для отображения между требуемой мозаикой и пользовательской схемой индексации.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
MKAnnotation
-
MKOverlay
-
NSObjectProtocol
-
Печатаемый
-
MKOverlay
-
NSObject
Оператор импорта
Swift
import MapKit
Objective C
@import MapKit;
Доступность
Доступный в OS X v10.9 и позже.
-
init (URLTemplate:) - initWithURLTemplate:
Определяемый инициализаторИнициализирует и возвращает объект наложения мозаики с помощью указанного шаблона доступа мозаики.
Объявление
Swift
init!(URLTemplate
URLTemplate
: String!)Objective C
- (instancetype)initWithURLTemplate:(NSString *)
URLTemplate
Параметры
URLTemplate
Строка, которая может использоваться для создания URL для доступа к изображениям мозаики. Строка, которую Вы указываете, может указать на локальный файл или на изображение на удаленном сервере. Для упрощения получающих многократных мозаик с помощью строки используйте значения заполнителя
{x}
,{y}
,{z}
, и{scale}
как заместители для мозаики x и y индексирует, уровень изменения масштаба и разрешение изображения мозаики. Если этот параметрnil
, необходимо обеспечить пользовательские реализации для методов загрузки мозаики этого класса.Возвращаемое значение
Инициализированный объект наложения мозаики.
Обсуждение
Объект наложения мозаики по умолчанию использует шаблонную строку, которую Вы указываете для запроса мозаик. Эта шаблонная строка должна соединиться
{x}
,{y}
,{z}
, и{scale}
заполнитель представляет в виде строки для упрощения создания URL для запроса надлежащей мозаики. Например, если у Вас есть сервер, продающий мозаики, когда Вы обеспечиваете URL формыhttp://myserver/tile?x=0&y=0&z=0&scale=1.0
, Вы указали бы шаблонную строкуhttp://myserver/tile?x={x}&y={y}&z={z}&scale={scale}
. Объект наложения мозаики заменяет фактическими индексными значениями в заполнителей Вашего шаблона прежде, чем запросить фактическую мозаику.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
Размер (в пикселях) Ваших изображений мозаики.
Обсуждение
На дисплеях Сетчатки изображения представляются пикселем для пикселя и не масштабируются. Это означает, что, если размер мозаики составляет 256 x 256 пикселей и масштабный коэффициент,
2.0
, изображение было бы представлено, как будто это были 128 x 128 точек в размере. Это поведение заставляет мозаику казаться меньшей, но сохраняет данные исходного изображения.Размер мозаики по умолчанию установлен в 256 x 256 пикселей.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
geometryFlipped geometryFlipped
СвойствоБулево значение, указывающее ориентацию индексов мозаики вдоль оси y.
Объявление
Swift
var geometryFlipped: Bool
Objective C
@property(getter=isGeometryFlipped) BOOL geometryFlipped
Обсуждение
Когда установлено в
NO
false
, индексы мозаики запускаются в верхнем левом углу карты и продолжаются вниз и вправо. Таким образом, мозаика в(0, 0)
находится в верхнем левом углу карты, мозаики в(1, 0)
к его непосредственному праву и мозаике в(0, 1)
сразу ниже его. Установка этого свойства кYES
true
заставляет карту запускать индексы в нижнем левом углу карты и продолжаться и вправо.Значение по умолчанию этого свойства
NO
false
.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Минимальный уровень изменения масштаба поддерживается мозаиками этого объекта наложения.
Обсуждение
При использовании различных объектов наложения для представления различных мозаик на различных уровнях изменения масштаба, используйте это свойство для указания минимального уровня изменения масштаба, поддерживаемого мозаиками этого наложения. На уровне 0 изменения масштаба мозаики покрывают карту всего мира; на уровне 1 изменения масштаба мозаики покрывают 1/4 мира; на уровне 2 изменения масштаба мозаики покрывают 1/16 мира и т.д. Карта никогда не пытается загрузить мозаики для уровня изменения масштаба меньше, чем значение, указанное этим свойством.
Значение по умолчанию этого свойства
0
.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
Максимальный уровень изменения масштаба поддерживается мозаиками этого объекта наложения.
Обсуждение
При использовании различных объектов наложения для представления различных мозаик на различных уровнях изменения масштаба, используйте это свойство для указания максимального уровня изменения масштаба, поддерживаемого мозаиками этого наложения. На уровне 0 изменения масштаба мозаики покрывают карту всего мира; на уровне 1 изменения масштаба мозаики покрывают 1/4 мира; на уровне 2 изменения масштаба мозаики покрывают 1/16 мира и т.д. Карта никогда не пытается загрузить мозаики для уровня изменения масштаба, больше, чем значение, указанное этим свойством.
Значение по умолчанию этого свойства равняется 21. Установка значения этого свойства к числу, больше, чем значение по умолчанию, не гарантирует использование тех дополнительных уровней изменения масштаба.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
canReplaceMapContent canReplaceMapContent
СвойствоБулево значение, указывающее, полностью непрозрачно ли содержание мозаики.
Объявление
Swift
var canReplaceMapContent: Bool
Objective C
@property(nonatomic) BOOL canReplaceMapContent
Обсуждение
Если содержание мозаики всю область получения непрозрачным содержанием, установить это свойство в, которое Вы обеспечиваете может покрыть
YES
true
. Выполнение так служит подсказкой к представлению карты, что оно не должно рисовать дополнительное содержание под Вашими мозаиками. Установите это свойство вNO
false
если Ваши мозаики содержат прозрачность.Значение по умолчанию для этого свойства
NO
false
.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
URLTemplate URLTemplate
СвойствоШаблон для генерации мозаики отображает URLs. (только для чтения)
Объявление
Swift
var URLTemplate: String! { get }
Objective C
@property(readonly) NSString *URLTemplate
Обсуждение
Во время инициализации Вы указываете эту строку.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
Возвращает URL для использования для доступа к указанной мозаике.
Объявление
Swift
func URLForTilePath(_
path
: MKTileOverlayPath) -> NSURL!Objective C
- (NSURL *)URLForTilePath:(MKTileOverlayPath)
path
Параметры
path
Структура пути, идентифицирующая определенную мозаику, которую Вы хотите. Эта структура включает координату X-Y мозаики на данном уровне изменения масштаба и масштабном коэффициенте.
Возвращаемое значение
URL для использования для получения мозаики.
Обсуждение
Реализация по умолчанию этого метода использует шаблонную строку, которую Вы обеспечили во время инициализации для создания URL к указанному изображению мозаики. Подклассы могут переопределить этот метод и использовать различную схему обеспечить URLs для мозаик. Мозаики могут быть расположены или в локальной файловой системе или в удаленном сервере.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
Загружает указанную мозаику асинхронно.
Объявление
Параметры
path
Структура пути, идентифицирующая определенную мозаику, которую Вы хотите. Эта структура включает координату X-Y мозаики на данном уровне изменения масштаба и масштабном коэффициенте.
result
Блок завершения для вызова, когда данные мозаики доступны. Этот блок выполняется на основном потоке Вашего приложения и берет следующие параметры:
tileData
параметр содержит необработанные данные, загруженные из соответствующего файла образа. Можно использовать эти данные для инициализации объекта изображения. Если ошибка произошла, этот параметрnil
.error
если была проблема, загружающая изображение мозаики, параметр содержит ошибочный объект. Если никакие ошибки не произошли, этот параметрnil
.
Обсуждение
Реализация по умолчанию этого метода использует
URLForTilePath:
метод для получения URL для указанной мозаики и затем загружает ту мозаику в память асинхронно с помощьюNSURLConnection
объект. Указанная мозаика может быть расположена или в локальной файловой системе или в удаленном сервере. Подклассы могут переопределить этот метод и реализовать их собственное загружающее мозаику поведение.Когда средство рендеринга наложения мозаики (т.е. экземпляр
MKTileOverlayRenderer
) потребности вывести на экран мозаики, это использует этот метод, чтобы запросить данные для каждой мозаики.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.