mirror of
https://github.com/expo/react-native-maps.git
synced 2026-11-15 09:18:08 -10:00
83 lines
4.0 KiB
Markdown
83 lines
4.0 KiB
Markdown
# `<MapView />` Component API
|
|
|
|
## Props
|
|
|
|
| Prop | Type | Default | Note |
|
|
|---|---|---|---|
|
|
| `region` | `Region` | | The region to be displayed by the map. <br/><br/>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.<br/><br/> Changing this prop after the component has mounted will not result in a region change.<br/><br/> This is similar to the `initialValue` prop of a text input.
|
|
| `mapType` | `String` | `"standard"` | The map type to be displayed. <br/><br/> - standard: standard road map (default)<br/> - satellite: satellite view<br/> - 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"
|
|
}
|
|
```
|