Geo on fire is an open source library to query location based data in Firebase. It follows a whole new principle of architecture, which makes it extremly fast and highly scaleable. With the right setup you are able to query millions of locations in just fractions of a second. You can learn more about the principle in the advanced usage guide. (not online so far, stay tuned)
In addition it offers you the possibility to listen to the queries in real time and recieve changes based on the event types you've specified. But that's not all. There's a feature which gives you the ability to priorize data and make the user expirience even better.
And by the way, there is not just one query method. You can choose between a radius based query (see dog match demo) and a boundaries based query. (see event map demo)
And the best, you will automatically recieve the fetched entries. So there is no manual fetching needed.
Currently there are three ways to download the library. But before you download the library make sure Firebase is already installed, since it's not a dependency of gof itself.
Notice: NodeJS is not supported so far, but it will be added soon. Subscribe here to get mentioned when the time is ready.
Add it like this to your HTML
<!-- Firebase -->
<script src="https://www.gstatic.com/firebasejs/4.5.0/firebase.js"></script>or install it from npm
$ npm install firebase --saveIf you are running gof in the browser you can include it directly from the CDN like this:
<!-- gof -->
<script src="https://cdn.jsdelivr.net/npm/gof@0.1.1/dist/gof.min.js"></script>Download it from the npm repository the following way:
$ npm install gof --saveOr download it from bower the following way:
$ bower install gof --saveNow let's get started. As you will see, the usage is very simple.
Before you're able to use gof you need to initialize your firebase project.
var fb = firebase.initializeApp(config); // get 'config' from firebaseNow you are able to create a gof reference by simply doing the following.
// the name of your database nodes e.g. events, hotels - is totally up to you
var name = 'entries';
// the firebase database ref - must be passed with the .ref()
var ref = fb.database().ref();
// creates a new geoOnFire instance
var gof = new geoOnFire(name, ref);That's it! Now you are able to run gof operations. Go trough the guides to see how it works.
Basically all the user operations proivded by gof can be splitted in two cateogries. There are writing and there are reading operations. Make sure you always use the built-in methods the library provides to modify your geolocations data. Otherwise there's a chance that you get corrupt and invalid data.
Here you can find some advanced concept to make the best out from gof.
- security rules
- performance optimization (coming soon)
- API Reference
- Gof core principle (coming soon)
Currently there are the two demo's available. These are just some basic implementations to give you an idea about how powerful gof is. They are far away from perfect.
- dog matching app (tinder clone - using radius query)
- event map app (airbnb like map - using boundaries query)
Is there any gof using project you want to share with the world? Simply create an issue with the url and I do the rest.
I would love to see your contributions to the project. Till now I was not able to create some guidelines. If there are already any interests so far, we can communicate trough the issues.
Check out the 1.0.0 milestone to see what's next. Generally I've got tons of ideas, but just a very few time to work on them. So if you are interested in contributing you are more than just welcome!
I'm also looking forward to migrate the library to other db services like mongoDB or pouchDB.
So basically the reason why I'm doing this, is because I've seen a lot of people struggling while buildung their json database structure. Espacially when it comes to more complex queries, firebase does not support you well enough. (by the way I'm so happy to see the new cloud firestore) This library should kind of like give you an idea.
MIT