mapview.md

<MapView /> Component API

Props

Prop	Type	Default	Note
region	Region		The region to be displayed by the map. The region is defined by the center coordinates and the span of coordinates to display.
initialRegion	Region		The initial region to be displayed by the map. Use this prop instead of region only if you don't want to control the viewport of the map besides the initial region. Changing this prop after the component has mounted will not result in a region change. This is similar to the initialValue prop of a text input.
mapType	String	"standard"	The map type to be displayed. - standard: standard road map (default) - satellite: satellite view - hybrid: satellite view with roads and points of interest overlayed
showsUserLocation	Boolean	false	If true the app will ask for the user's location and focus on it. NOTE: You need to add NSLocationWhenInUseUsageDescription key in Info.plist to enable geolocation, otherwise it is going to fail silently!
showsPointsOfInterest	Boolean	true	If false points of interest won't be displayed on the map.
showsCompass	Boolean	true	If false compass won't be displayed on the map.
showsScale	Boolean	true	A Boolean indicating whether the map shows scale information.
showsBuildings	Boolean	true	A Boolean indicating whether the map displays extruded building information.
showsTraffic	Boolean	true	A Boolean value indicating whether the map displays traffic information.
showsIndoors	Boolean	true	A Boolean indicating whether indoor maps should be enabled.
zoomEnabled	Boolean	true	If false the user won't be able to pinch/zoom the map.
rotateEnabled	Boolean	true	If false the user won't be able to pinch/rotate the map.
scrollEnabled	Boolean	true	If false the user won't be able to change the map region being displayed.

Events

Event Name	Returns	Notes
onRegionChange	Region	Fired when the map ends panning or zooming.
onRegionChangeComplete	Region	Fired when the map ends panning or zooming.
onPress	{ coordinate: LatLng, position: Point }	Callback that is called when user taps on the map.
onLongPress	{ coordinate: LatLng, position: Point }	Callback that is called when user makes a "long press" somewhere on the map.
onMarkerPress		Callback that is called when a marker on the map is tapped by the user.
onMarkerSelect		Callback that is called when a marker on the map becomes selected. This will be called when the callout for that marker is about to be shown.
onMarkerDeselect		Callback that is called when a marker on the map becomes deselected. This will be called when the callout for that marker is about to be hidden.
onCalloutPress		Callback that is called when a callout is tapped by the user.
onMarkerDragStart	{ coordinate: LatLng, position: Point }	Callback that is called when the user initiates a drag on a marker (if it is draggable)
onMarkerDrag	{ coordinate: LatLng, position: Point }	Callback called continuously as a marker is dragged
onMarkerDragEnd	{ coordinate: LatLng, position: Point }	Callback that is called when a drag on a marker finishes. This is usually the point you will want to setState on the marker's coordinate again

Methods

Method Name	Arguments	Notes
animateToRegion	region: Region, duration: Number
animateToCoordinate	region: Coordinate, duration: Number
fitToElements	animated: Boolean

Types

type Region {
  latitude: Number,
  longitude: Number,
  latitudeDelta: Number,
  longitudeDelta: Number,
}

type LatLng {
  latitude: Number,
  longitude: Number,
}

type Point {
  x: Number,
  y: Number,
}

enum MapType : String {
  "standard",
  "satellite",
  "hybrid"
}