Ссылка функций MapKit
Этот документ описывает функции, найденные в платформе Набора Карты.
-
Создает новое
MKCoordinateSpan
от указанных значений.Объявление
Swift
func MKCoordinateSpanMake(_
latitudeDelta
: CLLocationDegrees, _longitudeDelta
: CLLocationDegrees) -> MKCoordinateSpanObjective C
MKCoordinateSpan MKCoordinateSpanMake ( CLLocationDegrees latitudeDelta, CLLocationDegrees longitudeDelta );
Параметры
latitudeDelta
Сумма севера на юг расстояние (измеренный в градусах) для использования для промежутка. В отличие от продольных расстояний, варьирующихся на основе широты, один градус широты составляет приблизительно 111 километров (69 миль) в любом случае.
longitudeDelta
Сумма востока на запад расстояние (измеренный в градусах) для использования для промежутка. Число километров, заполненных диапазоном долготы, варьируется на основе текущей широты. Например, один градус долготы охватывает расстояние приблизительно 111 километров (69 миль) на экватор, но уменьшается к 0 километрам в полюсах.
Возвращаемое значение
Промежуток с указанными значениями дельты.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Создает новое
MKCoordinateRegion
от указанной координаты и значений промежутка.Объявление
Swift
func MKCoordinateRegionMake(_
centerCoordinate
: CLLocationCoordinate2D, _span
: MKCoordinateSpan) -> MKCoordinateRegionObjective C
MKCoordinateRegion MKCoordinateRegionMake ( CLLocationCoordinate2D centerCoordinate, MKCoordinateSpan span );
Параметры
centerCoordinate
Центральная точка области.
span
Горизонтальный и вертикальный промежуток, представляющий сумму карты для отображения. Размер промежутка также отражает текущий уровень изменения масштаба.
Возвращаемое значение
Область с указанными значениями.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Создает новое
MKCoordinateRegion
от указанной координаты и значений расстояния.Объявление
Swift
func MKCoordinateRegionMakeWithDistance(_
centerCoordinate
: CLLocationCoordinate2D, _latitudinalMeters
: CLLocationDistance, _longitudinalMeters
: CLLocationDistance) -> MKCoordinateRegionObjective C
MKCoordinateRegion MKCoordinateRegionMakeWithDistance ( CLLocationCoordinate2D centerCoordinate, CLLocationDistance latitudinalMeters, CLLocationDistance longitudinalMeters );
Параметры
centerCoordinate
Центральная точка новой координатной области.
latitudinalMeters
Сумма севера на юг расстояние (измеренный в метрах) для использования для промежутка.
longitudinalMeters
Сумма востока на запад расстояние (измеренный в метрах) для использования для промежутка.
Возвращаемое значение
Область с указанными значениями.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Создает новое
MKMapPoint
структура от указанных значений.Объявление
Swift
func MKMapPointMake(_
x
: Double, _y
: Double) -> MKMapPointObjective C
MKMapPoint MKMapPointMake ( double x, double y );
Параметры
x
Точка вдоль оси восток - запад проекции карты.
y
Точка вперед между севером и югом оси проекции карты.
Возвращаемое значение
Точка карты с указанными значениями.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Создает новое
MKMapSize
структура от указанных значений.Объявление
Objective C
MKMapSize MKMapSizeMake ( double width, double height );
Параметры
width
Расстояние (измеренные точки карты использования) вдоль оси восток - запад проекции карты.
height
Расстояние (измеренные точки карты использования) вперед между севером и югом оси проекции карты.
Возвращаемое значение
Размер карты с указанными значениями.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Создает новое
MKMapRect
структура от указанных значений.Объявление
Objective C
MKMapRect MKMapRectMake ( double x, double y, double width, double height );
Параметры
x
Точка вдоль оси восток - запад проекции карты для использования для источника.
y
Точка вперед между севером и югом оси проекции карты для использования для источника.
width
Ширина прямоугольника (измеренные точки карты использования).
height
Высота прямоугольника (измеренные точки карты использования).
Возвращаемое значение
Прямоугольник карты с указанными значениями.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращается карта указывают на структуру данных, соответствующую указанной координате.
Объявление
Swift
func MKMapPointForCoordinate(_
coordinate
: CLLocationCoordinate2D) -> MKMapPointObjective C
MKMapPoint MKMapPointForCoordinate ( CLLocationCoordinate2D coordinate );
Параметры
coordinate
Координата, содержащая широту и долготу, оценивает за желаемую точку.
Возвращаемое значение
Значение точки карты, соответствующее указанной координате на двумерной проекции карты.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает широту и долготу, соответствующую указанной точке карты.
Объявление
Swift
func MKCoordinateForMapPoint(_
mapPoint
: MKMapPoint) -> CLLocationCoordinate2DObjective C
CLLocationCoordinate2D MKCoordinateForMapPoint ( MKMapPoint mapPoint );
Параметры
mapPoint
Значение точки карты, соответствующее желаемой точке на двумерной проекции карты.
Возвращаемое значение
Координатная структура, содержащая широту и долготу, оценивает за указанную точку.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает область, соответствующую указанному прямоугольнику карты.
Объявление
Swift
func MKCoordinateRegionForMapRect(_
rect
: MKMapRect) -> MKCoordinateRegionObjective C
MKCoordinateRegion MKCoordinateRegionForMapRect ( MKMapRect rect );
Параметры
rect
Прямоугольник карты, соответствующий желаемой области на двумерной проекции карты.
Возвращаемое значение
Структура области, указывающая широту, долготу и промежуток, оценивает за указанный прямоугольник.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает расстояние, заполненное одной точкой карты в указанной широте.
Объявление
Swift
func MKMetersPerMapPointAtLatitude(_
latitude
: CLLocationDegrees) -> CLLocationDistanceObjective C
CLLocationDistance MKMetersPerMapPointAtLatitude ( CLLocationDegrees latitude );
Параметры
latitude
Широта, для которой можно возвратить значение.
Возвращаемое значение
Расстояние (в метрах) заполненный единственной точкой карты.
Обсуждение
Расстояние между уменьшениями точек карты как широта приближается к полюсам. Это отношение параллельно отношению между продольными координатами в различных широтах.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает число точек карты, представляющих один метр в данной широте.
Объявление
Swift
func MKMapPointsPerMeterAtLatitude(_
latitude
: CLLocationDegrees) -> DoubleObjective C
double MKMapPointsPerMeterAtLatitude ( CLLocationDegrees latitude );
Параметры
latitude
Широта, для которой можно возвратить значение.
Возвращаемое значение
Число карты указывает на тот промежуток один метр.
Обсуждение
Число точек карты на увеличения метра как широта приближается к полюсам.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает число метров между двумя точками карты.
Объявление
Swift
func MKMetersBetweenMapPoints(_
a
: MKMapPoint, _b
: MKMapPoint) -> CLLocationDistanceObjective C
CLLocationDistance MKMetersBetweenMapPoints ( MKMapPoint a, MKMapPoint b );
Параметры
a
Первая точка карты.
b
Вторая точка карты.
Возвращаемое значение
Число метров между указанными точками карты.
Обсуждение
Это расстояние отражает фактическое расстояние между двумя точками на поверхности земного шара, принимая во внимание искривление Земли.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает ширину (в экранных точках) дорог на карте на указанном уровне изменения масштаба.
Объявление
Swift
func MKRoadWidthAtZoomScale(_
zoomScale
: MKZoomScale) -> CGFloatObjective C
CGFloat MKRoadWidthAtZoomScale ( MKZoomScale zoomScale );
Параметры
zoomScale
Масштабный коэффициент в настоящее время применялся к представлению карты.
Возвращаемое значение
Ширина дорог, измеренных в экранных точках. Можно использовать возвращенное значение для установки ширины строк в коде для прорисовки, прослеживающем путь дороги.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает минимальное значение оси X указанного прямоугольника.
Объявление
Objective C
double MKMapRectGetMinX ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Минимальное значение оси X.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает минимальное значение оси y указанного прямоугольника.
Объявление
Objective C
double MKMapRectGetMinY ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Минимальное значение оси y.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает среднюю точку вдоль оси X указанного прямоугольника.
Объявление
Objective C
double MKMapRectGetMidX ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Значение средней точки вдоль оси X.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает среднюю точку вдоль оси y указанного прямоугольника.
Объявление
Objective C
double MKMapRectGetMidY ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Значение средней точки вдоль оси y.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает максимальное значение оси X указанного прямоугольника.
Объявление
Objective C
double MKMapRectGetMaxX ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Максимальное значение оси X.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает максимальное значение оси y указанного прямоугольника.
Объявление
Objective C
double MKMapRectGetMaxY ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Максимальное значение оси y.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает ширину прямоугольника карты.
Объявление
Objective C
double MKMapRectGetWidth ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Ширина прямоугольника.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает высоту прямоугольника карты.
Объявление
Objective C
double MKMapRectGetHeight ( MKMapRect rect );
Параметры
rect
Прямоугольник карты для тестирования.
Возвращаемое значение
Высота прямоугольника.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булево значение, указывающее, равны ли две точки карты.
Объявление
Swift
func MKMapPointEqualToPoint(_
point1
: MKMapPoint, _point2
: MKMapPoint) -> BoolObjective C
BOOL MKMapPointEqualToPoint ( MKMapPoint point1, MKMapPoint point2 );
Параметры
point1
Первая точка карты.
point2
Вторая точка.
Возвращаемое значение
YES
true
еслиx
иy
значения в обеих точках являются точно тем же илиNO
false
если одно или оба значения отличаются.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булево значение, указывающее, равны ли два размера карты.
Объявление
Параметры
size1
Первый размер карты.
size2
Второй размер карты.
Возвращаемое значение
YES
true
еслиwidth
иheight
значения в обоих размерах являются точно тем же илиNO
false
если одно или оба значения отличаются.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булево значение, указывающее, равны ли два прямоугольника карты
Объявление
Параметры
rect1
Первый прямоугольник карты.
rect2
Второй прямоугольник карты.
Возвращаемое значение
YES
true
если прямоугольники являются точно тем же илиNO
false
если точка источника или значения размера отличаются.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булево значение, указывающее, находится ли указанная точка карты в прямоугольнике.
Объявление
Swift
func MKMapRectContainsPoint(_
rect
: MKMapRect, _point
: MKMapPoint) -> BoolObjective C
BOOL MKMapRectContainsPoint ( MKMapRect rect, MKMapPoint point );
Параметры
rect
Протестированный прямоугольник карты.
point
Точка для проверки.
Возвращаемое значение
YES
true
если прямоугольник не является нулем или пустой, и точка расположена в прямоугольнике; иначе,NO
false
.Обсуждение
Если его координаты лежат в прямоугольнике или на минимуме X или минимуме Y край, точка считается в прямоугольнике.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Булево значение возвратов, указывающее, содержит ли один прямоугольник другого.
Объявление
Параметры
rect1
Содержание прямоугольника.
rect2
Прямоугольник, который мог бы содержаться в
rect1
.Возвращаемое значение
YES
true
еслиrect2
нуль или находится полностью внутриrect1
; иначе, возвратыNO
false
еслиrect1
нуль или не полностью включаетrect2
.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булево значение, указывающее, пересекают ли два прямоугольника друг друга.
Объявление
Параметры
rect1
Первый прямоугольник, который протестирует.
rect2
Второй прямоугольник для тестирования.
Возвращаемое значение
YES
true
еслиrect1
иrect2
пересеките друг друга илиNO
false
если они не пересекаются, или любой прямоугольник является нулем.Обсуждение
Если единственное пересечение происходит вдоль края, прямоугольники не считаются, пересекаясь. Чтобы считаться истинным пересечением, прямоугольники должны и включить единственную прямоугольную область, ширина которой и высота оба больше, чем
0
.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булевскую переменную, указывающую, является ли указанный прямоугольник нулем.
Объявление
Swift
func MKMapRectIsNull(_
rect
: MKMapRect) -> BoolObjective C
BOOL MKMapRectIsNull ( MKMapRect rect );
Параметры
rect
Прямоугольник для тестирования.
Возвращаемое значение
YES
true
если прямоугольник является нулем илиNO
false
если это не нуль.Обсуждение
Если его точка источника содержит недопустимое или бесконечное значение, прямоугольник считают нулем.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булево значение, указывающее, не имеет ли указанный прямоугольник никакой области.
Объявление
Swift
func MKMapRectIsEmpty(_
rect
: MKMapRect) -> BoolObjective C
BOOL MKMapRectIsEmpty ( MKMapRect rect );
Параметры
rect
Прямоугольник для тестирования.
Возвращаемое значение
YES
true
если прямоугольник является нулем, или его ширина или высота равны 0; иначе,NO
false
.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает прямоугольник, представляющий объединение этих двух прямоугольников.
Объявление
Параметры
rect1
Первый прямоугольник.
rect2
Второй прямоугольник.
Возвращаемое значение
Прямоугольник, область которого охватывает эти два прямоугольника и пространство между ними.
Обсуждение
Если любой прямоугольник является нулем, этот метод возвращает другой прямоугольник. Точка источника возвращенного прямоугольника установлена в меньшие из значений x и y для этих двух прямоугольников. Точно так же размер и ширина прямоугольника вычислены путем принятия максимальные значения x и y и вычитания значений x и y для новой точки источника.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает прямоугольник, представляющий пересечение двух прямоугольников.
Объявление
Параметры
rect1
Первый прямоугольник.
rect2
Второй прямоугольник.
Возвращаемое значение
Прямоугольник, представляющий пересечение этих двух прямоугольников или
MKMapRectNull
если нет никакого пересечения.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает указанный прямоугольник, вставленный указанными суммами.
Объявление
Параметры
rect
Исходный прямоугольник.
dx
Сумма (в точках карты) для вычитания из обеих сторон вдоль оси X.
dy
Сумма (в точках карты) для вычитания из обеих сторон вдоль оси y.
Возвращаемое значение
Прямоугольник вставки. Если исходный прямоугольник был нулем, тот прямоугольник возвращается вместо этого.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает прямоугольник, точка источника которого смещается на указанную сумму.
Объявление
Параметры
rect
Исходный прямоугольник.
dx
Сумма (в точках карты), на который можно сместить x-координату точки источника.
dy
Сумма (в точках карты), на который можно сместить y-координату точки источника.
Возвращаемое значение
Прямоугольник смещения. Если исходный прямоугольник был нулем, тот прямоугольник возвращается вместо этого.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Делит указанный прямоугольник на два меньших прямоугольника.
Объявление
Swift
func MKMapRectDivide(_
rect
: MKMapRect, _slice
: UnsafeMutablePointer<MKMapRect>, _remainder
: UnsafeMutablePointer<MKMapRect>, _amount
: Double, _edge
: CGRectEdge)Objective C
void MKMapRectDivide ( MKMapRect rect, MKMapRect *slice, MKMapRect *remainder, double amount, CGRectEdge edge );
Параметры
rect
Прямоугольник для деления.
slice
На вводе, указателе на прямоугольник карты. На выводе этот параметр содержит часть
rect
это было удалено.remainder
На вводе, указателе на прямоугольник карты. На выводе этот параметр содержит остающуюся часть
rect
это не было удалено.amount
Сумма
rect
удалить вдоль указанного края. Если это значение отрицательно, оно установлено в0
.edge
Край, из которого можно удалить указанную сумму.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает отформатированную строку для указанной точки карты.
Объявление
Swift
func MKStringFromMapPoint(_
point
: MKMapPoint) -> String!Objective C
NSString * MKStringFromMapPoint ( MKMapPoint point );
Параметры
point
Точка карты для форматирования.
Возвращаемое значение
Отформатированная строка, содержащая координаты x и y точки карты.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает отформатированную строку для указанного размера карты.
Объявление
Параметры
size
Размер карты для форматирования.
Возвращаемое значение
Отформатированная строка, содержащая значения ширины и высоты размера карты.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает отформатированную строку для указанного прямоугольника карты.
Объявление
Параметры
rect
Прямоугольник карты для форматирования.
Возвращаемое значение
Отформатированная строка, содержащая источник и значения размера прямоугольника карты.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает булево значение, указывающее, пересекает ли указанный прямоугольник карты 180-й меридиан.
Объявление
Swift
func MKMapRectSpans180thMeridian(_
rect
: MKMapRect) -> BoolObjective C
BOOL MKMapRectSpans180thMeridian ( MKMapRect rect );
Параметры
rect
Прямоугольник для тестирования.
Возвращаемое значение
YES
true
если прямоугольник охватывает 180-й меридиан илиNO
false
если это содержится полностью в мировой карте.Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.
-
Нормализует часть указанного прямоугольника, находящегося вне мировых границ карты.
Объявление
Параметры
rect
Прямоугольник для проверки.
Обсуждение
Для прямоугольника, находящегося на 180-м меридиане, эта функция изолирует часть, находящуюся вне границы, обертки это к противоположной стороне карты и возвраты тот прямоугольник.
Оператор импорта
Objective C
@import MapKit;
Swift
import MapKit
Доступность
Доступный в OS X v10.9 и позже.