Referência da classe GMSAdvancedMarker

Referência da classe GMSAdvancedMarker

Visão geral

Um marcador avançado é um ícone posicionado em um determinado ponto na superfície do mapa.

Herda GMSMarker.

Funções membro públicas estáticas

(instancetype)+ markerWithPosition:
 Construtor de conveniência para um marcador padrão.
(UIImage *)+ markerImageWithColor:
 Cria uma versão colorida da imagem do marcador padrão para usar como um ícone.

Propriedades

GMSCollisionBehaviorcollisionBehavior
 O comportamento em caso de conflito do marcador, que determina se a visibilidade dele pode ou não ser afetada por outros marcadores ou por conteúdo rotulado no mapa.
CLLocationCoordinate2Dposition
 Posição de Marker.
NSString * snippet
 Texto do snippet, mostrado abaixo do título na janela de informações quando selecionado.
UIImage * ícone
 Ícone de marcador a ser renderizado.
UIView * iconView
 Visualização do marcador a ser renderizada.
BOOLtracksViewChanges
 Controla se o ícone deste marcador deve ser redesenhado a cada frame.
BOOLtracksInfoWindowChanges
 Controla se a janela de informações deste marcador deve ser redesenhada a cada frame.
CGPointgroundAnchor
 A âncora de solo especifica o ponto na imagem do ícone que está ancorado à posição do marcador na superfície da Terra.
CGPointinfoWindowAnchor
 A âncora da janela de informações especifica o ponto na imagem do ícone no qual a janela de informações será ancorada, que será exibida diretamente acima desse ponto.
GMSMarkerAnimationappearAnimation
 Controla a animação usada quando este marcador é colocado em um GMSMapView (kGMSMarkerAnimationNone padrão, sem animação).
BOOLarrastar
 Controla se este marcador pode ser arrastado interativamente (não é padrão).
BOOLplano
 Controla se esse marcador deve ficar plano em relação à superfície da Terra (SIM) ou em um outdoor voltado para a câmera (NÃO, padrão).
CLLocationGrausrotação
 Define a rotação do marcador em graus no sentido horário em torno do ponto de fixação do marcador.
float opacidade
 Define a opacidade do marcador, entre 0 (completamente transparente) e 1 (padrão).
GMSMarkerLayercamada
 Fornece a camada Core Animation para este GMSMarker.
GMSPanoramaViewpanoramaView
 O panoramaView especifica qual visualização do panorama tentará mostrar esse marcador.
NSString * title
 Título, uma breve descrição da sobreposição.
GMSMapViewmap
 O mapa no qual esta sobreposição está.
BOOLacessível
 Se essa sobreposição deve gerar notificações de toque.
int zIndex
 Sobreposições de valores zIndex mais altos serão desenhadas sobre sobreposições e camadas de blocos com valores zIndex mais baixos.
iduserData
 Dados de sobreposição.

Documentação da função membro

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D) position

Construtor de conveniência para um marcador padrão.

+ (UIImage *) markerImageWithColor: (nullable UIColor *)  cor

Cria uma versão colorida da imagem do marcador padrão para usar como um ícone.


Documentação da propriedade

- (GMSCollisionBehavior) collisionBehavior [read, write, assign]

O comportamento em caso de conflito do marcador, que determina se a visibilidade dele pode ou não ser afetada por outros marcadores ou por conteúdo rotulado no mapa.

- (CLLocationCoordinate2D) posição [read, write, assign, inherited]

Posição de Marker.

Animado.

- (NSString*) snippet [read, write, copy, inherited]

Texto do snippet, mostrado abaixo do título na janela de informações quando selecionado.

- (UIImage*) ícone [read, write, assign, inherited]

Ícone de marcador a ser renderizado.

Se deixada como "nil", usa um marcador de lugar padrão do SDK.

Oferece suporte a imagens animadas, mas cada frame precisa ter o mesmo tamanho. Caso contrário, o comportamento não será definido.

Compatível com o uso de alignRectInsets para especificar uma área de toque reduzida Isso também redefine a forma como as âncoras são especificadas. Para uma imagem animada, é usado o valor para a animação, não os frames individuais.

- (UIView*) iconView [read, write, assign, inherited]

Visualização do marcador a ser renderizada.

Se deixada como "nil", volta para a propriedade icon.

Oferece suporte à animação de todas as propriedades animadas da UIView, exceto frame e center. Não é possível alterar essas propriedades ou a versão correspondente da CALayer, incluindo position.

A visualização se comporta como se clipsToBounds estivesse definido como YES, independentemente do valor real.

- (BOOL) tracksViewChanges [read, write, assign, inherited]

Controla se o ícone deste marcador deve ser redesenhado a cada frame.

