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 | |
GMSCollisionBehavior | collisionBehavior |
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 | position |
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. | |
BOOL | tracksViewChanges |
Controla se o ícone deste marcador deve ser redesenhado a cada frame. | |
BOOL | tracksInfoWindowChanges |
Controla se a janela de informações deste marcador deve ser redesenhada a cada frame. | |
CGPoint | groundAnchor |
A âncora de solo especifica o ponto na imagem do ícone que está ancorado à posição do marcador na superfície da Terra. | |
CGPoint | infoWindowAnchor |
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. | |
GMSMarkerAnimation | appearAnimation |
Controla a animação usada quando este marcador é colocado em um GMSMapView (kGMSMarkerAnimationNone padrão, sem animação). | |
BOOL | arrastar |
Controla se este marcador pode ser arrastado interativamente (não é padrão). | |
BOOL | plano |
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). | |
CLLocationGraus | rotaçã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). | |
GMSMarkerLayer * | camada |
Fornece a camada Core Animation para este GMSMarker. | |
GMSPanoramaView * | panoramaView |
O panoramaView especifica qual visualização do panorama tentará mostrar esse marcador. | |
NSString * | title |
Título, uma breve descrição da sobreposição. | |
GMSMapView * | map |
O mapa no qual esta sobreposição está. | |
BOOL | acessí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. | |
id | userData |
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).