MapViewPager

Additional

Language
Java
Version
1.0.0 (Jan 31, 2016)
Created
Jan 28, 2016
Updated
Feb 1, 2016 (Retired)
Owner
Miguel Ángel Moreno (nitrico)
Contributor
Miguel Ángel Moreno (nitrico)
1
Activity
Badge
Generate
Download
Source code
APK file

Promotion

MapViewPager

Android library that connects ViewPager fragments with Google Maps markers.

Check out the sample apk !

Notice

  • Not fully tested yet, but it works perfectly on my Nexus 5 running Marshmallow.
  • Only android.support.v4.app.Fragment and SupportMapFragment supported right now.
  • It is my first Android lib. Tips, suggestions and requests are all welcome.

Features

  • Supports any amount of markers per fragment.
  • Default camera position (for fragments with 0 or more than 1 markers) automatically calculated.

Download

Gradle

dependencies {
    compile 'com.android.support:appcompat-v7:23.1.1'
    compile 'com.google.android.gms:play-services-maps:8.4.0'
    compile 'com.github.nitrico.mapviewpager:mapviewpager:1.0.0'
}

Usage

Don't forget to add the right permissions and your Google Maps API key to your AndroidManifest.xml file.

Create a ViewPager adapter extending from MapViewPager.Adapter or MapViewPager.MultiAdapter and override method CameraPosition getCameraPosition(int position) or List<CameraPosition> getCameraPositions(int position) returning the markers camera position for each fragment.

To create a CameraPosition: CameraPosition.fromLatLngZoom(new LatLng(latitude, longitude), zoom);

Include the view in your xml layout

<com.github.nitrico.mapviewpager.MapViewPager
        android:id="@+id/mapViewPager"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:viewPagerWeight="1"
        app:mapWeight="1"
        app:mapGravity="1"
        app:mapOffset="56dp" />

Find the view in your activity and then call mapViewPager.start(this, adapter) or mapViewPager.start(this, adapter, callback) passing the AppCompatActivity (or FragmentActivity) and MapViewPager.Adapter (or MapViewPager.MultiAdapter) instances. You can also pass a MapViewPager.Callback instance to get notified when the GoogleMap object is created and working.

Builder

If you want more control on how to display the map and the ViewPager, for example to overlap each other, you can add a <android.support.v4.view.ViewPager> and a <fragment class="com.google.android.gms.maps.SupportMapFragment"> to your activity layout and then and pass them to create the MapViewPager object using the MapViewPager.Builder class:

MapViewPager mvp = new MapViewPager.Builder(this) // this is Context
        .mapFragment(mapFragment)                 // mapFragment is SupportMapFragment
        .viewPager(viewPager)                     // viewPager is ViewPager
        .adapter(adapter)                         // adapter is MapViewPager.Adapter or MapViewPager.MultiAdapter
        .position(initialPosition)                // Optional initialPosition is int     
        .callback(callback)                       // Optional callback is MapViewPager.Callback
        .markersAlpha(alpha)                      // Optional
        .mapPadding(left, top, right, bottom)     // Optional
        .mapOffset(offset)                        // Optional
        .build();

Remember that mapFragment is a Fragment, not a View! To find it: mapFragment = (SupportMapFragment) activity.getSupportFragmentManager().findFragmentById(R.id.mapFragment);

Check the examples in the sample folder.

Documentation

XML attributes

They are all optional.

Attribute Format Default Description
viewPagerWeight integer 1 Weight of the viewpager in the layout
mapWeight integer 1 Weight of the map in the layout
mapGravity integer (0..3) 1 Position of the map in the layout: 0=left, 1=top, 2=right, 3=bottom
mapOffset dimension 32dp Map padding for multiple markers on the map
mapPaddingLeft dimension 0dp Left map padding
mapPaddingTop dimension 0dp Top map padding
mapPaddingRight dimension 0dp Right map padding
mapPaddingBottom dimension 0dp Bottom map padding
markersAlpha float (0..1) 0.4 Opacity of markers when deactivated

Public methods

void start(@NonNull FragmentActivity activity,
           @NonNull MapViewPager.AbsAdapter mapAdapter)
void start(@NonNull FragmentActivity activity,
           @NonNull MapViewPager.AbsAdapter mapAdapter,
           @Nullable MapViewPager.Callback callback)
void start(@NonNull FragmentActivity activity,
           @NonNull MapViewPager.AbsAdapter mapAdapter,
           int initialPosition) 
void start(@NonNull FragmentActivity activity, 
           @NonNull MapViewPager.AbsAdapter mapAdapter,
           int initialPosition,
           @Nullable MapViewPager.Callback callback)

GoogleMap getMap()
SupportMapFragment getMapFragment()
ViewPager getViewPager() 
CameraUpdate getDefaultPosition()

// when adapter extends MapViewPager.Adapter
Marker getMarker(int position)
List<Marker> getMarkers()

// when adapter extends MapViewPager.MultiAdapter
Marker getMarker(int page, int position)
List<Marker> getMarkers(int page) 
List<List<Marker>> getAllMarkers()
CameraUpdate getDefaultPosition(int page) 
List<CameraUpdate> getDefaultPositions()

Warning! In order to avoid NullPointerExceptions when calling any of those getters before the actual GoogleMap object is created, you should use them only after onMapViewPagerReady() method in the callback is called.

To override in MapViewPager.Callback effective classes

void onMapViewPagerReady()

To override in MapViewPager.Adapter effective classes

CameraPosition getCameraPosition(int position)

To override in MapViewPager.MultiAdapter effective classes

List<CameraPosition> getCameraPositions(int page)
String getMarkerTitle(int page, int position)

Both adapters extends from FragmentStatePagerAdapter, so you also need to override

CharSequence getPageTitle(int position) // this will be used as marker title in MapViewPager.Adapter
Fragment getItem(int position)
int getCount()

Author

Miguel Ángel Moreno

I'm available to be hired, Contact me!

Email Facebook Google+ Linked.in Twitter

License

Copyright 2016 Miguel Ángel Moreno

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.