Visão geral
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 para um local padrão).
A GMSMapView só pode ser lida e modificada a partir da linha de execução principal, semelhante a todos os objetos UIKit. Chamar esses métodos de outra linha de execução resultará em uma exceção ou um comportamento indefinido.
Funções públicas de membros | |
| (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 de mapa e um alvo de câmera. | |
| (nulo) | - startRendering |
| Diz ao mapa para ativar seu renderizador. | |
| (nulo) | - stopRendering |
| Diz ao mapa para desligar o renderizador. | |
| (nulo) | - limpar |
| Limpa toda marcação que foi adicionada ao mapa, incluindo marcadores, polilinhas e superposições de solo. | |
| (nulo) | - setMinZoom:maxZoom: |
Define minZoom e maxZoom. | |
| (anulável GMSCameraPosition *) | - cameraForBounds:insets: |
Crie um GMSCameraPosition que apresente bounds com padding. | |
| (nulo) | - moveCamera: |
Altera a câmera de acordo com update. | |
| (BOOL) | - areEqualForRenderingPosition:position: |
| Verifique se as posições da câmera fazem com que ela seja renderizada da mesma forma, considerando o nível de precisão e as transformações usadas internamente. | |
| (nulo) | - animateToCameraPosition: |
Anima a câmera deste mapa para cameraPosition. | |
| (nulo) | - animateToLocation: |
Como animateToCameraPosition:, mas altera apenas o local da câmera (ou seja, do local atual para location). | |
| (nulo) | - animateToZoom: |
| Como animateToCameraPosition:, mas altera apenas o nível de zoom da câmera. | |
| (nulo) | - animateToBearing: |
| Como animateToCameraPosition:, mas altera somente o rolamento da câmera (em graus). | |
| (nulo) | - animateToViewingAngle: |
| Como animateToCameraPosition:, mas altera somente o ângulo de visão da câmera (em graus). | |
| (nulo) | - animateWithCameraUpdate: |
Aplica cameraUpdate à câmera atual e usa o resultado conforme animateToCameraPosition:. | |
Funções estáticas de membros públicos | |
| (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, um ID de mapa e um alvo de câmera. | |
Propriedades | |
| ID do IBOutlet <GMSMapViewDelegate > | delegar |
| delegado GMSMapView. | |
| GMSCameraPosition * | camera |
| Controla a câmera, que define a orientação do mapa. | |
| GMSProjection * | projection |
| Retorna um objeto GMSProjection que você pode usar para converter entre coordenadas de tela e coordenadas de latitude/longitude. | |
| BOOL | myLocationEnabled |
| Controla se o ponto My Location e o círculo de precisão estão ativados. | |
| CLLocation * | myLocation |
| Se Meu local está ativado, revela onde o ponto de localização do aparelho está sendo desenhado. | |
| GMSMarker * | selectedMarker. |
| O marcador selecionado. | |
| BOOL | trafficEnabled |
| Controla se o mapa está extraindo dados de tráfego, se disponível. | |
| GMSMapViewType | mapType (em inglês) |
| Controla o tipo de blocos do mapa que devem ser exibidos. | |
| GMSMapStyle * | mapStyle (em inglês) |
| Controla o estilo do mapa. | |
| ponto flutuante | minZoom (em inglês) |
| Zoom mínimo (o mais afastado da câmera). | |
| ponto flutuante | maxZoom (em inglês) |
| Zoom máximo (a câmera mais próxima da Terra pode estar). | |
| BOOL | buildingsEnabled (em inglês) |
| Se definida, as construções em 3D serão mostradas onde estiverem disponíveis. | |
| BOOL | indoorEnabled (em inglês) |
| Define se os mapas internos são exibidos, quando disponíveis. | |
| GMSIndoorDisplay * | indoorDisplay (em inglês) |
| Obtém a instância GMSIndoorDisplay, que permite observar ou controlar aspectos da exibição de dados internos. | |
| GMSUISettings * | configurações |
| Obtém o objeto GMSUISettings, que controla as configurações da interface do usuário para o mapa. | |
| UIEdgeInsets | preenchimento |
| Controla a região "visível" da visualização. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Controla como os encartes de área segura são adicionados aos valores de preenchimento. | |
| BOOL | accessibilityElementsHidden. |
| O padrão é YES. | |
| GMSMapLayer * | camada |
| Acesso de tipo de CALayer personalizado usado para a camada. | |
| GMSFrameRate | preferredFrameRate: |
| Controla a frame rate de renderização. | |
| GMSCoordinateBounds * | cameraTargetBounds (em inglês) |
| Se não for nulo, restringe o alvo da câmera para que os gestos não possam fazer com que ele saia dos limites especificados. | |
| GMSMapCapabilityFlags | mapCapabilities (em inglês) |
| 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 funções não são membros. | |
| NSString *const | kGMSAccessibilityCompass (link em inglês) |
| Identificador de acessibilidade do botão de bússola. | |
| NSString *const | kGMSAccessibilityMyLocation |
| Identificador de acessibilidade do botão "Meu local". | |
| NSString *const | kGMSAccessibilityOutOfQuota. |
| Identificador de acessibilidade para o rótulo de erro "fora da cota". | |
Documentação da função do membro
| + (instancetype) 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.
| + (instancetype) mapWithFrame: | (CGRect) | quadro | |
| ID do mapa: | (GMSMapID *) | ID do mapa | |
| câmera: | (GMSCameraPosition *) | câmera | |
Inicializador de conveniência para criar e retornar uma visualização de mapa com um frame, um ID de mapa e um alvo de câmera.
| - (instancetype) 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.
| - (instancetype) initWithFrame: | (CGRect) | quadro | |
| ID do mapa: | (GMSMapID *) | ID do mapa | |
| câmera: | (GMSCameraPosition *) | câmera | |
Cria e retorna uma visualização de mapa com um frame, um ID de mapa e um alvo de câmera.
| - (nulo) startRendering |
Diz ao mapa para ativar seu renderizador.
Isso é opcional e idempotente.
- Observação:
- O uso foi suspenso. Esse método está obsoleto e será removido em uma versão futura.
| - (nulo) stopRendering |
Diz ao mapa para desligar o renderizador.
Isso é opcional e idempotente.
- Observação:
- O uso foi suspenso. Esse método está obsoleto e será removido em uma versão futura.
| - (nulo) claro |
Limpa toda marcação que foi adicionada ao mapa, incluindo marcadores, polilinhas e superposições de solo.
Isso não limpará o ponto de local visível nem redefinirá o mapType atual.
| - (nulo) setMinZoom: | (flutuação) | minZoom (em inglês) | |
| maxZoom: | (flutuação) | maxZoom | |
Define minZoom e maxZoom.
Esse método espera que o mínimo seja menor ou igual ao máximo e, caso contrário, gerará uma exceção com o nome NSRangeException.
| - (anulável GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | limites | |
| Encartes: | (UIEdgeInsets) | encartes | |
Crie um GMSCameraPosition que apresente bounds com padding.
A câmera não terá nenhuma direção nem inclinação, ou seja, virada 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 |
Altera a câmera de acordo com update.
A mudança da câmera é instantânea (sem animação).
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | position | |
| média: | (GMSCameraPosition *) | otherPosition | |
Verifique se as posições da câmera fazem com que ela seja renderizada da mesma forma, considerando o nível de precisão e as transformações usadas internamente.
| - (nulo) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition. |
Anima a câmera deste mapa para cameraPosition.
| - (nulo) animateToLocation: | (CLLocationCoordinate2D) | local |
Como animateToCameraPosition:, mas altera apenas o local da câmera (ou seja, do local atual para location).
| - (nulo) animateToZoom: | (flutuação) | zoom |
Como animateToCameraPosition:, mas altera apenas o nível de zoom da câmera.
Esse valor é ajustado por [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (nulo) animateToBearing: | (CLLocationDirection) | bearing |
Como animateToCameraPosition:, mas altera somente o rolamento da câmera (em graus).
Zero indica o norte verdadeiro.
| - (nulo) animateToViewingAngle: | (duplo) | viewingAngle (em inglês) |
Como animateToCameraPosition:, mas altera somente o ângulo de visão da câmera (em graus).
Esse valor será ajustado para um mínimo de zero (ou seja, voltado diretamente para baixo) e entre 30 e 45 graus em direção ao horizonte, dependendo da proximidade relativa com a Terra.
| - (nulo) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate (em inglês) |
Aplica cameraUpdate à câmera atual e usa o resultado conforme animateToCameraPosition:.
Amigos e documentação da função relacionada
- (NSString* const) kGMSAccessibilityCompass [related] |
Identificador de acessibilidade do botão de bússola.
- (NSString* const) kGMSAccessibilityMyLocation [related] |
Identificador de acessibilidade do botão "Meu local".
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
Identificador de acessibilidade para o rótulo de erro "fora da cota".
Documentação da propriedade
- (IBOutlet id<GMSMapViewDelegate>) delegar [read, write, assign] |
delegado 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 você pode usar 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 acabou de ser criado, o próximo frame. Ele nunca será nulo.
- (BOOL) myLocationEnabled [read, write, assign] |
Controla se o ponto My Location e o círculo de precisão estão ativados.
O padrão é NO.
- (CLLocation*) myLocation [read, assign] |
Se Meu local está ativado, revela onde o ponto de localização do aparelho está sendo desenhado.
Se estiver desativada ou ativada, mas não houver dados de localização disponíveis, ela será nula. Esta propriedade pode ser observada usando o KVO.
- (GMSMarker*) selectedMarker [read, write, assign] |
O marcador selecionado.
A definição desta propriedade seleciona um marcador específico, mostrando uma janela de informações nele. Se esta propriedade não for nula, defini-la como "nil" desmarca o marcador, ocultando a janela de informações. Esta propriedade pode ser observada usando o KVO.
- (BOOL) trafficEnabled [read, write, assign] |
Controla se o mapa está extraindo dados de tráfego, se disponível.
Isso está sujeito à disponibilidade dos dados de tráfego. O padrão é NO.
- (GMSMapViewType) mapType [read, write, assign] |
Controla o tipo de blocos do 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ó será aplicado se mapType for Normal.
- (flutuação) minZoom [read, assign] |
Zoom mínimo (o mais afastado da câmera).
O padrão é kGMSMinZoomLevel. Modificado com -setMinZoom:maxZoom:.
- (flutuante) maxZoom [read, assign] |
Zoom máximo (a câmera mais próxima da Terra pode estar).
O padrão é kGMSMaxZoomLevel. Modificado com -setMinZoom:maxZoom:.
- (BOOL) buildingsEnabled [read, write, assign] |
Se definida, as construções em 3D serão mostradas onde estiverem disponíveis.
O padrão é YES.
Isso pode ser útil ao adicionar uma camada de blocos personalizada ao mapa, a fim de torná-la mais clara em níveis altos de zoom. A alteração deste 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 esta configuração for definida como "NÃO", os caches de dados internos poderão ser limpos, e qualquer andar selecionado pelo usuário final poderá ser redefinido.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
Obtém a instância GMSIndoorDisplay, que permite observar ou controlar aspectos da exibição de dados internos.
- (GMSUISettings*) configurações [read, assign] |
Obtém o objeto GMSUISettings, que controla as configurações da interface do usuário para o mapa.
- Preenchimento (UIEdgeInsets) [read, write, assign] |
Controla a região "visível" da visualização.
Aplicando o preenchimento, uma área ao redor da borda da visualização pode ser criada, contendo os dados do mapa e os controles de IU.
Se o padding não estiver balanceado, o centro visual da visualização se moverá conforme necessário. O padding também afetará a propriedade projection, de modo que a região visível não inclua a área de padding. GMSCameraUpdate fitToBounds garantirá que este preenchimento e qualquer preenchimento solicitado sejam levados em consideração.
Esta propriedade pode ser animada dentro de 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 preenchimento.
Assim como o preenchimento, a área segura insere controles de mapa de posição, como a bússola, o botão "Meu local" e o seletor de solo na área de segurança 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.
Esta propriedade segue o protocolo informal UIAccessibility, exceto o valor padrão de YES.
- (GMSMapLayer*) camada [read, retain] |
Acesso de tipo de CALayer personalizado usado para a camada.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
Controla a frame rate de renderização.
O valor padrão é kGMSFrameRateMáximo.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Se não for nulo, restringe o alvo da câmera para que os gestos não possam fazer com que ele 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.