Referência da classe GMSMapView


Informações gerais

Esta é a classe principal do SDK do Google Maps para iOS e é o ponto de entrada para todos os métodos relacionados ao mapa.

O mapa deve ser instanciado por meio do construtor de conveniência [GMSMapView mapWithFrame:camera:]. Ela também pode ser criada com o método padrão [[GMSMapView alloc] initWithFrame:], em que a câmera é definida como um local padrão.

GMSMapView só pode ser lido e modificado a partir da linha de execução principal, semelhante a todos os objetos UIKit. Chamar esses métodos em outra linha de execução vai resultar em uma exceção ou um comportamento indefinido.

Funções membro públicas

(instancetype)- initWithFrame:camera:
 Cria e retorna uma visualização de mapa com um frame e um alvo da câmera.
(instancetype)- initWithFrame:mapID:camera:
 Cria e retorna uma visualização de mapa com um frame, um ID do mapa e um alvo da câmera.
(nulo): startRender (link em inglês)
 Instrui o mapa a ativar seu renderizador.
(nulo): stopRender
 Instrui o mapa a desligar seu renderizador.
(nulo)- limpar
 Limpa todas as marcações que foram adicionadas ao mapa, incluindo marcadores, polilinhas e sobreposições de solo.
(nulo)- setMinZoom:maxZoom:
 Define minZoom e maxZoom.
(GMSCameraPosition * anulável)cameraForBounds:insets:
 Crie um GMSCameraPosition que apresente bounds com padding.
(nulo)moveCamera:
 Muda a câmera de acordo com update.
(BOOL)areEqualForRendererPosition:position:
 Confira se as posições fornecidas fazem com que a câmera seja renderizada da mesma forma, considerando o nível de precisão e as transformações usados internamente.
(GMSFeatureLayer
< GMSPlaceFeature * > *)
- featureLayerOfFeatureType:
 Retorna uma camada de elementos do tipo especificado.
(nulo)animateToCameraPosition:
 Anima a câmera deste mapa para cameraPosition.
(nulo)animateToLocation:
 Como animateToCameraPosition:, mas altera apenas a localização da câmera (ou seja, da localização atual para location).
(nulo)animateToZoom:
 Como animateToCameraPosition:, mas altera apenas o nível de zoom da câmera.
(nulo)animateToBearing:
 Como animateToCameraPosition:, mas altera apenas o rolamento da câmera (em graus).
(nulo)animateToPreviewAngle:
 Como animateToCameraPosition:, mas altera apenas o ângulo de visão da câmera (em graus).
(nulo)animateWithCameraUpdate:
 Aplica cameraUpdate à câmera atual e usa o resultado de acordo com animateToCameraPosition:

Funções membro públicas estáticas

(instancetype)+ mapWithFrame:camera:
 Cria e retorna uma visualização de mapa com um frame e um alvo da câmera.
(instancetype)+ mapWithFrame:mapID:camera:
 Inicializador de conveniência para criar e retornar uma visualização de mapa com um frame, ID do mapa e alvo da câmera.

Propriedades

ID do IBOutlet< GMSMapViewDelegate >delegar
 Delegado de GMSMapView.
GMSCameraPositioncamera
 Controla a câmera, que define a orientação do mapa.
GMSProjectionprojection
 Retorna um objeto GMSProjection que pode ser usado para converter entre coordenadas de tela e coordenadas de latitude/longitude.
BOOLmyLocationEnabled (link em inglês)
 Controla se o ponto Meu local e o círculo de precisão estão ativados.
CLLocal * myLocation (link em inglês)
 Se "Meu local" estiver ativado, revela onde o ponto de localização do dispositivo está sendo desenhado.
GMSMarkerselectedMarker
 O marcador que é selecionado.
BOOLtrafficEnabled
 Controla se o mapa está extraindo dados de trânsito, se disponíveis.
GMSMapViewTypemapType (em inglês)
 Controla o tipo de blocos de mapa que devem ser exibidos.
GMSMapStylemapStyle
 Controla o estilo do mapa.
