Skip to main content

Interface: RNGoogleMapsPlusViewProps

Native Google Maps view props. Direct mapping to Google Maps SDK for Android/iOS. Platform differences remain unless explicitly aligned.

Extends​

  • HybridViewProps

Properties​

PropertyTypeDefault valueDescription
buildingEnabled?booleanfalseEnables 3D buildings.
circles?RNCircle[]Circles. See RNCircle.
customMapStyle?stringJSON map style string. Must be a Google Maps StyleSpec JSON. Remarks Ignored while RNMapOptions.mapId is set. On Android, the legacy Google Maps renderer applies it anyway. Devices or emulators with missing or outdated Google Play services may fall back to the legacy renderer.
heatmaps?RNHeatmap[]Heatmaps. See RNHeatmap.
indoorEnabled?booleanfalseEnables indoor maps.
kmlLayers?RNKmlLayer[]KML layers. See RNKmlLayer.
locationConfig?RNLocationConfigLocation subsystem config. See RNLocationConfig.
mapOptions?RNMapOptionsInitial map configuration. Applied once at mount time. See RNMapOptions.
mapPadding?RNMapPaddingMap padding. See RNMapPadding.
mapType?RNMapType'normal' See RNMapType.Base map type.
mapZoomConfig?RNMapZoomConfigZoom range. See RNMapZoomConfig.
markers?RNMarker[]Markers. See RNMarker.
myLocationEnabled?booleanfalseEnables "My Location" blue dot and location updates.
onCameraChange?(region, camera, isGesture) => voidCamera moving.
onCameraChangeComplete?(region, camera, isGesture) => voidCamera idle.
onCameraChangeStart?(region, camera, isGesture) => voidCamera move started.
onCirclePress?(id) => voidTap on circle.
onHeadingUpdate?(heading) => voidCompass heading update. Requires heading updates, see RNHeadingConfig.
onIndoorBuildingFocused?(building) => voidIndoor building focused.
onIndoorLevelActivated?(level) => voidIndoor level activated.
onInfoWindowClose?(id) => voidInfo window closed.
onInfoWindowLongPress?(id) => voidInfo window long-press.
onInfoWindowPress?(id) => voidInfo window tap.
onLocationError?(error) => voidLocation subsystem error. Reports an error once while it persists. Requires location updates, see RNLocationConfig.
onLocationStatusChange?(status) => voidLocation permission or device location settings changed. Reports the status when location updates start, then every change while the view is active. Changes made in background are reported on return. Without location permission the device location switch is only reported when location updates start. The same status can be reported more than once. Requires location updates, see RNLocationConfig.
onLocationUpdate?(location) => voidLocation update. Requires location updates, see RNLocationConfig.
onMapCapabilitiesChange?(capabilities) => voidMap capabilities changed after the map was ready.
onMapError?(error, msg) => voidMap errors.
onMapLoaded?(region, camera) => voidFirst frame rendered.
onMapLongPress?(coordinate) => voidLong-press on map.
onMapPress?(coordinate) => voidTap on map.
onMapReady?(ready, capabilities) => voidNative map instance created. Android: false if the Maps SDK could not be initialized, e.g. Play Services missing or outdated. Fires again with true once the user has resolved it.
onMarkerDrag?(id, location) => voidMarker drag update.
onMarkerDragEnd?(id, location) => voidMarker drag end.
onMarkerDragStart?(id, location) => voidMarker drag start.
onMarkerPress?(id) => voidTap on marker.
onMyLocationButtonPress?() => voidTap on the My-Location button.
onMyLocationPress?(location) => voidTap on the blue My-Location indicator.
onPoiPress?(placeId, name, coordinate) => voidTap on POI.
onPolygonPress?(id) => voidTap on polygon.
onPolylinePress?(id) => voidTap on polyline.
polygons?RNPolygon[]Polygons. See RNPolygon.
polylines?RNPolyline[]Polylines. See RNPolyline.
trafficEnabled?booleanfalseEnables traffic layer.
transitEnabled?booleanfalseEnables transit layer.
uiSettings?RNMapUiSettingsUI and gesture settings. See RNMapUiSettings.
urlTileOverlays?RNUrlTileOverlay[]URL tile overlays. See RNUrlTileOverlay.
userInterfaceStyle?RNUserInterfaceStyleOverrides OS UI mode. See RNUserInterfaceStyle. Remarks On Android, dark mode requires the latest Google Maps renderer and is not supported in liteMode. Devices or emulators with missing or outdated Google Play services may fall back to the legacy renderer.