É possível adicionar imagens sobre o mapa como uma camada de blocos. Elas são posicionadas sobre um bloco do mapa com um nível de zoom específico. Com blocos suficientes, você pode complementar os dados do mapa do Google para todo o mapa, em vários níveis de zoom.
Introdução
As camadas de blocos (às vezes chamadas de sobreposições de blocos) permitem sobrepor imagens nos blocos do mapa de base do Google. Essa é uma excelente forma de adicionar dados, como pontos de interesse ou informações de trânsito, e imagens locais ao seu app. Quando combinadas com o tipo de mapa kGMSTypeNone
, as camadas de blocos permitem substituir os dados do mapa básico do Google pelos seus.
As camadas de blocos são úteis para adicionar várias imagens ao mapa, geralmente cobrindo áreas geográficas amplas. Por outro lado, as sobreposições de solo são úteis para corrigir uma única imagem em um ponto do mapa.
Coordenadas de bloco
A API Maps divide as imagens de cada nível de zoom em um conjunto de blocos de mapa quadrados, que são organizados em uma grade ordenada. Quando a rolagem é usada para mudar o local ou o nível de zoom do mapa, a API Maps determina quais blocos são necessários e converte isso em um conjunto de blocos a recuperar.
Para a projeção de Mercator do Google, o bloco com a coordenada (0,0) fica sempre no canto noroeste do mapa, com valores x
aumentando de oeste para leste e valores y
aumentando de norte para sul.
Os blocos são indexados usando coordenadas x,y
dessa origem. Por exemplo, no nível de zoom 2, quando a Terra está dividida em 16 blocos, cada bloco pode ser referenciado por um par de x,y
exclusivo:
Cada bloco de mapa é um quadrado de 256x256 pontos. No nível de zoom 0, o mundo inteiro é renderizado em um único bloco. Cada nível de zoom aumenta a ampliação por um fator de dois. Portanto, no nível de zoom 1, o mapa é renderizado como uma grade de blocos 2 x 2 ou uma grade 4 x 4 no nível de zoom 2, uma grade 8 x 8 no nível de zoom 3 e assim por diante. Se você estiver criando imagens para uma camada de blocos, será necessário gerar uma nova imagem de 256 x 256 pontos para cada bloco em cada nível de zoom que você pretende oferecer.
Como adicionar uma camada de blocos
- Instancie um objeto
GMSURLTileLayer
ou uma subclasse personalizada deGMSTileLayer
/GMSSyncTileLayer
. - Se quiser, modifique a propriedade
zIndex
para ajustar a posição em relação a outras camadas de blocos. - Atribua o objeto
GMSTileLayer
ao mapa definindo a propriedademap
.
O SDK do Maps para iOS oferece três classes que podem ser usadas para implementar uma camada de blocos. Em cada classe, você precisa definir como buscar o bloco de mapa correto para um determinado conjunto de coordenadas {x,y,zoom}
. As opções disponíveis são estas:
- Subclasse
GMSSyncTileLayer
, fornecendo a implementação detileForX:y:zoom
que retorna instâncias deUIImage
. - Subclasse
GMSTileLayer
, fornecendo a implementação do método assíncronorequestTileForX:y:zoom
que depois chama de volta com uma imagem de bloco. - Use a classe existente,
GMSURLTileLayer
, para buscar blocos automaticamente de URLs, fornecendo o blocoGMSTileURLConstructor
.GMSURLTileLayer
é uma classe concreta que não pode ser uma subclasse.
No caso da subclasse GMSSyncTileLayer
ou GMSTileLayer
, fornecer um resultado de bloco nil
informará ao SDK do Maps para iOS que os dados estão indisponíveis no momento, mas que podem estar disponíveis no futuro. Como alternativa,
retorne kGMSTileLayerNoTile
para indicar que não há um bloco nesse
local.
Para GMSURLTileLayer
, retornar nil
de GMSTileURLConstructor
indica
que não há um bloco nesse local.
Usar "GMSURLTileLayer" para buscar blocos em URLs
GMSURLTileLayer
não requer subclasses, mas você precisa implementar o bloco GMSTileURLConstructor
. O código abaixo mostra como usar GMSURLTileLayer
para mostrar a planta baixa de um edifício de vários andares.
Swift
let floor = 1 // Implement GMSTileURLConstructor // Returns a Tile based on the x,y,zoom coordinates, and the requested floor let urls: GMSTileURLConstructor = { (x, y, zoom) in let url = "https://www.example.com/floorplans/L\(floor)_\(zoom)_\(x)_\(y).png" return URL(string: url) } // Create the GMSTileLayer let layer = GMSURLTileLayer(urlConstructor: urls) // Display on the map at a specific zIndex layer.zIndex = 100 layer.map = mapView
Objective-C
NSInteger floor = 1; // Create the GMSTileLayer GMSURLTileLayer *layer = [GMSURLTileLayer tileLayerWithURLConstructor:^NSURL * _Nullable(NSUInteger x, NSUInteger y, NSUInteger zoom) { NSString *url = [NSString stringWithFormat:@"https://www.example.com/floorplans/L%ld_%lu_%lu_%lu.png", (long)floor, (unsigned long)zoom, (unsigned long)x, (unsigned long)y]; return [NSURL URLWithString:url]; }]; // Display on the map at a specific zIndex layer.zIndex = 100; layer.map = mapView;
Subclasse GMSSyncTileLayer
para veicular blocos como um UIImage
GMSSyncTileLayer
e GMSTileLayer
são classes abstratas projetadas para serem
subclasses. Você pode usar essas classes para disponibilizar blocos como de UIImage
. O exemplo abaixo mostra como renderizar uma imagem personalizada em alguns blocos no mapa criando subclasses de GMSSyncTileLayer
.
Swift
class TestTileLayer: GMSSyncTileLayer { override func tileFor(x: UInt, y: UInt, zoom: UInt) -> UIImage? { // On every odd tile, render an image. if (x % 2 == 1) { return UIImage(named: "australia") } else { return kGMSTileLayerNoTile } } }
Objective-C
@interface TestTileLayer : GMSSyncTileLayer @end @implementation TestTileLayer - (UIImage *)tileForX:(NSUInteger)x y:(NSUInteger)y zoom:(NSUInteger)zoom { // On every odd tile, render an image. if (x % 2 == 1) { return [UIImage imageNamed:@"australia"]; } else { return kGMSTileLayerNoTile; } } @end
Para adicionar a camada ao seu mapa, instancie o objeto e defina sua propriedade de mapa.
Swift
let layer = TestTileLayer() layer.map = mapView
Objective-C
GMSTileLayer *layer = [[TestTileLayer alloc] init]; layer.map = mapView;
Blocos de DPI alto para dispositivos Retina
É possível usar imagens de DPI alto com GMSSyncTileLayer
ou GMSURLTileLayer
definindo tileSize
como 512.
A propriedade tileSize
indica o número de pixels que as imagens de bloco retornadas preferem mostrar. O padrão é 256, a dimensão de um bloco do Google Maps em um dispositivo que não seja Retina.
Se você está mostrando blocos de DPI normais em um dispositivo com DPI alto, pode aumentar as
imagens definindo tileSize
como 512. Observe que o aumento do dimensionamento das imagens pode reduzir a qualidade, especialmente para linhas finas ou texto. Para melhores resultados, combine o
tileSize
e o DPI da imagem à tela. Os mapas mostrados em um dispositivo com tela Retina ficam melhores ao mostrar imagens de DPI alto com um tileSize
de 512. Já os mapas mostrados em dispositivos não Retina ficam ótimos com imagens normais e com o tileSize
padrão de 256.
Como limpar blocos desatualizados
Se os blocos fornecidos pela camada ficarem "desatualizados", o método
clearTileCache
precisará ser chamado na camada para forçar uma atualização. Isso fará
com que todos os blocos dessa camada sejam recarregados.
Swift
layer.clearTileCache()
Objective-C
[layer clearTileCache];