ponto flutuanteminZoom (link em inglês)
 Zoom mínimo (a máxima que o zoom da câmera pode diminuir).
ponto flutuantemaxZoom (em inglês)
 Zoom máximo (a câmera mais próxima da Terra).
BOOLbuildingsEnabled
 Se definido, as construções em 3D serão exibidas, quando disponíveis.
BOOLindoorEnabled
 Define se os mapas internos são exibidos, quando disponíveis.
GMSIndoorDisplayindoorDisplay
 Recebe a instância GMSIndoorDisplay que permite observar ou controlar aspectos da exibição de dados internos.
GMSUISettingsconfigurações
 Acessa o objeto GMSUISettings, que controla as configurações da interface do usuário para o mapa.
UIEdgeInsetspadding.
 Controla a região "visível" da visualização.
GMSMapViewPaddingAdjustmentBehavior (link em inglês)paddingAdjustmentBehavior (em inglês)
 Controla como os encartes da área segura são adicionados aos valores de padding.
BOOLaccessibilityElementsHidden (link em inglês)
 O padrão é YES.
GMSMapLayercamada
 Acessador do tipo de CALayer personalizado usado para a camada.
GMSFrameRatepreferredFrameRate (em inglês)
 Controla o frame rate da renderização.
GMSCoordinateBoundscameraTargetBounds (em inglês)
 Se não for nulo, restringe o alvo da câmera para que os gestos não façam com que ele saia dos limites especificados.
GMSMapCapabilityFlagsmapCapabilities
 Todos os recursos disponíveis condicionalmente (dependendo do mapID ou de outras configurações do mapa) que estão disponíveis no momento.

Observe que essas não são funções de membro.

NSString *constkGMSAccessibilityCompass (link em inglês)
 Identificador de acessibilidade do botão da bússola.
NSString *constkGMSAccessibilityMyLocation
 Identificador de acessibilidade do botão "Meu local".
NSString *constkGMSAccessibilityOutOfQuota (em inglês).
 Identificador de acessibilidade do rótulo de erro "esgotado".

Documentação da função membro

+ (tipo de instância) mapWithFrame: (CGRect) frame
câmera: (GMSCameraPosition *) camera

Cria e retorna uma visualização de mapa com um frame e um alvo da câmera.

+ (tipo de instância) mapWithFrame: (CGRect) frame
mapID: (GMSMapID *) mapID (link em inglês)
câmera: (GMSCameraPosition *) camera

Inicializador de conveniência para criar e retornar uma visualização de mapa com um frame, ID do mapa e alvo da câmera.

– (tipo de instância) initWithFrame: (CGRect) frame
câmera: (GMSCameraPosition *) camera

Cria e retorna uma visualização de mapa com um frame e um alvo da câmera.

– (tipo de instância) initWithFrame: (CGRect) frame
mapID: (GMSMapID *) mapID (link em inglês)
câmera: (GMSCameraPosition *) camera

Cria e retorna uma visualização de mapa com um frame, um ID do mapa e um alvo da câmera.

- (void) startRender

Instrui o mapa a ativar seu renderizador.

Isso é opcional e idempotente.

Observação:
O uso foi descontinuado. Esse método está obsoleto e será removido em uma versão futura.
- (void) stopRender

Instrui o mapa a desligar seu renderizador.

Isso é opcional e idempotente.

Observação:
O uso foi descontinuado. Esse método está obsoleto e será removido em uma versão futura.
- (void) clear

Limpa todas as marcações que foram adicionadas ao mapa, incluindo marcadores, polilinhas e sobreposições de solo.

Essa ação não limpa o ponto de localização visível nem redefine o mapType atual.

- (void) setMinZoom: (flutuante) minZoom (link em inglês)
maxZoom: (flutuante) maxZoom

Define minZoom e maxZoom.

Esse método espera que o mínimo seja menor ou igual ao máximo e vai gerar uma exceção com o nome NSRangeException.

- (GMSCameraPosition * anulável) cameraForBounds: (GMSCoordinateBounds *) limites
encartes: (UIEdgeInsets) encartes

