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 com um dos construtores -init ou -initWithOptions:.
GMSMapView só pode ser lido e modificado na 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 em um comportamento indefinido.
Funções membro público | |
| (instancetype) | init |
| Inicializa com CGRectZero e opções padrão. | |
| (instancetype) | - initWithOptions: |
| Cria uma nova visualização de mapa com as opções fornecidas. | |
| (instancetype) | - initWithFrame: |
| (instancetype anulável) | - initWithCoder: |
| (instancetype) | - initWithFrame:camera: |
| Cria e retorna uma visualização de mapa, com um frame e um alvo de câmera. | |
| (instancetype) | - initWithFrame:mapID:camera: |
| Cria e retorna uma visualização de mapa com um frame, ID do mapa e alvo da câmera. | |
| (void) | - startRendering |
| Instrui o mapa a ativar o renderizador. | |
| (void) | - stopRendering |
| Instrui o mapa a desativar o renderizador. | |
| (void) | - limpar |
| Limpa todas as marcações adicionadas ao mapa, incluindo marcadores, polilinhas e sobreposições de solo. | |
| (void) | setMinZoom:maxZoom: |
Define minZoom e maxZoom. | |
| (nullable GMSCameraPosition *) | cameraForBounds:insets: |
Crie uma GMSCameraPosition que apresente bounds com padding. | |
| (void) | moveCamera: |
Muda a câmera de acordo com update. | |
| (BOOL) | - areEqualForRenderingPosition:position: |
| Verifique se as posições definidas 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. | |
| (GMSDatasetFeatureLayer *) | — datasetFeatureLayerOfDatasetID: |
| Retorna uma camada de elementos do conjunto de dados especificado. | |
| (void) | - animateToCameraPosition: |
Anima a câmera deste mapa para cameraPosition. | |
| (void) | – animateToLocation: |
Como animateToCameraPosition:, mas muda somente o local da câmera (ou seja, do local atual para location). | |
| (void) | - animateToZoom: |
| As animateToCameraPosition:, mas altera apenas o nível de zoom da câmera. | |
| (void) | - animateToBearing: |
| As animateToCameraPosition:, mas altera somente o rolamento da câmera (em graus). | |
| (void) | - animateToSeeAngle: |
| Como animateToCameraPosition:, mas altera somente o ângulo de visão da câmera (em graus). | |
| (void) | - animateWithCameraUpdate: |
Aplica cameraUpdate à câmera atual e usa o resultado conforme 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 de câmera. | |
| (instancetype) | + mapWithFrame:mapID:camera: |
| Iniciador 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 IBOutlet< GMSMapViewDelegate > | delegar |
| Delegado de GMSMapView. | |
| GMSCameraPosition * | camera |
| Controla a câmera, que define a orientação do mapa. | |
| 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 "Meu local" estiver ativado, essa opção revela onde o ponto de localização do dispositivo está sendo desenhado. | |
| GMSMarker * | selectedMarker |
| O marcador selecionado. | |
| BOOL | trafficEnabled |
| Controla se o mapa está mostrando dados de tráfego, se disponíveis. | |
| GMSMapViewType (em inglês) | mapType |
| Controla o tipo de blocos de mapa que devem ser exibidos. | |
| GMSMapStyle * | mapStyle |
| Controla o estilo do mapa. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| Mude o mapa para o UIUserInterfaceStyle desejado. | |
| float | minZoom |
| Zoom mínimo: o máximo de zoom da câmera pode ser aplicado. | |
| float | maxZoom |
| Zoom máximo: a câmera mais próxima da Terra | |
| BOOL | buildingsEnabled |
| Se definida, as construções em 3D serão exibidas quando estiverem disponíveis. | |
| BOOL | indoorEnabled |
| Define se os mapas internos são exibidos, quando disponíveis. | |
| GMSIndoorDisplay * | indoorDisplay |
| Recupera a instância GMSIndoorDisplay, que permite observar ou controlar aspectos da exibição de dados internos. | |
| GMSUISettings * | configurações |
| Recupera o objeto GMSUISettings, que controla as configurações da interface do usuário para o mapa. | |
| UIEdgeInsets | padding (link em inglês) |
| 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 | preferredFrameRate |
| Controla o frame rate de renderização. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| Se não for nulo, restringirá 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 condicionalmente disponíveis (dependendo do ID do mapa ou de outras configurações do mapa) disponíveis no momento atual. | |
Funções relacionadas | |
Observe que essas não são funções de membro. | |
| NSString *const | kGMSAccessibilityCompass |
| Identificador de acessibilidade para o 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
| - (instancetype) init |
Inicializa com CGRectZero e opções padrão.
| - (instancetype) initWithOptions: | (GMSMapViewOptions não nulas *) | options |
Cria uma nova visualização de mapa com as opções fornecidas.
O valor do objeto de opções é copiado por este método.
| — (instancetype) initWithFrame: | (CGRect) | frame (link em inglês) |
| - (tipo de instância anulável) initWithCoder: | (NSCoder *) | codificador |
| + (instancetype) mapWithFrame: | (CGRect) | frame (link em inglês) | |
| câmera: | (GMSCameraPosition *) | câmera | |
Cria e retorna uma visualização de mapa com um frame e um alvo de câmera.
| + (instancetype) mapWithFrame: | (CGRect) | frame (link em inglês) | |
| ID do mapa: | (GMSMapID *) | mapID | |
| câmera: | (GMSCameraPosition *) | câmera | |
Iniciador de conveniência para criar e retornar uma visualização de mapa com um frame, ID do mapa e alvo da câmera.
| — (instancetype) initWithFrame: | (CGRect) | frame (link em inglês) | |
| câmera: | (GMSCameraPosition *) | câmera | |
Cria e retorna uma visualização de mapa, com um frame e um alvo de câmera.
- Observação:
- O uso foi descontinuado. Use -init ou -initWithOptions: em vez disso.
| — (instancetype) initWithFrame: | (CGRect) | frame (link em inglês) | |
| ID do mapa: | (GMSMapID *) | mapID | |
| câmera: | (GMSCameraPosition *) | câmera | |
Cria e retorna uma visualização de mapa com um frame, ID do mapa e alvo da câmera.
- Observação:
- O uso foi descontinuado. Use -init ou -initWithOptions: em vez disso.
| - (void) startRendering |
Instrui o mapa a ativar o renderizador.
É 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 desativar o renderizador.
É 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 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: | (float) | minZoom | |
| maxZoom: | (float) | maxZoom | |
Define minZoom e maxZoom.
Esse método espera que o mínimo seja menor ou igual ao máximo. Caso contrário, ele gerará uma exceção com o nome NSRangeException.
| - (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | limites | |
| encartes: | (UIEdgeInsets) | encartes | |
Crie uma GMSCameraPosition que apresente bounds com padding.
A câmera terá direção e inclinação zero (ou seja, voltada para o norte e diretamente para a Terra). Isso leva em conta o frame e o preenchimento deste 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 da câmera é instantânea (sem animação).
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | position | |
| média: | (GMSCameraPosition *) | otherPosition | |
Verifique se as posições definidas 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 |
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, o estilo baseado em 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.
Requer o renderizador Metal. Saiba como ativar o Metal em https://developers.google.com/maps/documentation/ios-sdk/config#use-metal
| - (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
Retorna uma camada de elementos do conjunto de dados especificado.
Os IDs do conjunto de dados precisam ser configurados no Console do Cloud.
Se não houver um conjunto de dados do ID especificado no mapa ou se o estilo baseado em dados não estiver ativado, o isAvailable da camada resultante será NO e não responderá a nenhuma chamada.
| – (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
Anima a câmera deste mapa para cameraPosition.
| – (void) animateToLocation: | (CLLocationCoordinate2D) | local |
Como animateToCameraPosition:, mas muda somente o local da câmera (ou seja, do local atual para location).
| - (void) animateToZoom: | (float) | zoom |
As animateToCameraPosition:, mas altera apenas o nível de zoom da câmera.
Esse valor é limitado por [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| – (void) animateToBearing: | (CLLocationDirections) | bearing |
As animateToCameraPosition:, mas altera somente o rolamento da câmera (em graus).
Zero indica o norte verdadeiro.
| – (void) animateToVisualizingAngle: | (duplo) | viewingAngle |
Como animateToCameraPosition:, mas altera somente o ângulo de visão da câmera (em graus).
Esse valor será fixado a um mínimo de zero (isto é, voltado para baixo) e entre 30 e 45 graus em direção ao horizonte, dependendo da proximidade relativa com a Terra.
| – (void) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Aplica cameraUpdate à câmera atual e usa o resultado conforme animateToCameraPosition:.
Documentação de amigos e funções relacionadas
– (NSString* const) kGMSAccessibilityCompass [related] |
Identificador de acessibilidade para o 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 da IBOutlet<GMSMapViewDelegate>) delegar [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.
- Projeção (GMSProjection*) [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 definida explicitamente ou o mapa acabou de ser criado, o frame seguinte. 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, essa opção 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, ela será nula. Essa propriedade pode ser observada 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 esta propriedade for diferente de nula, se definida como nula, o marcador será desmarcado, ocultando a janela de informações. Essa propriedade pode ser observada usando KVO.
– (BOOL) trafficEnabled [read, write, assign] |
Controla se o mapa está mostrando dados de tráfego, 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ó será aplicado se mapType for Normal.
– (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
Altere o mapa para o UIUserInterfaceStyle desejado.
Isso substitui o comportamento padrão do UIKit e usa UIUserInterfaceStyleLight como padrão para garantir a compatibilidade com versões anteriores. Isso afeta o esquema de cores dos tipos de mapa "Normal" e "Relevo".
- (flutuante) minZoom [read, assign] |
Zoom mínimo: o máximo de zoom da câmera pode ser aplicado.
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 definida, as construções em 3D serão exibidas quando estiverem disponíveis.
O padrão é YES.
Isso pode ser útil ao adicionar uma camada de blocos personalizada ao mapa, para torná-lo mais claro em níveis altos de zoom. Alterar esse 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 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] |
Recupera a instância GMSIndoorDisplay, que permite observar ou controlar aspectos da exibição de dados internos.
- (GMSUISettings*) configurações [read, assign] |
Recupera 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 contendo dados do mapa, mas sem controles da interface.
Se o padding não estiver equilibrado, o centro visual da visualização se moverá conforme apropriado. O padding também vai afetar a propriedade projection, então a região visível não vai incluir a área de padding. GMSCameraUpdate fitToBounds garantirá que tanto esse preenchimento quanto qualquer preenchimento solicitado sejam levados em consideração.
Essa 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.
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 é kGMSMapViewPaddingAdjustmentBehaviorSempre.
– (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 de YES.
- camada (GMSMapLayer*) [read, retain] |
Acessador do tipo CALayer personalizado usado para a camada.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
Controla o frame rate de renderização.
O valor padrão é kGMSFrameRateMáximo.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Se não for nulo, restringirá 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 condicionalmente disponíveis (dependendo do ID do mapa ou de outras configurações do mapa) disponíveis no momento atual.
Não inclui recursos sempre disponíveis.