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.

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!

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.