realm-mapview

Additional

Language
Java
Version
0.9.2 (May 30, 2016)
Created
Oct 19, 2015
Updated
May 1, 2017 (Retired)
Owner
Thorben Primke (thorbenprimke)
Contributors
Donn Felker (donnfelker)
Thorben Primke (thorbenprimke)
2
Activity
Badge
Generate
Download
Source code

A MapView that is powered by Realm

A simple, yet powerful wrapper around the SupportMapFragment with support for clustering and built-in support for querying and rendering a Realm results.

##How To Include It:

 repositories {
        // ...
        maven { url "https://jitpack.io" }
    }
 dependencies {
         compile 'com.github.thorbenprimke:realm-mapview:0.9.2'
 }

##Demo

How To Get Started:

Using the RealmClusterMapFragment is as simple as extending it and implementing three methods. The following is an example:

public class BusinessRealmClusterMapFragment extends
    RealmClusterMapFragment<Business> {

    @Override
    protected String getTitleColumnName() {
        return "name";
    }

    @Override
    protected String getLatitudeColumnName() {
        return "latitude";
    }

    @Override
    protected String getLongitudeColumnName() {
        return "longitude";
    }
}

The fragment loads data from the Realm of type Business and the provided columnNames are used to look up the latitude, longitude and the marker's title.

All that's left at this point, is to include the fragment in your Activity's layout file or create it programmatically.

##Other:

Your projects's AndroidManifest has to include the following valid Map V2 key. You can obtain a key from Google Developer Console

<meta-data
    android:name="com.google.android.maps.v2.API_KEY"
    android:value="YOUR_KEY"/>

##Feedback/More Features: I would love to hear your feedback. Do you find the RealmClusterMapFragment useful? What functionality are you missing? Open a Github issue and let me know. Thanks!

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Included dependencies are:
Realm (https://github.com/realm/realm-java)
Google Maps Android API utility library (https://github.com/googlemaps/android-maps-utils)