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. | |
GMSCameraPosition * | camera |
Controla a câmera, que define como o mapa é orientado. | |
GMSProjection * | projection |
Retorna um objeto GMSProjection que pode ser usado para converter entre coordenadas de tela e coordenadas de latitude/longitude. | |
BOOL | myLocationEnabled |
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. | |
GMSMarker * | selectedMarker |
O marcador selecionado. | |
BOOL | trafficEnabled |
Controla se o mapa está exibindo dados de trânsito, se disponíveis. | |
GMSMapViewType | mapType |
Controla o tipo de blocos de mapa que devem ser exibidos. | |
GMSMapStyle * | mapStyle |
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. | |
BOOL | buildingsEnabled |
Se definido, as construções em 3D serão exibidas quando disponíveis. | |
BOOL | indoorEnabled |
Define se os mapas internos serão exibidos, quando disponíveis. | |
GMSIndoorDisplay * | indoorDisplay |
Recebe a instância GMSIndoorDisplay, que permite observar ou controlar aspectos da exibição de dados internos. | |
GMSUISettings * | configurações |
Extrai o objeto GMSUISettings, que controla as configurações da interface do usuário para o mapa. | |
UIEdgeInsets | padding. |
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. | |
BOOL | accessibilityElementsHidden |
O padrão é YES. | |
GMSMapLayer * | camada |
Acessador do tipo CALayer personalizado usado para a camada. | |
GMSFrameRate (em inglês) | preferredFrameRate |
Controla o frame rate da renderização. | |
GMSCoordinateBounds * | cameraTargetBounds |
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. | |
GMSMapCapabilityFlags | mapCapabilities |
Todos os recursos disponíveis condicionalmente (dependendo do mapID ou de outras configurações do mapa) que estão disponíveis no momento. | |
Funções relacionadas | |
Essas não são funções de membro. | |
NSString *const | kGMSAccessibilityCompass |
Identificador de acessibilidade do botão da bússola. | |
NSString *const | kGMSAccessibilityMyLocation |
Identificador de acessibilidade para o botão "Meu local". | |
NSString *const | kGMSAccessibilityOutOfQuota |
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.
- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
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:
Documentação de amigos e funções relacionadas
- (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.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
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.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
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.