Informações gerais
Um marcador é um ícone colocado em um ponto específico na superfície do mapa.
O ícone de um marcador é desenhado orientado de acordo com a tela do dispositivo, e não com a superfície do mapa. Ou seja, ele não necessariamente mudará de orientação devido a rotações, inclinação ou zoom do mapa.
Herda GMSOverlay.
Herdado pelo GMSAdvancedMarker.
Funções membro públicas estáticas | |
(tipo de instância) | + markerWithPosition: |
Construtor de conveniência para um marcador padrão. | |
(UIImage *) | + markerImageWithColor: |
Cria uma versão colorida da imagem do marcador padrão para uso como ícone. | |
Propriedades | |
CLLocationCoordinate2D | position |
Posição de Marker. | |
NSString * | snippet |
Texto do snippet, exibido 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 precisa ser redesenhado a cada frame. | |
BOOL | tracksInfoWindowChanges |
Controla se a janela de informações deste marcador precisa 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á exibido diretamente acima desse ponto. | |
GMSMarkerAnimation | appearAnimation |
Controla a animação usada quando este marcador é colocado em um GMSMapView (kGMSMarkerAnimationNone, sem animação). | |
BOOL | arrastável |
Controla se este marcador pode ser arrastado de maneira interativa (padrão NO). | |
BOOL | plano |
Controla se este marcador deve ficar plano em relação à superfície da Terra (SIM) ou 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 relação ao 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 de 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 | alcançável |
Se essa sobreposição deve gerar notificações de toque. | |
int | zIndex |
As sobreposições de valores zIndex mais altos serão desenhadas sobre as sobreposições e camadas de blocos de valores zIndex mais baixos. | |
id | userData |
Dados de sobreposição. |
Documentação da função membro
+ (tipo de instância) 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 uso como ícone.
Documentação da propriedade
- (CLLocationCoordinate2D) position [read, write, assign] |
Posição de Marker.
Animado.
- (NSString*) snippet [read, write, copy] |
Texto do snippet, exibido abaixo do título na janela de informações, quando selecionado.
- (UIImage*) ícone [read, write, assign] |
Ícone de marcador a ser renderizado.
Se deixada em 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 será indefinido.
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 da animação, não os frames individuais.
- (UIView*) iconView [read, write, assign] |
Visualização do marcador a ser renderizada.
Se deixada como nil, volta para a propriedade icon
.
Oferece suporte à animação de todas as propriedades animados da UIView, exceto frame
e center
. Não é possível alterar essas propriedades ou a versão correspondente da CALayer, incluindo position
.
Observe que a visualização se comporta como se clipsToBounds
estivesse definido como YES, independentemente do valor real.
- (BOOL) tracksViewChanges [read, write, assign] |
Controla se o ícone deste marcador precisa 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 tem efeito quando iconView
é nulo.
- (BOOL) tracksInfoWindowChanges [read, write, assign] |
Controla se a janela de informações deste marcador precisa 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] |
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 AlignmentRectInsets diferente de zero, as partes superior esquerda e inferior mencionadas acima se referem à seção de encarte da imagem.
- (CGPoint) infoWindowAnchor [read, write, assign] |
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á exibido diretamente acima desse ponto.
Este ponto é especificado no mesmo espaço que floorAnchor.
- (GMSMarkerAnimation) appearAnimation [read, write, assign] |
Controla a animação usada quando este marcador é colocado em um GMSMapView (kGMSMarkerAnimationNone, sem animação).
- (BOOL) arrastável [read, write, assign] |
Controla se este marcador pode ser arrastado de maneira interativa (padrão NO).
- (BOOL) plano [read, write, assign] |
Controla se este marcador deve ficar plano em relação à superfície da Terra (SIM) ou um outdoor voltado para a câmera (NÃO, padrão).
- rotação [read, write, assign] de (CLLocationdegrees) |
Define a rotação do marcador em graus no sentido horário em relação ao 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] |
Define a opacidade do marcador, entre 0 (completamente transparente) e 1 (padrão).
- camada [read, assign] (GMSMarkerLayer*) |
Fornece a camada Core Animation para este GMSMarker.
- (GMSPanoramaView*) panoramaView [read, write, assign] |
O panoramaView
especifica qual visualização de 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 mostrado, porque é muito pequeno.
Pode ser definido como nulo para remover o marcador de qualquer visualização de panorama atual a que ele está anexado.
Um marcador pode ser exibido 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.
- mapa (GMSMapView*) [read, write, assign, inherited] |
O mapa no qual esta sobreposição está.
Definir essa propriedade adiciona a sobreposição ao mapa. Se ela for definida como nula, a sobreposição será removida do mapa. Uma sobreposição pode estar ativa em, no máximo, um mapa ao mesmo tempo.
- (BOOL) toque [read, write, assign, inherited] |
Se essa sobreposição deve gerar notificações de toque.
Algumas sobreposições, como marcadores, são tocadas por padrão.
- (int) zIndex [read, write, assign, inherited] |
As sobreposições de valores zIndex
mais altos serão desenhadas sobre as sobreposições e camadas de blocos de valores zIndex
mais baixos.
Valores iguais resultam em ordem de desenho indefinida. Os marcadores são uma exceção: independentemente de zIndex
, eles sempre serão desenhados sobre as camadas de blocos e outras sobreposições que não são marcadores. Considera-se que eles estão 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 nenhuma referência forte a nenhum objeto Maps. Caso contrário, um ciclo de retenção pode ser criado (impedindo que objetos sejam liberados).