MapView (mappedin 1.6.1 API)

java.lang.Object
- Fragment
- - com.mappedin.sdk.MapView

```
public class MapView
extends Fragment
```
MapView is a custom view designed to handle displaying Maps for a Venue. call setMap(Map, MappedinCallback) to display the first map.

Constructor Summary

Constructors
Constructor and Description

MapView()

Constructors
Constructor and Description
`MapView()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAllStoreLabels(Venue venue, TextPaint textPaint)` Adds store labels to all of the Polygons in this Venue.
`void`	`addElement(Element child)` Add one child element into the MapView
`void`	`contractMaps(MappedinCallback<Map> callback)`
`void`	`expandMaps(Map[] maps, Vector3 translation, MappedinCallback<Map> callback)`
`void`	`frame(Focusable[] framing, float heading, float tilt, float over)` move camera to fit all focusable objects into screen with request heading and tilt in period of time
`void`	`frame(Focusable[] framing, float heading, float tilt, float over, float padding)` move camera to fit all focusable objects into screen with request heading, tilt and padding in period of time
`void`	`frame(Focusable framing, float heading, float tilt, float over)` move camera to fit focusable object into screen with request heading and tilt in period of time
`void`	`frame(Focusable framing, float heading, float tilt, float over, float padding)` move camera to fit focusable object into screen with request heading, tilt and padding in period of time
`int`	`getBackgroundColor()` Gets the MapView background color
`float`	`getCameraHeading()` Returns the current direction the MapView is pointing at, in radians, relative to North.
`float`	`getCameraTilting()` Returns how much the MapView camera is tilted up or down, in radians
`boolean`	`getRotateGestureEnabled()` Returns whether the user can rotate the map with gestures
`View`	`onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)`
`void`	`onDrawFrame(GL10 gl)`
`void`	`onPause()`
`void`	`onResume()`
`void`	`onSurfaceChanged(GL10 gl, int width, int height)`
`void`	`onSurfaceCreated(GL10 gl, EGLConfig config)`
`void`	`orbit(Focusable[] orbiting, float heading, float tilt, float over)` move camera to fit all focusable objects into screen with request heading and tilt in period of time
`void`	`orbit(Focusable[] orbiting, float heading, float tilt, float over, float padding)` move camera to fit all focusable objects into screen with request heading, tilt and padding in period of time
`void`	`orbit(Focusable orbiting, float heading, float tilt, float over)` Move the camera to fit a focusable object into screen with, rotating to the requested heading and tilt, over a period of time
`void`	`orbit(Focusable orbiting, float heading, float tilt, float over, float padding)` Move the camera to fit a focusable object into screen with, rotating to the requested heading, tilt and padding, over a period of time
`void`	`removeAllElements()` Remove all the child elements in this MapView
`void`	`removeAllStoreLabels(Venue venue)` Removes all store labels from all maps in the venue
`void`	`removeElement(Element child)` Remove the specific child element from the MapView
`void`	`resetPolygon(Polygon polygon)` Sets the (highlight)polygon back to it's original color and height does nothing if not highlight polygon
`void`	`setBackgroundColor(int color)` Sets the MapView background color
`void`	`setColor(Polygon polygon, int color, float over)` Changes the polygon color, animated over some time.
`void`	`setColor(Polygon polygon, int color, int labelColor, float over)` Changes the polygon and text annotation color, animated over some time.
`void`	`setDelegate(MapViewDelegate delegate)` Your MapViewDelegate, whose functions will get called when the has certain interactions with the MapView
`void`	`setHeight(Polygon polygon, float height, float over)` Changes the polygon height over time.
`void`	`setMap(Map map)` Sets the MapView to display specific map associated with the current venue.
`void`	`setMap(Map map, MappedinCallback<Map> callback)` Sets the MapView to display specific map associated with the current venue.
`void`	`setRotateGestureEnabled(boolean enabled)` Sets whether the user can rotate the map with gestures
`void`	`zoom(int level, float over)` Zooms in/out the camera

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MapView
```
public MapView()
```
- Method Detail
  - onCreateView