Crie um GMSCameraPosition que apresente bounds com padding.

A câmera tem direção zero e inclinação (ou seja, voltada para o norte e olhando diretamente para a Terra). Isso leva em consideração o frame e o preenchimento desse GMSMapView.

Se os limites forem inválidos, esse método retornará uma câmera nula.

- (nulo) moveCamera: (GMSCameraUpdate *) update

Muda a câmera de acordo com update.

A mudança de câmera é instantânea (sem animação).

– (BOOL) areEqualForRendererPosition: (GMSCameraPosition *) position
posição: (GMSCameraPosition *) otherPosition

Confira se as posições fornecidas fazem com que a câmera seja renderizada da mesma forma, considerando o nível de precisão e as transformações usados internamente.

- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: (GMSFeatureType) featureType (em inglês)

Retorna uma camada de elementos do tipo especificado.

As camadas de recursos precisam ser configuradas no Console do Cloud.

Se uma camada do tipo especificado não existir nesse mapa, o estilo orientado a dados não estiver ativado ou se o framework de renderização Metal não for usado, o isAvailable da camada resultante será NO e não responderá a nenhuma chamada.

Exige o renderizador Metal. Saiba como ativar o Metal em https://developers.google.com/maps/documentation/ios-sdk/config#use-metal

- (vazio) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Anima a câmera deste mapa para cameraPosition.

- (nulo) animateToLocation: (CLLocationCoordinate2D) local

Como animateToCameraPosition:, mas muda apenas a localização da câmera (ou seja, da localização atual para location).

- (vazio) animateToZoom: (flutuante) zoom

Como animateToCameraPosition:, mas altera apenas o nível de zoom da câmera.

