Referência de 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 um dos construtores -init ou -initWithOptions:.

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 resultará em uma exceção ou um comportamento indefinido.

Funções membro público

(tipo de instância)- init
 Inicializa com CGRectZero e opções padrão.
(tipo de instância) - initWithOptions:
 Cria uma nova visualização de mapa com as opções oferecidas.
(tipo de instância)initWithFrame::
(tipo de instância)initWithCoder:
(tipo de instância)initWithFrame:camera:
 Cria e retorna uma visualização de mapa com um frame e um alvo da câmera.
(tipo de instância)- initWithFrame:mapID:camera:
 Cria e retorna uma visualização de mapa com um frame, um ID do mapa e um alvo da câmera.
(void) : startRendering
 Instrui o mapa a ativar seu renderizador.
(void) stopRendering
 Instrui o mapa a desligar seu renderizador.
(void) - limpar
 Limpa todas as marcações que foram adicionadas ao mapa, incluindo marcadores, polilinhas e sobreposições de solo.
(void) setMinZoom:maxZoom:
 Define minZoom e maxZoom.
(nullable GMSCameraPosition *) cameraForBounds:insets:
 Crie um GMSCameraPosition que apresente bounds com padding.
(void) moveCamera:
 Muda a câmera de acordo com update.
(BOOL) areEqualForRenderPosition:position:
 Confira se as posições informadas fazem com que a câmera seja renderizada da mesma maneira, considerando o nível de precisão e as transformações usadas internamente.
(GMSFeatureLayer
< GMSPlaceFeature * > *)
featureLayerOfFeatureType:
 Retorna uma camada de elementos do tipo especificado.
(void) animateToCameraPosition:
 Anima a câmera deste mapa para cameraPosition.
(void) animateToLocation:
 Como animateToCameraPosition:, mas altera apenas a localização da câmera (ou seja, do local atual para location).
(void) animateToZoom:
 Como animateToCameraPosition:, mas altera apenas o nível de zoom da câmera.
(void) animateToBearing:
 Como animateToCameraPosition:, mas altera apenas o rolamento da câmera (em graus).
(void) animateToPreviewAngle:
 Como animateToCameraPosition:, mas altera apenas o ângulo de visão da câmera (em graus).
(void) animateWithCameraUpdate:
 Aplica cameraUpdate à câmera atual e usa o resultado de acordo com animateToCameraPosition:

Funções membro públicas estáticas

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

Propriedades

ID do IBOutlet< GMSMapViewDelegate >delegar
 Delegado de GMSMapView.
GMSCameraPositioncamera
 Controla a câmera, que define como o mapa é orientado.
GMSProjectionprojection
 Retorna um objeto GMSProjection que pode ser usado para converter entre coordenadas de tela e coordenadas de latitude/longitude.
BOOLmyLocationEnabled
 Controla se o ponto Meu local e o círculo de precisão estão ativados.
CLLocation * myLocation
 Se o recurso "Meu local" estiver ativado, revelará onde o ponto de localização do dispositivo está sendo desenhado.
GMSMarkerselectedMarker
 O marcador selecionado.
BOOLtrafficEnabled
 Controla se o mapa está exibindo dados de trânsito, se disponíveis.
GMSMapViewTypemapType
 Controla o tipo de blocos de mapa que devem ser exibidos.
GMSMapStylemapStyle
 Controla o estilo do mapa.
float minZoom
 Zoom mínimo (o maior zoom que a câmera pode ter).
float maxZoom
 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 serã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
 Extrai 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.paddingAdjustmentBehavior
 Controla como os encartes de área segura são adicionados aos valores de padding.
BOOLaccessibilityElementsHidden
 O padrão é YES.
GMSMapLayercamada
 Acessador do tipo CALayer personalizado usado para a camada.
GMSFrameRate (em inglês)preferredFrameRate
 Controla o frame rate da renderização.
GMSCoordinateBoundscameraTargetBounds
 Se não for nulo, restringe o alvo da câmera para que os gestos não façam com que ela 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.

Essas não são funções de membro.

NSString *constkGMSAccessibilityCompass
 Identificador de acessibilidade do botão da bússola.
NSString *constkGMSAccessibilityMyLocation
 Identificador de acessibilidade para o botão "Meu local".
NSString *constkGMSAccessibilityOutOfQuota
 Identificador de acessibilidade para o rótulo de erro "fora da cota".

Documentação da função membro

- (tipo de instância) init

Inicializa com CGRectZero e opções padrão.

– (tipo de instância) initWithOptions: (GMSMapViewOptions não nulos *) options

Cria uma nova visualização de mapa com as opções oferecidas.

O valor do objeto de opções é copiado por esse método.

- (tipo de instância) initWithFrame: (CGRect) quadro
- (tipo de instância) initWithCoder: (NSCoder *) codificador
+ (tipo de instância) mapWithFrame: (CGRect) quadro
câmera: (GMSCameraPosition *) câmera

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

+ (tipo de instância) mapWithFrame: (CGRect) quadro
mapID: (GMSMapID *) mapID
câmera: (GMSCameraPosition *) câmera

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

- (tipo de instância) initWithFrame: (CGRect) quadro
câmera: (GMSCameraPosition *) câmera

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

Observação:
O uso foi descontinuado. Use -init ou -initWithOptions: no seu lugar.
- (tipo de instância) initWithFrame: (CGRect) quadro
mapID: (GMSMapID *) mapID
câmera: (GMSCameraPosition *) câmera

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

Observação:
O uso foi descontinuado. Use -init ou -initWithOptions: no seu lugar.
- (void) startRendering

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) stopRendering

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) limpar

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

Essa ação não limpará o ponto de localização visível nem redefinirá o mapType atual.

- (void) setMinZoom: (float)  minZoom
maxZoom: (float)  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 caso contrário.

- (nullable GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *) limites
encartes: (UIEdgeInsets) encartes

Crie um GMSCameraPosition que apresente bounds com padding.

A câmera tem rumo 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.

- (void) 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 informadas fazem com que a câmera seja renderizada da mesma maneira, considerando o nível de precisão e as transformações usadas internamente.

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 no mapa, se 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 chamadas.

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

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Anima a câmera deste mapa para cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D)  local

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

- (void) animateToZoom: (float)  zoom

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

Este valor é ajustado por [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirection) bearing

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

Zero indica o norte verdadeiro.

- (void) animateToVisualizarAngle: (duplo) viewingAngle

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, virado para baixo) e entre 30 e 45 graus em direção ao horizonte, dependendo da proximidade relativa à Terra.

- (void) 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 para o botão "Meu local".

- (NSString* const) kGMSAccessibilityOutOfQuota [related]

Identificador de acessibilidade para o rótulo de erro "fora da cota".


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 como o mapa é orientado.

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, quando a câmera foi definida explicitamente ou o mapa acaba de ser 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 o recurso "Meu local" estiver ativado, revelará 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 KVO.

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

O marcador selecionado.

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

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

Controla se o mapa está exibindo 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 (o maior zoom que a câmera pode ter).

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á-lo mais claro em níveis altos de zoom. Alterar este valor fará com que todos os blocos sejam brevemente invalidados.

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

Define se os mapas internos serã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]

Extrai 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, é possível criar uma área ao redor da borda da visualização com dados do mapa, mas sem controles de interface.

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 esse preenchimento e qualquer preenchimento solicitado serão levados em conta.

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

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

Como o preenchimento, os encartes da área de segurança 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 vai 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 [read, retain] (GMSMapLayer*)

Acessador do tipo 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 ela 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.