```
public View onCreateView(LayoutInflater inflater,
                         ViewGroup container,
                         Bundle savedInstanceState)
```
  - onPause
```
public void onPause()
```
  - onResume
```
public void onResume()
```
  - setBackgroundColor
```
public void setBackgroundColor(int color)
```
    Sets the MapView background color
    
    Parameters:
    
    color - the color of the background
  - getBackgroundColor
```
public int getBackgroundColor()
```
    Gets the MapView background color
  - setMap
```
public void setMap(Map map)
```
    Sets the MapView to display specific map associated with the current venue.
    
    This will also draw any Element objects (like part of a Path) that fall onto the new map.
    Parameters:
    map - The map to display. Typically this would be another floor.
    code snip:
    
    mapView.setMap(polygon.getMap());
  - setMap
```
public void setMap(Map map,
                   MappedinCallback<Map> callback)
```
    Sets the MapView to display specific map associated with the current venue. trigger the MappedinCallback.onComplete when map loading is finished
    
    This will also draw any Element objects (like part of a Path) that fall onto the new map.
    Parameters:
    
    map - The map to display. Typically this would be another floor.
    callback - MappedinCallback call back function when mapView finish loading map. onComplete function should use runOnUiThread (only the least callback will be called)
    code snip:
    
    MappedinCallback setMapCallback = new MappedinCallback() { @Override public void onCompleted(Map map) { runOnUiThread(new Runnable() { @Override public void run() { hideLoadingLogo() } }); } @Override public void onError(Exception exception) { } }; mapView.setMap(polygon.getMap(), setMapCallback);
  - setDelegate
```
public void setDelegate(MapViewDelegate delegate)
```
    Your MapViewDelegate, whose functions will get called when the has certain interactions with the MapView
    
    Parameters:
    
    delegate - MapViewDelegate
  - onSurfaceCreated
```
public void onSurfaceCreated(GL10 gl,
                             EGLConfig config)
```
  - onSurfaceChanged
```
public void onSurfaceChanged(GL10 gl,
                             int width,
                             int height)
```
  - onDrawFrame
```
public void onDrawFrame(GL10 gl)
```
  - expandMaps
```
public void expandMaps(Map[] maps,
                       Vector3 translation,
                       MappedinCallback<Map> callback)
```
  - contractMaps
```
public void contractMaps(MappedinCallback<Map> callback)
```
  - getCameraHeading
```
public float getCameraHeading()
```
    Returns the current direction the MapView is pointing at, in radians, relative to North.
  - getCameraTilting
```
public float getCameraTilting()
```
    Returns how much the MapView camera is tilted up or down, in radians
  - orbit
```
public void orbit(Focusable orbiting,
                  float heading,
                  float tilt,
                  float over)
```
    Move the camera to fit a focusable object into screen with, rotating to the requested heading and tilt, over a period of time
    Parameters:
    
    orbiting - A Focusable object (such as Polygon or Map) to fit into screen
    
    heading - Camera heading value
    
    tilt - Camera tilt value
    over - Period of time to animate the camera movement, in seconds.
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); mapView.orbit(cylinder, 0f, (float) Math.PI / 5, 1f);
  - orbit
```
public void orbit(Focusable orbiting,
                  float heading,
                  float tilt,
                  float over,
                  float padding)
```
    Move the camera to fit a focusable object into screen with, rotating to the requested heading, tilt and padding, over a period of time
    Parameters:
    
    orbiting - A Focusable object (such as Polygon or Map) to fit into screen
    
    heading - Camera heading value
    
    tilt - Camera tilt value
    
    over - Period of time to animate the camera movement, in seconds.
    padding - padding between the view and the focusable object in meters.
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); mapView.orbit(cylinder, 0f, (float) Math.PI / 5, 1f, 1.5f);
  - zoom