Quando isso mudar de NO para YES, o ícone será redesenhado no próximo frame.

O padrão é YES. Não terá efeito se iconView for nulo.

- (BOOL) tracksInfoWindowChanges [read, write, assign, inherited]

Controla se a janela de informações deste marcador deve ser redesenhada a cada frame.

Quando isso muda de NO para YES, a janela de informações é certamente redesenhada no próximo frame.

O padrão é NO.

- (CGPoint) groundAnchor [read, write, assign, inherited]

A âncora de solo especifica o ponto na imagem do ícone que está ancorado à posição do marcador na superfície da Terra.

Esse ponto é especificado dentro do espaço contínuo [0.0, 1.0] x [0.0, 1.0], em que (0,0) é o canto superior esquerdo da imagem e (1,1) é o canto inferior direito.

Se a imagem tiver alinhRectInsets diferente de zero, as partes superior esquerda e inferior direita mencionadas acima se referem à seção de encarte da imagem.

- (CGPoint) infoWindowAnchor [read, write, assign, inherited]

A âncora da janela de informações especifica o ponto na imagem do ícone no qual a janela de informações será ancorada, que será exibida diretamente acima desse ponto.

Este ponto é especificado dentro do mesmo espaço queGroundAnchor.

- (GMSMarkerAnimation) appearAnimation [read, write, assign, inherited]

Controla a animação usada quando este marcador é colocado em um GMSMapView (kGMSMarkerAnimationNone padrão, sem animação).

- (BOOL) arrastável [read, write, assign, inherited]

Controla se este marcador pode ser arrastado interativamente (não é padrão).

- (BOOL) plano [read, write, assign, inherited]

Controla se esse marcador deve ficar plano em relação à superfície da Terra (SIM) ou em um outdoor voltado para a câmera (NÃO, padrão).

- rotação [read, write, assign, inherited] (CLLocationdegrees)

Define a rotação do marcador em graus no sentido horário em torno do ponto de fixação do marcador.

O eixo de rotação é perpendicular ao marcador. Uma rotação de 0 corresponde à posição padrão do marcador. Animado.

Quando o marcador é plano no mapa, a posição padrão é alinhada ao norte, e a rotação faz com que o marcador sempre permaneça plano no mapa. Quando o marcador é um outdoor, a posição padrão aponta para cima, e a rotação o coloca sempre de frente para a câmera.

- (flutuante) opacidade [read, write, assign, inherited]

Define a opacidade do marcador, entre 0 (completamente transparente) e 1 (padrão).

- (GMSMarkerLayer*) camada [read, assign, inherited]

Fornece a camada Core Animation para este GMSMarker.

- (GMSPanoramaView*) panoramaView [read, write, assign, inherited]

O panoramaView especifica qual visualização do panorama tentará mostrar esse marcador.

Se o position do marcador estiver muito longe do local do panorama atual do panoramaView, ele não vai ser exibido porque será muito pequeno.

Pode ser definido como nulo para remover o marcador de qualquer visualização de panorama atual à qual ele está anexado.

Um marcador pode aparecer em um panorama e em um mapa ao mesmo tempo.

- (NSString*) título [read, write, copy, inherited]

Título, uma breve descrição da sobreposição.

Algumas sobreposições, como marcadores, exibem o título no mapa. O título também é o texto de acessibilidade padrão.

- (GMSMapView*) mapa [read, write, assign, inherited]

O mapa no qual esta sobreposição está.

Definir essa propriedade adiciona a sobreposição ao mapa. Definir como nulo remove a sobreposição do mapa. Uma sobreposição pode estar ativa em no máximo um mapa por vez.

- (BOOL) ajustável [read, write, assign, inherited]

Se essa sobreposição deve gerar notificações de toque.

Por padrão, algumas sobreposições, como marcadores, são tocáveis.

- (int) zIndex [read, write, assign, inherited]

Sobreposições de valores zIndex mais altos serão desenhadas sobre sobreposições e camadas de blocos com valores zIndex mais baixos.

Valores iguais resultam em uma ordem de desenho indefinida. Os marcadores são uma exceção: independentemente de zIndex, eles sempre são desenhados acima das camadas de blocos e de outras sobreposições que não são marcadores. Eles são considerados em um grupo Z-index diferente de outras sobreposições.

- (ID) userData [read, write, assign, inherited]

Dados de sobreposição.

Use essa propriedade para associar um objeto arbitrário a essa sobreposição. O SDK do Google Maps para iOS não lê nem grava essa propriedade.

Observe que userData não deve conter fortes referências a nenhum objeto Maps. Caso contrário, pode ser criado um ciclo de retenção (impedindo que objetos sejam liberados).