Vamos começar com um pequeno problema. Possuo uma base de dados com alguns poucos estabelecimentos cadastrados. Certo, vamos começar com 5 estabelecimentos.

Então, preciso desenvolver uma feature em meu app, na qual vou visualizar no mapa estabelecimentos que estão próximos a mim.

Fácil, não? Dado que cada estabelecimento em minha lista possui um “GeoPoint” (latitude e longitude), basta eu carregar minha lista de estabelecimentos para o app e sempre que eu mudar minha localização verifico item a item, calculando a distância entre o estabelecimento e minha localização e, por fim, verificar se a distância é menor que a esperada.

Teríamos algo assim:

for (Establishment *item in self.listEstablishment) {
    if ([self getDistance:item.location] <= 500) {
        [self addAnnotationForItem:item];
    }
}

Bem, supondo que nossa lista de estabelecimentos não passe de cinco, até que pode ser uma solução razoável e talvez resolva o problema.

Mas vamos sair do abstrato e entrar no mundo real. Pensando bem baixo, em um raio de cinco metros, nós já teríamos cinco estabelecimentos. Talvez mais, se houver dois ou mais que compartilhem o mesmo prédio/localização. Tendo isso como base, em 500 metros, nossa lista já aumentaria para algo em torno de 2 mil estabelecimentos.

Logo, sempre que eu mudar minha localização no mapa, eu faria 2 mil verificações. Levando em consideração que, mesmo eu estando parado, o método “didUpdateUserLocation” é chamado a cada 1,5 segundo; em apenas 10 segundos, já teríamos feito quase 20 mil verificações.

É, já deu pra notar que essa não é uma boa solução para o nosso problema. Isso que nossa base de dados está apenas começando. Esses 2 mil estabelecimentos facilmente se transformam em 15, 50, 100, 300, 500 mil estabelecimentos.

What can I do?

GeoFire

Lib open source do Firebase, criada com o propósito de permitir consultas à base de dados com base em sua geolocalização.

Sim, de forma simples e prática, o GeoFire cria uma query e um observer para que sempre que sua localização for alterada você receba uma lista de itens (estabelecimentos) que estejam localizados a um raio X de sua localização geográfica.

Mas como isso funciona?

GeoQuery

GeoQuery é um objeto da lib GeoFire que recebe a sua localização atual e o raio (em km) de consulta.

GFCircleQuery *circleQuery = [self.geoFire queryAtLocation:centerLocation withRadius:distance];

GFCircleQuery é uma subclasse de GFQuery (GeoQuery) que contém duas properties:

//
//  GFCircleQuery.h
//  GeoFire
//
//  Created by Jonny Dimond on 7/11/14.
//  Copyright (c) 2016 Firebase. All rights reserved.
//

@interface GFCircleQuery : GFQuery

/**
 * The center of the search area. Update this value to update the query. Events are triggered for any keys that move
 * in or out of the search area.
 */
@property (atomic, readwrite) CLLocation *center;

/**
 * The radius of the geo query in kilometers. Update this value to update the query. 
Events are triggered for any keys
 * that move in or out of the search area.
 */
@property (atomic, readwrite) double radius;

@end

//ADD
[query observeEventType:GFEventTypeKeyEntered withBlock:^(NSString *key, CLLocation *location) {
        
    if (key && location) {
        //Recebemos uma key que referencia um item em nossa base e recebemos um location com as coordenadas deste item
        //A partir daí, tratamos neste bloco da forma que nossa aplicação espera
    }
}];

//REMOVE
[query observeEventType:GFEventTypeKeyExited withBlock:^(NSString *key, CLLocation *location) {
        
    if (key && location) {
        //Recebemos uma key que referencia um item em nossa base e recebemos um location com as coordenadas deste item
        //A partir daí, tratamos neste bloco da forma que nossa aplicação espera
    }
}];

//UPDATE
[query observeEventType:GFEventTypeKeyMoved withBlock:^(NSString *key, CLLocation *location) {
        
    if (key && location) {
        //Recebemos uma key que referencia um item em nossa base e recebemos um location com as coordenadas deste item
        //A partir daí, tratamos neste bloco da forma que nossa aplicação espera
    }
}];