Обзор
Маркер — это значок, размещаемый в определенной точке поверхности карты.
Значок маркера рисуется ориентированным на экран устройства, а не на поверхность карты; т. е. он не обязательно изменит ориентацию из-за поворота, наклона или масштабирования карты.
Наследует GMSOverlay .
Унаследовано GMSAdvancedMarker .
Статические открытые функции-члены | |
(тип экземпляра) | + маркер с позицией: |
Удобный конструктор для маркера по умолчанию. | |
(UIImage *) | + маркерImageWithColor: |
Создает тонированную версию изображения маркера по умолчанию для использования в качестве значка. | |
Характеристики | |
CLLocationCoordinate2D | позиция |
Положение маркера. | |
NSString * | фрагмент |
Текст фрагмента, отображаемый под заголовком в информационном окне при выборе. | |
UIImage * | икона |
Значок маркера для рендеринга. | |
UIView * | значокПросмотр |
Представление маркера для рендеринга. | |
БООЛ | трекиПросмотретьИзменения |
Определяет, должен ли значок этого маркера перерисовываться каждый кадр. | |
БООЛ | трекиИнформацияWindowChanges |
Определяет, должно ли информационное окно для этого маркера перерисовываться каждый кадр. | |
CGPoint | земляЯкорь |
Привязка к земле определяет точку на изображении значка, которая привязана к положению маркера на поверхности Земли. | |
CGPoint | информацияWindowAnchor |
Привязка информационного окна определяет точку на изображении значка, к которой можно привязать информационное окно, которое будет отображаться непосредственно над этой точкой. | |
GMSМаркерАнимация | появляютсяАнимация |
Управляет анимацией, используемой при размещении этого маркера в GMSMapView (по умолчанию kGMSMarkerAnimationNone, без анимации). | |
БООЛ | перетаскиваемый |
Определяет, можно ли перетаскивать этот маркер в интерактивном режиме (по умолчанию НЕТ). | |
БООЛ | плоский |
Определяет, должен ли этот маркер располагаться ровно на поверхности Земли (ДА) или на рекламном щите, обращенном к камере (НЕТ, по умолчанию). | |
CМестоположениеГрадусы | вращение |
Задает поворот маркера в градусах по часовой стрелке вокруг точки привязки маркера. | |
плавать | непрозрачность |
Устанавливает непрозрачность маркера от 0 (полностью прозрачный) до 1 (по умолчанию) включительно. | |
ГМСМаркерСлой * | слой |
Предоставляет базовый слой анимации для этого GMSMarker . | |
ГМСПанорамаВью * | панорамаПросмотр |
panoramaView указывает, какой панорамный вид попытается отобразить этот маркер. | |
NSString * | заголовок |
Название, краткое описание наложения. | |
GMSMapView * | карта |
Карта, на которой находится это наложение. | |
БООЛ | постукиваемый |
Если это наложение должно вызывать уведомления о касании. | |
интервал | zИндекс |
Наложения с более высоким значением zIndex будут отображаться поверх слоев и наложений плиток с более низким значением zIndex . | |
идентификатор | данные пользователя |
Наложение данных. |
Документация по функциям-членам
+ (тип экземпляра ) | (CLLocationCoordinate2D) | позиция |
Удобный конструктор для маркера по умолчанию.
+ (UIImage *) маркерImageWithColor: | (обнуляемый UIColor *) | цвет |
Создает тонированную версию изображения маркера по умолчанию для использования в качестве значка.
Документация на недвижимость
- (CLLocationCoordinate2D) позиция [read, write, assign] |
Положение маркера.
Анимированный.
- (NSString*) фрагмент [read, write, copy] |
Текст фрагмента, отображаемый под заголовком в информационном окне при выборе.
- Значок (UIImage*) [read, write, assign] |
Значок маркера для рендеринга.
Если оставить ноль, используется маркер места SDK по умолчанию.
Поддерживает анимированные изображения, но каждый кадр должен быть одинакового размера, иначе поведение будет неопределенным.
Поддерживает использование выравниванияRectInsets для указания уменьшенной области касания. Это также переопределяет способ указания якорей. Для анимированного изображения используется значение анимации, а не отдельные кадры.
- (UIView*) iconView [read, write, assign] |
Представление маркера для рендеринга.
Если оставить ноль, вместо этого возвращается к свойству icon
.
Поддерживает анимацию всех анимируемых свойств UIView, кроме frame
и center
. Изменение этих свойств или их соответствующей версии CALayer, включая position
, не поддерживается.
Обратите внимание, что представление ведет себя так, как будто для clipsToBounds
установлено значение YES, независимо от его фактического значения.
- (BOOL) trackViewChanges [read, write, assign] |
Определяет, должен ли значок этого маркера перерисовываться каждый кадр.
Обратите внимание: когда значение меняется с НЕТ на ДА, значок гарантированно будет перерисован в следующем кадре.
По умолчанию ДА. Не имеет никакого эффекта, если iconView
равен нулю.
- (BOOL) trackInfoWindowChanges [read, write, assign] |
Определяет, должно ли информационное окно для этого маркера перерисовываться каждый кадр.
Обратите внимание: когда значение меняется с НЕТ на ДА, информационное окно гарантированно будет перерисовано в следующем кадре.
По умолчанию НЕТ.
- (CGPoint) groundAnchor [read, write, assign] |
Привязка к земле определяет точку на изображении значка, которая привязана к положению маркера на поверхности Земли.
Эта точка указывается внутри непрерывного пространства [0,0, 1,0] x [0,0, 1,0], где (0,0) — верхний левый угол изображения, а (1,1) — нижний правый угол.
Если изображение имеет ненулевое выравниваниеRectInsets, верхний левый и нижний правый, упомянутые выше, относятся к разделу вставки изображения.
- (CGPoint) infoWindowAnchor [read, write, assign] |
Привязка информационного окна определяет точку на изображении значка, к которой можно привязать информационное окно, которое будет отображаться непосредственно над этой точкой.
Эта точка указывается в том же пространстве, что и groundAnchor.
- ( GMSMarkerAnimation ) появляютсяАнимация [read, write, assign] |
Управляет анимацией, используемой при размещении этого маркера в GMSMapView (по умолчанию kGMSMarkerAnimationNone, без анимации).
- (BOOL) перетаскиваемый [read, write, assign] |
Определяет, можно ли перетаскивать этот маркер в интерактивном режиме (по умолчанию НЕТ).
- (BOOL) плоский [read, write, assign] |
Определяет, должен ли этот маркер располагаться ровно на поверхности Земли (ДА) или на рекламном щите, обращенном к камере (НЕТ, по умолчанию).
- (CLLocationDegrees) вращение [read, write, assign] |
Задает поворот маркера в градусах по часовой стрелке вокруг точки привязки маркера.
Ось вращения перпендикулярна маркеру. Поворот 0 соответствует положению маркера по умолчанию. Анимированный.
Если маркер расположен ровно на карте, по умолчанию положение выравнивается по северу, а вращение такое, что маркер всегда остается плоским на карте. Если маркер представляет собой рекламный щит, его положение по умолчанию — направлен вверх, а вращение таково, что маркер всегда обращен к камере.
- (float) непрозрачность [read, write, assign] |
Устанавливает непрозрачность маркера от 0 (полностью прозрачный) до 1 (по умолчанию) включительно.
- ( GMSMarkerLayer *) слой [read, assign] |
Предоставляет базовый слой анимации для этого GMSMarker .
- ( GMSPanoramaView *) panoramaView [read, write, assign] |
panoramaView
указывает, какой панорамный вид попытается отобразить этот маркер.
Обратите внимание: если position
маркера находится слишком далеко от текущего местоположения панорамы panoramaView
, она не будет отображаться, поскольку будет слишком маленькой.
Можно установить на ноль, чтобы удалить маркер из любого текущего вида панорамы, к которому он прикреплен.
Маркер может отображаться одновременно и на панораме, и на карте.
- (NSString*) заголовок [read, write, copy, inherited] |
Название, краткое описание наложения.
Некоторые наложения, например маркеры, отображают заголовок на карте. Заголовок также является текстом специальных возможностей по умолчанию.
- ( GMSMapView *) карта [read, write, assign, inherited] |
Карта, на которой находится это наложение.
Установка этого свойства добавит наложение на карту. Установка значения nil удаляет это наложение с карты. Наложение может быть активным не более чем на одной карте в любой момент времени.
- (BOOL) тапируемый [read, write, assign, inherited] |
Если это наложение должно вызывать уведомления о касании.
Некоторые наложения, например маркеры, по умолчанию доступны для касания.
- (int) zIndex [read, write, assign, inherited] |
Наложения с более высоким значением zIndex
будут отображаться поверх слоев и наложений плиток с более низким значением zIndex
.
Равные значения приводят к неопределенному порядку отрисовки. Маркеры являются исключением: независимо от zIndex
они всегда будут рисоваться над слоями листов и другими наложениями, не являющимися маркерами; фактически они считаются отнесенными к отдельной группе z-index по сравнению с другими наложениями.
- (id) userData [read, write, assign, inherited] |
Наложение данных.
Вы можете использовать это свойство, чтобы связать с этим наложением произвольный объект. Google Maps SDK для iOS не читает и не записывает это свойство.
Обратите внимание, что пользовательские данные не должны содержать строгих ссылок на какие-либо объекты Maps, в противном случае может быть создан цикл сохранения (предотвращающий освобождение объектов).