```
public void zoom(int level,
                 float over)
```
    Zooms in/out the camera
    
    Parameters:
    
    level - sets the camera to the specified zoom level. by default, ther are 10 levels 0-9.
    
    over - Period of time to animate the camera movement, in seconds.
  - orbit
```
public void orbit(Focusable[] orbiting,
                  float heading,
                  float tilt,
                  float over)
```
    move camera to fit all focusable objects into screen with request heading and tilt in period of time
    Parameters:
    
    orbiting - Focusable objects (could be Coordinate, Polygon and/or Map) to fit into screen
    
    heading - camera heading value
    
    tilt - camera tilt value
    over - period of time
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); android.location.Location geoLocation = new android.location.Location("mappedin example"); geoLocation.setLatitude(43.825103); geoLocation.setLongitude(-79.539562); Coordinate coordinate = new Coordinate(geoLocation,venue.getMaps()[0]); mapView.orbit(new Focusable[]{cylinder, coordinate}, 0f, (float) Math.PI / 5, 1f);
  - orbit
```
public void orbit(Focusable[] orbiting,
                  float heading,
                  float tilt,
                  float over,
                  float padding)
```
    move camera to fit all focusable objects into screen with request heading, tilt and padding in period of time
    Parameters:
    
    orbiting - Focusable objects (could be Coordinate, Polygon and/or Map) to fit into screen
    
    heading - camera heading value
    
    tilt - camera tilt value
    
    over - period of time
    padding - padding between the view and the focusable object in meters.
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); android.location.Location geoLocation = new android.location.Location("mappedin example"); geoLocation.setLatitude(43.825103); geoLocation.setLongitude(-79.539562); Coordinate coordinate = new Coordinate(geoLocation,venue.getMaps()[0]); mapView.orbit(new Focusable[]{cylinder, coordinate}, 0f, (float) Math.PI / 5, 1f, 1.5f);
  - frame
```
public void frame(Focusable framing,
                  float heading,
                  float tilt,
                  float over)
```
    move camera to fit focusable object into screen with request heading and tilt in period of time
    Parameters:
    
    framing - Focusable object (either Polygon or Map ) to be fit into screen
    
    heading - camera heading value
    
    tilt - camera tilt value
    over - period of time
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); mapView.frame(cylinder, 0f, (float) Math.PI / 5, 1f);
  - frame
```
public void frame(Focusable framing,
                  float heading,
                  float tilt,
                  float over,
                  float padding)
```
    move camera to fit focusable object into screen with request heading, tilt and padding in period of time
    Parameters:
    
    framing - Focusable object (either Polygon or Map ) to be fit into screen
    
    heading - camera heading value
    
    tilt - camera tilt value
    
    over - period of time
    padding - padding between the view and the focusable object in meters.
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); mapView.frame(cylinder, 0f, (float) Math.PI / 5, 1f, 1.5f);
  - frame
```
public void frame(Focusable[] framing,
                  float heading,
                  float tilt,
                  float over)
```
    move camera to fit all focusable objects into screen with request heading and tilt in period of time
    Parameters:
    
    framing - Focusable objects
    
    heading - camera heading value
    
    tilt - camera tilt value
    over - period of time
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); android.location.Location geoLocation = new android.location.Location("mappedin example"); geoLocation.setLatitude(43.825103); geoLocation.setLongitude(-79.539562); Coordinate coordinate = new Coordinate(geoLocation,venue.getMaps()[0]); mapView.frame(new Focusable[]{cylinder, coordinate}, 0f, (float) Math.PI / 5, 1f);
  - frame
