Com uma janela de informações, você pode mostrar detalhes para o usuário quando ele toca em um marcador.
Essas janelas aparecem na tela do dispositivo e ficam centralizadas acima do marcador associado. A janela padrão contém o título em negrito, com o texto do snippet abaixo do título.
O conteúdo dessa janela é definido pelas propriedades title
e snippet
do marcador. Um clique no marcador não mostra uma janela de informações se as propriedades title
e snippet
estão em branco ou nil
.
Apenas uma janela aparece de cada vez. Se um usuário tocar em outro marcador, a janela atual será ocultada, e uma nova janela será aberta. Quando o usuário clica em um marcador que está mostrando uma janela de informações, ela é fechada e reaberta.
Crie uma janela personalizada para adicionar outros textos ou imagens. Uma janela de informações personalizada oferece controle total sobre a aparência do pop-up.
Adicionar uma janela de informações
O snippet a seguir cria um marcador simples, com apenas um título para o texto da janela.
Swift
let position = CLLocationCoordinate2D(latitude: 51.5, longitude: -0.127) let london = GMSMarker(position: position) london.title = "London" london.map = mapView
Objective-C
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(51.5, -0.127); GMSMarker *london = [GMSMarker markerWithPosition:position]; london.title = @"London"; london.map = mapView;
Com a propriedade snippet
, é possível adicionar mais texto que aparecerá
abaixo do título em uma fonte menor. Strings maiores que a largura da janela são quebradas automaticamente em várias linhas. Mensagens muito longas
podem ser truncadas.
Swift
london.title = "London" london.snippet = "Population: 8,174,100" london.map = mapView
Objective-C
london.title = @"London"; london.snippet = @"Population: 8,174,100"; london.map = mapView;
Mostrar/ocultar uma janela de informações
As janelas de informações são projetadas para responder a eventos de toque do usuário no marcador.
Para mostrar ou ocultar uma janela de informações de maneira programática, defina a propriedade selectedMarker
de GMSMapView
:
- Defina
selectedMarker
como o nome do marcador para exibição. - Defina
selectedMarker
comonil
para ocultar.
Swift
london.title = "London" london.snippet = "Population: 8,174,100" london.map = mapView // Show marker mapView.selectedMarker = london // Hide marker mapView.selectedMarker = nil
Objective-C
london.title = @"London"; london.snippet = @"Population: 8,174,100"; london.map = mapView; // Show marker mapView.selectedMarker = london; // Hide marker mapView.selectedMarker = nil;
Configurar uma janela de informações para atualização automática
Defina tracksInfoWindowChanges
no marcador como YES
ou true
se você quiser que novas propriedades ou o conteúdo da janela de informações apareçam imediatamente quando alterados, em vez de esperar que a janela seja ocultada e mostrada novamente. O padrão é NO
ou false
.
Swift
london.tracksInfoWindowChanges = true
Objective-C
london.tracksInfoWindowChanges = YES;
Para decidir quando definir a propriedade tracksInfoWindowChanges
, avalie o desempenho em relação às vantagens de ter a janela de informações redesenhada automaticamente. Exemplo:
- Se você quiser fazer várias mudanças, mude a propriedade para
YES
e depois volte paraNO
. - Quando uma animação estiver em execução ou o conteúdo estiver sendo carregado de forma assíncrona,
mantenha a propriedade definida como
YES
até que as ações sejam concluídas.
Consulte também as observações para consideração ao usar a propriedade iconView
do marcador.
Alteração da posição de uma janela de informações
Essas janelas aparecem na tela do dispositivo e ficam centralizadas acima do marcador associado. Para mudar a posição dessa janela em relação ao marcador, defina a propriedade infoWindowAnchor
. Essa
propriedade aceita um CGPoint
, definido como um deslocamento (x, y), em que x e y
variam entre 0,0 e 1,0. O deslocamento padrão é (0,5, 0,0), ou seja, a parte superior central. Definir o deslocamento infoWindowAnchor
é útil para alinhar a janela de informações a um ícone personalizado.
Swift
london.infoWindowAnchor = CGPoint(x: 0.5, y: 0.5) london.icon = UIImage(named: "house") london.map = mapView
Objective-C
london.infoWindowAnchor = CGPointMake(0.5, 0.5); london.icon = [UIImage imageNamed:@"house"]; london.map = mapView;
Processar eventos em janelas de informações
Você pode detectar os seguintes eventos da janela de informações:
mapView:markerInfoWindow:
: chamado quando um marcador está prestes a ser selecionado. Opcionalmente, pode retornar uma janela de informações personalizada, comoUIView
, para usar no marcador. Consulte Janelas de informações personalizadas abaixo para mais detalhes.mapView:markerInfoContents:
: chamado quandomapView:markerInfoWindow
retorna nulo.mapView:didCloseInfoWindowOfMarker:
: chamado quando a janela de informações do marcador é fechada.mapView:didLongPressInfoWindowOfMarker:
: chamado depois que a janela de informações de um marcador é pressionada e pressionada.
Para detectar eventos, implemente o protocolo GMSMapViewDelegate
. Consulte o
guia para eventos e a lista de métodos em
GMSMapViewDelegate
.
O GitHub inclui exemplos que demonstram como processar eventos da janela de informações:
Personalizar janelas de informações
Personalize o conteúdo das janelas de informações criando uma subclasse de UIView
que defina o layout da janela. Nessa subclasse,
defina a visualização como você quiser. Por exemplo, você pode usar instâncias de UILabel
personalizadas para exibir o texto do título e do snippet e outras visualizações, como instâncias de UIImageView
, para adicionar imagens mostradas na janela de informações.
Verifique se o ViewController
implementa o protocolo GMSIndoorDisplayDelegate
e define um listener para o evento mapView:markerInfoWindow:. Esse listener de eventos é chamado quando um marcador está prestes a ser selecionado e permite retornar uma instância da classe UIView
personalizada para definir a janela de informações personalizada usada pelo marcador.
As imagens abaixo mostram uma janela de informações padrão, outra com conteúdo personalizado e uma com frame e segundo plano personalizados.
Os exemplos de código no GitHub fornecidos com o SDK do Maps para iOS incluem exemplos de janelas de informações personalizadas. Por exemplo, consulte a definição de MarkerInfoWindowViewController.m (Objective-C) ou MarkerInfoWindowViewController.swift (Swift).
Consulte exemplos de código para informações sobre como fazer o download e executar essas amostras.