Обзор
Это основной класс SDK Google Maps для iOS и точка входа для всех методов, связанных с картой.
Карта должна быть создана с помощью удобного конструктора [ GMSMapView mapWithFrame:camera:]. Он также может быть создан с помощью метода по умолчанию [[ GMSMapView alloc] initWithFrame:] (при этом его камера будет установлена в положение по умолчанию).
GMSMapView можно читать и изменять только из основного потока, как и все объекты UIKit. Вызов этих методов из другого потока приведет к исключению или неопределенному поведению.
Общедоступные функции-члены | |
| (тип экземпляра) | - initWithFrame: камера: |
| Создает и возвращает представление карты с рамкой и целью камеры. | |
| (тип экземпляра) | - initWithFrame:ID_карты:камера: |
| Создает и возвращает представление карты с рамкой, идентификатором карты и целью камеры. | |
| (пустота) | - начать рендеринг |
| Сообщает этой карте включить ее визуализатор. | |
| (пустота) | - остановить рендеринг |
| Сообщает этой карте, чтобы она отключила свой рендерер. | |
| (пустота) | - ясно |
| Удаляет всю разметку, добавленную на карту, включая маркеры, полилинии и наложения на землю. | |
| (пустота) | - установитьMinZoom:maxZoom: |
Устанавливает minZoom и maxZoom . | |
| (обнуляемый GMSCameraPosition *) | - камераForBounds: вставки: |
Создайте GMSCameraPosition , который представляет bounds с padding . | |
| (пустота) | - переместить камеру: |
Изменяет камеру в соответствии с update . | |
| (BOOL) | - areEqualForRenderingPosition:position: |
| Проверьте, приведут ли данные положения камеры к тому, чтобы камера практически отображалась одинаково, принимая во внимание уровень точности и внутренних преобразований. | |
| (пустота) | - анимироватьToCameraPosition: |
Анимирует камеру этой карты в cameraPosition . | |
| (пустота) | - анимировать в местоположении: |
То же, что и animateToCameraPosition:, но изменяет только положение камеры (т. е. с текущего местоположения на location ). | |
| (пустота) | - анимироватьToZoom: |
| Как animateToCameraPosition:, но изменяет только уровень масштабирования камеры. | |
| (пустота) | - анимировать подшипник: |
| Как animateToCameraPosition:, но изменяет только направление камеры (в градусах). | |
| (пустота) | - анимироватьToViewingAngle: |
| Как animateToCameraPosition:, но изменяет только угол обзора камеры (в градусах). | |
| (пустота) | - анимироватьWithCameraUpdate: |
Применяет cameraUpdate к текущей камере, а затем использует результат согласно animateToCameraPosition:. | |
Статические общедоступные функции-члены | |
| (тип экземпляра) | + карта с фреймом: камера: |
| Создает и возвращает представление карты с рамкой и целью камеры. | |
| (тип экземпляра) | + mapWithFrame:mapID:камера: |
| Удобный инициализатор для создания и возврата представления карты с рамкой, идентификатором карты и целью камеры. | |
Характеристики | |
| Идентификатор IBOutlet <GMSMapViewDelegate> | делегировать |
| Делегат GMSMapView . | |
| GMSCameraPosition * | камера |
| Управляет камерой, которая определяет ориентацию карты. | |
| Проекция GMS * | проекция |
| Возвращает объект GMSProjection , который можно использовать для преобразования экранных координат в координаты широты/долготы. | |
| BOOL | myLocationEnabled |
| Определяет, включена ли точка «Мое местоположение» и круг точности. | |
| CLРасположение * | мое местонахождение |
| Если функция «Мое местоположение» включена, показывает, где рисуется точка местоположения устройства. | |
| GMSМаркер * | выбранный маркер |
| Выбранный маркер. | |
| BOOL | trafficEnabled |
| Определяет, будет ли карта отображать данные о трафике, если они доступны. | |
| GSMapViewType | тип карты |
| Управляет типом фрагментов карты, которые должны отображаться. | |
| GSMapStyle * | картаСтиль |
| Управляет стилем карты. | |
| плавать | минУвеличить |
| Минимальный зум (максимальное удаление камеры). | |
| плавать | максзум |
| Максимальный зум (самый близкий к Земле). | |
| BOOL | зданияВключено |
| Если установлено, 3D-здания будут отображаться там, где они доступны. | |
| BOOL | крытыйВключен |
| Устанавливает, будут ли отображаться карты помещений, если они доступны. | |
| GMSIndoorDisplay * | в помещенииДисплей |
| Получает экземпляр GMSIndoorDisplay , который позволяет наблюдать за аспектами отображения данных в помещении или управлять ими. | |
| Настройки GMSUI * | настройки |
| Получает объект GMSUISettings , который управляет настройками пользовательского интерфейса для карты. | |
| UIEdgeInsets | набивка |
| Управляет «видимой» областью представления. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Управляет тем, как вставки безопасной области добавляются к значениям заполнения. | |
| BOOL | доступностьЭлементыСкрытый |
| По умолчанию ДА. | |
| GMSMapLayer * | слой |
| Средство доступа для пользовательского типа CALayer, используемого для слоя. | |
| GMFrameRate | предпочитаемая частота кадров |
| Управляет частотой кадров рендеринга. | |
| GMSCoordinateBounds * | камераTargetBounds |
| Если не ноль, ограничивает цель камеры, чтобы жесты не могли заставить ее выйти за указанные границы. | |
| GSMapCapabilityFlags | mapВозможности |
| Все условно-доступные (зависящие от mapID или других настроек карты) возможности, доступные в текущий момент времени. | |
Связанные функции | |
(Обратите внимание, что это не функции-члены.) | |
| NSString * константа | kGMSAccessibilityCompass |
| Идентификатор доступности для кнопки компаса. | |
| NSString * константа | kGMSAccessibilityMyLocation |
| Идентификатор доступности для кнопки «Мое местоположение». | |
| NSString * константа | kGMSAccessibilityOutOfQuota |
| Идентификатор доступности для метки ошибки "вне квоты". | |
Документация по функциям-членам
| + (тип экземпляра) mapWithFrame: | (CGRect) | рамка | |
| камера: | ( GMSCameraPosition *) | камера | |
Создает и возвращает представление карты с рамкой и целью камеры.
| + (тип экземпляра) mapWithFrame: | (CGRect) | рамка | |
| ID карты: | ( GSMapID *) | идентификатор карты | |
| камера: | ( GMSCameraPosition *) | камера | |
Удобный инициализатор для создания и возврата представления карты с рамкой, идентификатором карты и целью камеры.
| - (тип экземпляра) initWithFrame: | (CGRect) | рамка | |
| камера: | ( GMSCameraPosition *) | камера | |
Создает и возвращает представление карты с рамкой и целью камеры.
| - (тип экземпляра) initWithFrame: | (CGRect) | рамка | |
| ID карты: | ( GSMapID *) | идентификатор карты | |
| камера: | ( GMSCameraPosition *) | камера | |
Создает и возвращает представление карты с рамкой, идентификатором карты и целью камеры.
| - (пусто) startRendering |
Сообщает этой карте включить ее визуализатор.
Это необязательно и идемпотентно.
- Примечание:
- Это устарело. Этот метод устарел и будет удален в будущем выпуске.
| - (void) остановить рендеринг |
Сообщает этой карте, чтобы она отключила свой рендерер.
Это необязательно и идемпотентно.
- Примечание:
- Это устарело. Этот метод устарел и будет удален в будущем выпуске.
| - (пусто) очистить |
Удаляет всю разметку, добавленную на карту, включая маркеры, полилинии и наложения на землю.
Это не приведет к удалению видимой точки местоположения или сбросу текущего типа карты.
| - (недействительно) setMinZoom: | (плавать) | минУвеличить | |
| максимальное увеличение: | (плавать) | максзум | |
Устанавливает minZoom и maxZoom .
Этот метод ожидает, что минимум будет меньше или равен максимуму, и в противном случае выдаст исключение с именем NSRangeException.
| - (обнуляемый GMSCameraPosition *) cameraForBounds: | ( GMSCoordinateBounds *) | границы | |
| вставки: | (UIEdgeInsets) | вставки | |
Создайте GMSCameraPosition , который представляет bounds с padding .
Камера будет иметь нулевой пеленг и наклон (т. е. смотреть на север и смотреть прямо на Землю). При этом учитываются кадр и заполнение этого GMSMapView .
Если границы недействительны, этот метод вернет нулевую камеру.
| - (недействительно) moveCamera: | ( Обновление GMSCamera *) | обновлять |
Изменяет камеру в соответствии с update .
Смена камеры происходит мгновенно (без анимации).
| - (BOOL) areEqualForRenderingPosition: | ( GMSCameraPosition *) | позиция | |
| позиция: | ( GMSCameraPosition *) | другая позиция | |
Проверьте, приведут ли данные положения камеры к тому, чтобы камера практически отображалась одинаково, принимая во внимание уровень точности и внутренних преобразований.
| - (void) анимироватьToCameraPosition: | ( GMSCameraPosition *) | камераПоложение |
Анимирует камеру этой карты в cameraPosition .
| - (void) анимироватьToLocation: | (CLLocationCoordinate2D) | расположение |
То же, что и animateToCameraPosition:, но изменяет только положение камеры (т. е. с текущего местоположения на location ).
| - (void) анимироватьToZoom: | (плавать) | зум |
Как animateToCameraPosition:, но изменяет только уровень масштабирования камеры.
Это значение ограничивается [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (void) анимироватьToBearing: | (КЛлокатиондиректион) | несущий |
Как animateToCameraPosition:, но изменяет только направление камеры (в градусах).
Ноль указывает на истинный север.
| - (void) анимироватьToViewingAngle: | (двойной) | угол обзора |
Как animateToCameraPosition:, но изменяет только угол обзора камеры (в градусах).
Это значение будет ограничено минимумом до нуля (т. е. если смотреть прямо вниз) и между 30 и 45 градусами по направлению к горизонту, в зависимости от относительной близости к земле.
| - (void) анимироватьWithCameraUpdate: | ( Обновление GMSCamera *) | камераОбновить |
Применяет cameraUpdate к текущей камере, а затем использует результат согласно animateToCameraPosition:.
Друзья и связанная с ними документация по функциям
- (NSString* const) kGMSAccessibilityCompass [related] |
Идентификатор доступности для кнопки компаса.
- (NSString* const) kGMSAccessibilityMyLocation [related] |
Идентификатор доступности для кнопки «Мое местоположение».
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
Идентификатор доступности для метки ошибки "вне квоты".
Документация по недвижимости
- (IBOutlet id <GMSMapViewDelegate> ) делегат [read, write, assign] |
Делегат GMSMapView .
- ( GMSCameraPosition *) камера [read, write, copy] |
Управляет камерой, которая определяет ориентацию карты.
Изменение этого свойства происходит мгновенно.
- ( GMSProjection *) проекция [read, assign] |
Возвращает объект GMSProjection , который можно использовать для преобразования экранных координат в координаты широты/долготы.
Это снимок текущей проекции, который не будет автоматически обновляться при перемещении камеры. Он представляет либо проекцию последнего нарисованного кадра GMSMapView , либо; там, где явно установлена камера или только что создана карта, предстоящий кадр. Оно никогда не будет равным нулю.
- (BOOL) myLocationEnabled [read, write, assign] |
Определяет, включена ли точка «Мое местоположение» и круг точности.
По умолчанию НЕТ.
- (CLLocation*) myLocation [read, assign] |
Если функция «Мое местоположение» включена, показывает, где рисуется точка местоположения устройства.
Если он отключен или включен, но данные о местоположении недоступны, это будет нуль. Это свойство можно наблюдать с помощью KVO.
- ( GMSMarker *) selectedMarker [read, write, assign] |
Выбранный маркер.
Установка этого свойства выбирает конкретный маркер, показывая информационное окно о нем. Если это свойство не равно нулю, установка его в nil отменяет выбор маркера, скрывая информационное окно. Это свойство можно наблюдать с помощью KVO.
- (BOOL) trafficEnabled [read, write, assign] |
Определяет, будет ли карта отображать данные о трафике, если они доступны.
Это зависит от наличия данных о трафике. По умолчанию НЕТ.
- ( GMSMapViewType ) mapType [read, write, assign] |
Управляет типом фрагментов карты, которые должны отображаться.
По умолчанию используется kGMSTypeNormal.
- ( GMSMapStyle *) mapStyle [read, write, assign] |
Управляет стилем карты.
Ненулевой mapStyle будет применяться только в том случае, если mapType имеет значение Normal.
- (плавающая) minZoom [read, assign] |
Минимальный зум (максимальное удаление камеры).
По умолчанию kGMSMinZoomLevel. Изменено с помощью -setMinZoom:maxZoom:.
- (с плавающей запятой) maxZoom [read, assign] |
Максимальный зум (самый близкий к Земле).
По умолчанию kGMSMaxZoomLevel. Изменено с помощью -setMinZoom:maxZoom:.
- (BOOL) buildingEnabled [read, write, assign] |
Если установлено, 3D-здания будут отображаться там, где они доступны.
По умолчанию ДА.
Это может быть полезно при добавлении пользовательского слоя листов на карту, чтобы сделать его более четким при больших уровнях масштабирования. Изменение этого значения приведет к тому, что все плитки на короткое время станут недействительными.
- (BOOL) doorEnabled [read, write, assign] |
Устанавливает, будут ли отображаться карты помещений, если они доступны.
По умолчанию ДА.
Если для этого параметра установлено значение NO, кэши для внутренних данных могут быть очищены, а любой этаж, выбранный в данный момент конечным пользователем, может быть сброшен.
- ( GMSIndoorDisplay *) doorDisplay [read, assign] |
Получает экземпляр GMSIndoorDisplay , который позволяет наблюдать за аспектами отображения данных в помещении или управлять ими.
- ( GMSUISettings *) настройки [read, assign] |
Получает объект GMSUISettings , который управляет настройками пользовательского интерфейса для карты.
- (UIEdgeInsets) заполнение [read, write, assign] |
Управляет «видимой» областью представления.
Применяя отступы, можно создать область вокруг края представления, которая будет содержать данные карты, но не будет содержать элементы управления пользовательского интерфейса.
Если заполнение не сбалансировано, визуальный центр представления будет перемещаться соответствующим образом. Заполнение также повлияет на свойство projection , поэтому видимая область не будет включать область заполнения. GMSCameraUpdate fitToBounds гарантирует, что как это заполнение, так и любое запрошенное заполнение будут приняты во внимание.
Это свойство может быть анимировано в блоке анимации на основе UIView.
- ( GMSMapViewPaddingAdjustmentBehavior ) paddingAdjustmentBehavior [read, write, assign] |
Управляет тем, как вставки безопасной области добавляются к значениям заполнения.
Как и отступы, безопасная область вставляет элементы управления картой положения, такие как компас, кнопку моего местоположения и средство выбора пола, в безопасной области устройства.
По умолчанию используется kGMSMapViewPaddingAdjustmentBehaviorAlways.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
По умолчанию ДА.
Если установлено значение NO, GMSMapView будет генерировать элементы специальных возможностей для объектов наложения, таких как GMSMarker и GMSPolyline .
Это свойство следует неофициальному протоколу UIAccessibility, за исключением значения по умолчанию YES.
- ( GMSMapLayer *) слой [read, retain] |
Средство доступа для пользовательского типа CALayer, используемого для слоя.
- ( GMSFrameRate ) PreferredFrameRate [read, write, assign] |
Управляет частотой кадров рендеринга.
Значение по умолчанию — kGMSFrameRateMaximum.
- ( GMSCoordinateBounds *) cameraTargetBounds [read, write, assign] |
Если не ноль, ограничивает цель камеры, чтобы жесты не могли заставить ее выйти за указанные границы.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Все условно-доступные (зависящие от mapID или других настроек карты) возможности, доступные в текущий момент времени.
Не включает всегда доступные возможности.