```
public void frame(Focusable[] framing,
                  float heading,
                  float tilt,
                  float over,
                  float padding)
```
    move camera to fit all focusable objects into screen with request heading, tilt and padding in period of time
    Parameters:
    
    framing - Focusable objects
    
    heading - camera heading value
    
    tilt - camera tilt value
    
    over - period of time
    padding - padding between the view and the focusable object in meters.
    code snip:
    
    Cylinder cylinder = new Cylinder(1.7f, 3.2f, Color.GRAY); android.location.Location geoLocation = new android.location.Location("mappedin example"); geoLocation.setLatitude(43.825103); geoLocation.setLongitude(-79.539562); Coordinate coordinate = new Coordinate(geoLocation,venue.getMaps()[0]); mapView.frame(new Focusable[]{cylinder, coordinate}, 0f, (float) Math.PI / 5, 1f, 1.5f);
  - setRotateGestureEnabled
```
public void setRotateGestureEnabled(boolean enabled)
```
    Sets whether the user can rotate the map with gestures
    
    Parameters:
    
    enabled - to enable rotate gestures set to true.
  - getRotateGestureEnabled
```
public boolean getRotateGestureEnabled()
```
    Returns whether the user can rotate the map with gestures
  - addElement
```
public void addElement(Element child)
```
    Add one child element into the MapView
    
    Parameters:
    
    child - Element
  - removeElement
```
public void removeElement(Element child)
```
    Remove the specific child element from the MapView
    
    Parameters:
    
    child - Element
  - removeAllElements
```
public void removeAllElements()
```
    Remove all the child elements in this MapView
  - setColor
```
public void setColor(Polygon polygon,
                     int color,
                     float over)
```
    Changes the polygon color, animated over some time. Use this to highlight polygons.
    
    Parameters:
    
    polygon - Polygon
    
    color - android.graphics.Color
    
    over - the animation time in seconds
  - setColor
```
public void setColor(Polygon polygon,
                     int color,
                     int labelColor,
                     float over)
```
    Changes the polygon and text annotation color, animated over some time. Use this to highlight polygons.
    
    Parameters:
    
    polygon - Polygon
    
    color - android.graphics.Color Set polygon to this color
    
    labelColor - android.graphics.Color Set text label to this color if it has a text annotation attach to this polygon
    
    over - the animation time in seconds
  - setHeight
```
public void setHeight(Polygon polygon,
                      float height,
                      float over)
```
    Changes the polygon height over time. Can be useful as part of setColor to highlight a polygon.
    
    Parameters:
    
    polygon - Polygon
    
    height - the rising distance in meters
    
    over - the animation time in seconds
  - resetPolygon
```
public void resetPolygon(Polygon polygon)
```
    Sets the (highlight)polygon back to it's original color and height does nothing if not highlight polygon
    
    Parameters:
    
    polygon - Polygon
  - addAllStoreLabels
```
public void addAllStoreLabels(Venue venue,
                              TextPaint textPaint)
```
    Adds store labels to all of the Polygons in this Venue. The content will be the name of the location attached to that Polygon, if any.
    Parameters:
    
    venue - The target venue
    textPaint - TextPaint set label's size, color and font here (if the content is too big to fit in the polygon it will try shrink it text size to 75%, 50% and 25%)
    code snip:
    
    TextPaint textPaint = new TextPaint(); textPaint.setColor(Color.BLACK); textPaint.setTextSize(20); textPaint.setTypeface(Typeface.SANS_SERIF); mapView.addAllStoreLabels(venue, textPaint);
  - removeAllStoreLabels
```
public void removeAllStoreLabels(Venue venue)
```
    Removes all store labels from all maps in the venue
    
    Parameters:
    
    venue - The target venue

Class MapView

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MapView

Method Detail

onCreateView

onPause

onResume

setBackgroundColor

getBackgroundColor

setMap

setMap

setDelegate

onSurfaceCreated

onSurfaceChanged

onDrawFrame

expandMaps

contractMaps

getCameraHeading

getCameraTilting

orbit

orbit

zoom

orbit

orbit

frame

frame

frame

frame

setRotateGestureEnabled

getRotateGestureEnabled

addElement

removeElement

removeAllElements

setColor

setColor

setHeight

resetPolygon

addAllStoreLabels

removeAllStoreLabels