Este valor é limitado por [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (vazio) animateToBearing: (CLLocationDirection) bearing

Como animateToCameraPosition:, mas altera apenas o rolamento da câmera (em graus).

Zero indica o norte verdadeiro.

- (vazio) animateToVisualizarAngle: (duplo) viewingAngle (link em inglês)

Como animateToCameraPosition:, mas altera apenas o ângulo de visão da câmera (em graus).

Esse valor será fixado a um mínimo de zero (ou seja, voltado para baixo) e entre 30 e 45 graus em direção ao horizonte, dependendo da proximidade relativa da Terra.

- (nulo) animateWithCameraUpdate: (GMSCameraUpdate *) cameraUpdate

Aplica cameraUpdate à câmera atual e usa o resultado de acordo com animateToCameraPosition:


- (NSString* const) kGMSAccessibilityCompass [related]

Identificador de acessibilidade do botão da bússola.

- (NSString* const) kGMSAccessibilityMyLocation [related]

Identificador de acessibilidade do botão "Meu local".

- (NSString* const) kGMSAccessibilityOutOfQuota [related]

Identificador de acessibilidade do rótulo de erro "esgotado".


Documentação da propriedade

- (ID do IBOutlet<GMSMapViewDelegate>) delegado [read, write, assign]

Delegado de GMSMapView.

- (GMSCameraPosition*) câmera [read, write, copy]

Controla a câmera, que define a orientação do mapa.

A modificação dessa propriedade é instantânea.

- (GMSProjection*) projeção [read, assign]

Retorna um objeto GMSProjection que pode ser usado para converter entre coordenadas de tela e coordenadas de latitude/longitude.

Este é um instantâneo da projeção atual e não será atualizado automaticamente quando a câmera se mover. Ele representa a projeção do último frame GMSMapView desenhado ou onde a câmera foi explicitamente definida ou o mapa recém-criado, o próximo frame. Nunca será nulo.

– (BOOL) myLocationEnabled [read, write, assign]

Controla se o ponto Meu local e o círculo de precisão estão ativados.

O padrão é NO.

– (CLLocation*) myLocation [read, assign]

Se "Meu local" estiver ativado, revela onde o ponto de localização do dispositivo está sendo desenhado.

Se estiver desativada ou ativada, mas nenhum dado de local estiver disponível, esse valor será nulo. Essa propriedade é observável usando o KVO.

- (GMSMarker*) selectedMarker [read, write, assign]

O marcador que é selecionado.

A definição dessa propriedade seleciona um marcador específico, mostrando uma janela de informações nele. Se essa propriedade não for "nil", defini-la como "nil" cancelará a seleção do marcador, ocultando a janela de informações. Essa propriedade é observável usando o KVO.

- (BOOL) trafficEnabled [read, write, assign]

Controla se o mapa está extraindo dados de trânsito, se disponíveis.

Isso está sujeito à disponibilidade dos dados de tráfego. O padrão é NO.

- (GMSMapViewType) mapType [read, write, assign]

Controla o tipo de blocos de mapa que devem ser exibidos.

O padrão é kGMSTypeNormal.

- (GMSMapStyle*) mapStyle [read, write, assign]

Controla o estilo do mapa.

Um mapStyle não nulo só é aplicado se mapType for Normal.

- (flutuante) minZoom [read, assign]

Zoom mínimo (a máxima que o zoom da câmera pode diminuir).

O padrão é kGMSMinZoomLevel. Modificado com -setMinZoom:maxZoom:.

- (flutuante) maxZoom [read, assign]

Zoom máximo (a câmera mais próxima da Terra).

O padrão é kGMSMaxZoomLevel. Modificado com -setMinZoom:maxZoom:.

- (BOOL) buildingsEnabled [read, write, assign]

Se definido, as construções em 3D serão exibidas, quando disponíveis.

O padrão é YES.

Isto pode ser útil ao adicionar uma camada de blocos personalizada ao mapa, para torná-la mais clara em níveis altos de zoom. A mudança desse valor fará com que todos os blocos sejam brevemente invalidados.

- (BOOL) indoorEnabled [read, write, assign]

Define se os mapas internos são exibidos, quando disponíveis.

O padrão é YES.

Se essa opção for definida como NO, os caches de dados internos poderão ser limpos, e qualquer andar selecionado pelo usuário final poderá ser redefinido.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Recebe a instância GMSIndoorDisplay que permite observar ou controlar aspectos da exibição de dados internos.

- (GMSUISettings*) configurações [read, assign]

Acessa o objeto GMSUISettings, que controla as configurações da interface do usuário para o mapa.

- (UIEdgeInsets) padding [read, write, assign]

Controla a região "visível" da visualização.

Ao aplicar o preenchimento, uma área ao redor da borda da visualização pode ser criada. Ela vai conter dados do mapa, mas não vai incluir controles de IU.

Se o padding não estiver equilibrado, o centro visual da visualização se moverá conforme necessário. O padding também afeta a propriedade projection. Portanto, a região visível não vai incluir a área de padding. GMSCameraUpdate fitToBounds garantirá que tanto esse padding quanto qualquer preenchimento solicitado sejam levados em consideração.

Esta propriedade pode ser animada dentro de um bloco de animação baseado em UIView.

Controla como os encartes da área segura são adicionados aos valores de padding.

Assim como o preenchimento, os encartes da área segura posicionam os controles do mapa, como a bússola, o botão "Meu local" e o seletor de andar na área segura do dispositivo.

O padrão é kGMSMapViewPaddingAdjustmentBehaviorAlways.

- (BOOL) accessibilityElementsHidden [read, write, assign]

O padrão é YES.

Se definido como NO, GMSMapView gerará elementos de acessibilidade para objetos de sobreposição, como GMSMarker e GMSPolyline.

Essa propriedade segue o protocolo informal UIAccessibility, exceto pelo valor padrão YES.

- camada (GMSMapLayer*) [read, retain]

Acessador do tipo de CALayer personalizado usado para a camada.

- (GMSFrameRate) preferredFrameRate [read, write, assign]

Controla o frame rate da renderização.

O valor padrão é kGMSFrameRateMaxim.

- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

Se não for nulo, restringe o alvo da câmera para que os gestos não façam com que ele saia dos limites especificados.

Todos os recursos disponíveis condicionalmente (dependendo do mapID ou de outras configurações do mapa) que estão disponíveis no momento.

Não inclui recursos sempre disponíveis.