MapViewStore | @mappedin/react-native-sdk

Hierarchy

RNMappedinController
- MapViewStore

Properties

Private #customObjectIds

#customObjectIds: Map<string, TMappedinCustomSearchObject> = ...

Private #customObjects

#customObjects: Map<TMappedinCustomSearchObject, string> = ...

Private Optional #iframe

#iframe?: HTMLIFrameElement

Private #markers

#markers: Set<string> = ...

BlueDot

BlueDot: { disable: (() => Promise<undefined>); enable: ((options?: TEnableBlueDotOptionsBase) => Promise<undefined>) } = ...

BlueDot control interface

Type declaration

disable: (() => Promise<undefined>)
- - (): Promise<undefined>
  - Disable BlueDot
    
    Returns Promise<undefined>
enable: ((options?: TEnableBlueDotOptionsBase) => Promise<undefined>)
- - (options?: TEnableBlueDotOptionsBase): Promise<undefined>
  - Enable BlueDot
    
    Parameters
    - Optional options: TEnableBlueDotOptionsBase
    Returns Promise<undefined>

BlueDotState

BlueDotState: E_BLUEDOT_STATE = E_BLUEDOT_STATE.NOT_LISTENING

deprecated: Use BlueDot Events instead

Camera

Camera: { rotation: number; set: ((positionOptions?: TAnimatePositionOptions) => Promise<unknown>); setSafeAreaInsets: ((safeAreaInsets: { bottom: number; left: number; right: number; top: number }) => void); tilt: number; focusOn: any } = ...

Camera controls interface

Type declaration

rotation: number

The current rotation in radians from north.
set: ((positionOptions?: TAnimatePositionOptions) => Promise<unknown>)
- - (positionOptions?: TAnimatePositionOptions): Promise<unknown>
  - Set Camera options immediately
    
    Parameters
    - Optional positionOptions: TAnimatePositionOptions
    Returns Promise<unknown>
setSafeAreaInsets: ((safeAreaInsets: { bottom: number; left: number; right: number; top: number }) => void)
- - (safeAreaInsets: { bottom: number; left: number; right: number; top: number }): void
  - This is so that the map can be positioned on a portion of the screen, (example padding)
    
    Parameters
    - safeAreaInsets: { bottom: number; left: number; right: number; top: number }
      - bottom: number
      - left: number
      - right: number
      - top: number
    Returns void
tilt: number

The current tilt in radians from top-down view.
focusOn:function
- focusOn(focusOptions: TFocusOnOptions & { animationOptions?: TAnimatePositionOptions }): Promise<unknown>
- Parameters
  - focusOptions: TFocusOnOptions & { animationOptions?: TAnimatePositionOptions }
    
    You should provide at least one Node or Polygon, but everything else is optional.
  Returns Promise<unknown>

CameraControls

CameraControls: { rotation: number; setRotation: ((rotation: number) => Promise<undefined>); setTilt: ((tilt: number) => Promise<undefined>); tilt: number } = ...

V3 Camera controls interface

Type declaration

rotation: number

The current rotation in radians from north.

deprecated
Use CameraControls.rotation instead
setRotation: ((rotation: number) => Promise<undefined>)
- - (rotation: number): Promise<undefined>
  - deprecated
    Use CameraControls.setRotation instead
    
    Parameters
    - rotation: number
      
      The new value to set the rotation to, in radians from north..
    Returns Promise<undefined>
setTilt: ((tilt: number) => Promise<undefined>)
- - (tilt: number): Promise<undefined>
  - deprecated
    Use CameraControls.setTilt instead
    
    Parameters
    - tilt: number
      
      The new value to set the tilt to, in radians from top-down view.
    Returns Promise<undefined>
tilt: number

The current tilt in radians from top-down view.

deprecated
Use CameraControls.tilt instead

Journey

Journey: { clear: (() => Promise<undefined>); draw: ((directions: MappedinDirections | MappedinDirections[], options?: TSerializableJourneyOptions) => Promise<undefined>); setStep: ((step: number) => Promise<undefined>) } = ...

Journey management interface

Type declaration

clear: (() => Promise<undefined>)
- - (): Promise<undefined>
  - Remove any paths and markers associated with journey
    
    Returns Promise<undefined>
draw: ((directions: MappedinDirections | MappedinDirections[], options?: TSerializableJourneyOptions) => Promise<undefined>)
- - (directions: MappedinDirections | MappedinDirections[], options?: TSerializableJourneyOptions): Promise<undefined>
  - Visualize directions by drawing paths, and adding connection markers
    
    Parameters
    - directions: MappedinDirections | MappedinDirections[]
    - options: TSerializableJourneyOptions = {}
    Returns Promise<undefined>
setStep: ((step: number) => Promise<undefined>)
- - (step: number): Promise<undefined>
  - Set the current step of a multi-part journey
    
    Parameters
    - step: number
    Returns Promise<undefined>

OfflineSearch

OfflineSearch: { addQuery: ((params: { object: MappedinLocation | MappedinCategory | Record<string, unknown>; query: string; weight?: number }) => Promise<unknown>); search: ((query: string) => Promise<TMappedinOfflineSearchResult[]>); suggest: ((query: string) => Promise<TMappedinOfflineSearchSuggestions>) } = ...

Type declaration

addQuery: ((params: { object: MappedinLocation | MappedinCategory | Record<string, unknown>; query: string; weight?: number }) => Promise<unknown>)
- - (params: { object: MappedinLocation | MappedinCategory | Record<string, unknown>; query: string; weight?: number }): Promise<unknown>
  - Parameters
    - params: { object: MappedinLocation | MappedinCategory | Record<string, unknown>; query: string; weight?: number }
      - object: MappedinLocation | MappedinCategory | Record<string, unknown>
        
        Object that is returned when query matches
      - query: string
        
        Query string to match for this object
      - Optional weight?: number
        
        Optional weight to multiply by the score
    Returns Promise<unknown>
search: ((query: string) => Promise<TMappedinOfflineSearchResult[]>)
- - (query: string): Promise<TMappedinOfflineSearchResult[]>
  - Parameters
    - query: string
      
      String to search for
    Returns Promise<TMappedinOfflineSearchResult[]>
suggest: ((query: string) => Promise<TMappedinOfflineSearchSuggestions>)
- - (query: string): Promise<TMappedinOfflineSearchSuggestions>
  - Parameters
    - query: string
      
      Get a list of suggestions for query
    Returns Promise<TMappedinOfflineSearchSuggestions>

Optional currentMap

currentMap?: MappedinMap

Current map of Venue

Optional options

options?: TGetVenueOptions

privateEventBus

privateEventBus: PubSub<{ ADD_INTERACTIVE_POLYGON: { data: { polygonId: string }; msgID?: string }; ADD_SEARCH_QUERY: { data: { object: { id: string; type: "MappedinLocation" | "MappedinCategory" | "Custom" }; query: string; weight?: number }; msgID?: string }; BLUEDOT_POSITION_UPDATE: { data: { update: Omit<TBlueDotPositionUpdate, "nearestNode" | "map"> & { map?: string; nearestNode?: string } }; msgID?: string }; BLUEDOT_STATE_CHANGE: { data: { stateChange: TBlueDotStateChange }; msgID?: string }; CACHE_IMAGE: { data: { focusOptions?: Omit<TFocusOnOptionsSerializable, "targets">; locationId: string; options: TGetVenueOptions; polygonHighlightColor?: string; url?: string }; msgID?: string }; CAMERA_SET: { data: { positionOptions?: TAnimatePositionOptions }; msgID?: string }; CAMERA_SET_SAFE_AREA_INSETS: { data: { safeAreaInsets: { bottom: number; left: number; right: number; top: number } }; msgID?: string }; CLEAR_ALL_POLYGON_COLORS: { data: null; msgID?: string }; CLEAR_BUNDLE_CACHE: { data: null; msgID?: string }; CLEAR_JOURNEY: { data: null; msgID?: string }; CLEAR_POLYGON_COLOR: { data: { polygonId: string }; msgID?: string }; CREATE_MARKER: { data: { contentHtml: string; nodeOrCoordinate: { id: string; type: "Node" } | { lat: number; lon: number; mapId: string; type: "Coordinate" }; options: any }; msgID?: string }; DATA_LOADED: { data: { venueData: any }; msgID?: string }; DESTROY: { data: null; msgID?: string }; DISABLE_BLUE_DOT: { data: null; msgID?: string }; DRAW_JOURNEY: { data: { directions: IDirectionsResult; options: TSerializableJourneyOptions }; msgID?: string }; DRAW_PATH: { data: { path: string[]; pathOptions: TPathOptions }; msgID?: string }; ENABLE_BEARING: { data: any; msgID?: string }; ENABLE_BLUE_DOT: { data: { options?: TEnableBlueDotOptionsBase }; msgID?: string }; FIRST_MAP_LOADED: { data: { venueData?: any }; msgID?: string }; FOCUS_ON: { data: { focusOptions: TFocusOnOptionsSerializable }; msgID?: string }; FOCUS_ON_LEGACY: { data: { focusOptions: TFocusOnOptionsLegacySerializable }; msgID?: string }; GET_BLUE_DOT_IS_FOLLOWING: { data: any; msgID?: string }; GET_DIRECTIONS: { data: { accessible?: boolean; from: TSerializedNode | TSerializedLocation | TSerializedPolygon; to: TSerializedNode | TSerializedLocation | TSerializedPolygon }; msgID?: string }; GET_IMAGE: { data: { fileName: string }; msgID?: string }; GET_MAP_POLYGONS: { data: { mapId: string }; msgID?: string }; GET_NEAREST_NODE: { data: any; msgID?: string }; GET_NEAREST_NODE_BY_SCREEN_COORDINATES: { data: { map?: string; x: number; y: number }; msgID?: string }; LABEL_ALL_LOCATIONS: { data: { options?: Omit<TReactNativeFlatLabelAllLocations, "locations"> & { flatLabels?: boolean; legacyLabels?: boolean; locations?: string[] } & Omit<TLabelAllLocationFloatingLabelOptions, "locations"> & { flatLabels?: boolean; legacyLabels?: boolean; locations?: string[] } & Omit<TReactNativeFlatLabelAllLocationsLegacy, "locations"> & { flatLabels?: boolean; legacyLabels?: boolean; locations?: string[] } }; msgID?: string }; LABEL_POLYGON: { data: { options: TCommonLabelOptions & { appearance?: TFloatingLabelAppearance; rank?: number; scale?: number } & { legacyLabels?: boolean } & TCommonLabelOptions & { appearance?: TFlatLabelAppearance; flatLabels?: true } & { legacyLabels?: boolean }; polygonId: string }; msgID?: string }; LOAD_MINIMAP: { data: { options: TGetVenueOptions }; msgID?: string }; LOAD_VENUE: { data: { options: TGetVenueOptions & { useBundle?: boolean }; showVenueOptions: TShowVenueOptions & { prepareSearch?: boolean; searchOptions?: Partial<TMappedinOfflineSearchAllOptions> } }; msgID?: string }; LOG: { data: string; msgID?: string }; MAP_CHANGED: { data: { mapId: string }; msgID?: string }; MINIMAP_READY: { data: null; msgID?: string }; NOTHING_CLICKED: { data: null; msgID?: string }; OVERRIDE_LOCATION: { data: { location: TGeolocationObject }; msgID?: string }; POLYGON_CLICKED: { data: { polygonId: string }; msgID?: string }; READY: { data: null; msgID?: string }; REJECT: { data: any; msgID?: string }; REMOVE_ALL_LABELS: { data: null; msgID?: string }; REMOVE_ALL_PATHS: { data: null; msgID?: string }; REMOVE_INTERACTIVE_POLYGONS: { data: null; msgID?: string }; REMOVE_MARKER: { data: { markerId: string }; msgID?: string }; RESOLVE: { data: any; msgID?: string }; ROTATION_CHANGED: { data: { rotation: number }; msgID?: string }; SEARCH: { data: { query: string }; msgID?: string }; SET_BACKGROUND_COLOR: { data: { backgroundColor: string }; msgID?: string }; SET_BLUE_DOT_IS_FOLLOWING: { data: { isFollowing: boolean }; msgID?: string }; SET_COOKIE: { data: { cookie: any }; msgID?: string }; SET_JOURNEY_STEP: { data: { step: number }; msgID?: string }; SET_MAP: { data: { mapId: string }; msgID?: string }; SET_MAX_ZOOM: { data: { zoomLevel: number }; msgID?: string }; SET_MIN_ZOOM: { data: { zoomLevel: number }; msgID?: string }; SET_POLYGON_COLOR: { data: { color: string; opacity?: number; polygonId: string; textColor?: string }; msgID?: string }; SET_ROTATION: { data: { rotation: number }; msgID?: string }; SET_STATE: { data: { state: STATE }; msgID?: string }; SET_TILT: { data: { tilt: number }; msgID?: string }; SET_ZOOM: { data: { zoom: number }; msgID?: string }; SHOW_MINIMAP: { data: { format: "jsonstring"; options: TMiMapViewOptions; venueData: string }; msgID?: string }; SHOW_VENUE: { data: { format: "jsonstring"; showVenueOptions: TShowVenueOptions & { prepareSearch?: boolean; searchOptions?: Partial<TMappedinOfflineSearchAllOptions> }; venueData: string }; msgID?: string }; STATE_CHANGED: { data: { state: STATE }; msgID?: string }; SUGGEST: { data: { query: string }; msgID?: string }; TILT_CHANGED: { data: { tilt: number }; msgID?: string }; UPDATE_GEOLOCATION: { data: { data: unknown; msgID: undefined }; msgID?: string }; ZOOM_CHANGED: { data: { zoom: number }; msgID?: string } }> = ...

state

state: STATE = STATE.EXPLORE

Optional venueData

venueData?: Mappedin

Venue Data

Methods

Private #getCustomSearchObject

#getCustomSearchObject(object: TMappedinCustomSearchObject): undefined | TMappedinCustomSearchObject
#getCustomSearchObject(id: string): undefined | TMappedinCustomSearchObject

Parameters
- object: TMappedinCustomSearchObject
Returns undefined | TMappedinCustomSearchObject
Parameters
- id: string
Returns undefined | TMappedinCustomSearchObject

Private #setCustomSearchObject

#setCustomSearchObject(object: TMappedinCustomSearchObject): string

Parameters
- object: TMappedinCustomSearchObject
Returns string

addInteractivePolygon

addInteractivePolygon(polygonOrPolygonId: string | MappedinPolygon): Promise<unknown>

Make polygons clickable

Parameters
- polygonOrPolygonId: string | MappedinPolygon
Returns Promise<unknown>

clearAllPolygonColors

clearAllPolygonColors(): Promise<unknown>

Clear all polygon colors

Returns Promise<unknown>

clearBundleCache

clearBundleCache(): Promise<void>

Clear any cached venue bundles that were downloaded as part of LOAD_VENUE with useBundle: true This ensure that the next time keys are passed in, we get a fresh bundle

Returns Promise<void>

clearJourney

clearJourney(): Promise<unknown>

Remove any paths and markers associated with journey

deprecated
Use mapView.Journey.clear instead

Returns Promise<unknown>

clearPolygonColor

clearPolygonColor(polygonOrPolygonId: string | MappedinPolygon): Promise<unknown>

Clear Polygon Color

Parameters
- polygonOrPolygonId: string | MappedinPolygon
Returns Promise<unknown>

createMarker

createMarker(nodeOrCoordinate: MappedinNode | MappedinCoordinate, contentHtml: string, options: TCreateMarkerOptions): string

Create a marker attached to a MappedinNode, with any abitrary HTML code inside.

Parameters
- nodeOrCoordinate: MappedinNode | MappedinCoordinate
- contentHtml: string
- options: TCreateMarkerOptions
Returns string
markerId This marker id can later be used to remove the marker

drawJourney

drawJourney(directions: MappedinDirections | MappedinDirections[], options?: TSerializableJourneyOptions): Promise<unknown>

Visualize directions by drawing paths, and adding connection markers

deprecated
Use MapViewStore.Journey's draw method instead

Parameters
- directions: MappedinDirections | MappedinDirections[]
- options: TSerializableJourneyOptions = {}
Returns Promise<unknown>

drawPath

drawPath(pathNodesOrNodeIds: (string | MappedinNode)[], pathOptions: TPathOptions): Promise<unknown>

Draw a path based on a list of Nodes

Parameters
- pathNodesOrNodeIds: (string | MappedinNode)[]
- pathOptions: TPathOptions
Returns Promise<unknown>

focusOn

focusOn(focusOptions: TFocusOptionsLegacy): Promise<unknown>

deprecated
Use Camera.focusOn instead

Parameters
- focusOptions: TFocusOptionsLegacy
  
  You should provide at least one Node or Polygon, but everything else is optional.
Returns Promise<unknown>

getDirections

getDirections(props: { accessible?: boolean; from: MappedinPolygon | MappedinLocation | MappedinNode; to: MappedinPolygon | MappedinLocation | MappedinNode | MappedinDestinationSet }): Promise<MappedinDirections | MappedinDirections[]>

Get Directions

Parameters
- props: { accessible?: boolean; from: MappedinPolygon | MappedinLocation | MappedinNode; to: MappedinPolygon | MappedinLocation | MappedinNode | MappedinDestinationSet }
  - Optional accessible?: boolean
  - from: MappedinPolygon | MappedinLocation | MappedinNode
  - to: MappedinPolygon | MappedinLocation | MappedinNode | MappedinDestinationSet
Returns Promise<MappedinDirections | MappedinDirections[]>

getNearestNodeByScreenCoordinates

getNearestNodeByScreenCoordinates(x: number, y: number, mapIdOrMap?: string | MappedinMap): Promise<undefined | null | MappedinNode>

Gets the nearest node by screen coordinate

Parameters
- x: number
- y: number
- Optional mapIdOrMap: string | MappedinMap
Returns Promise<undefined | null | MappedinNode>

labelAllLocations

labelAllLocations(options?: TLabelAllLocationFloatingLabelOptions): Promise<unknown>
labelAllLocations(options?: TReactNativeFlatLabelAllLocations | TReactNativeFlatLabelAllLocationsLegacy): Promise<unknown>

Label all polygons with locations either loaded via the API or passed in

Parameters
- Optional options: TLabelAllLocationFloatingLabelOptions
Returns Promise<unknown>
Label all polygons with locations either loaded via the API or passed in

Parameters
- Optional options: TReactNativeFlatLabelAllLocations | TReactNativeFlatLabelAllLocationsLegacy
Returns Promise<unknown>

labelPolygon

labelPolygon(polygonOrPolygonId: string | MappedinPolygon, options: TReactNativeFloatingLabelPolygonOptions): Promise<unknown>
labelPolygon(polygonOrPolygonId: string | MappedinPolygon, options: TReactNativeFlatLabelPolygonOptions): Promise<unknown>

Parameters
- polygonOrPolygonId: string | MappedinPolygon
- options: TReactNativeFloatingLabelPolygonOptions
Returns Promise<unknown>
Parameters
- polygonOrPolygonId: string | MappedinPolygon
- options: TReactNativeFlatLabelPolygonOptions
Returns Promise<unknown>

removeAllInteractivePolygons

removeAllInteractivePolygons(): Promise<unknown>

Remove all interactive polygons

Returns Promise<unknown>

removeAllPaths

removeAllPaths(): Promise<unknown>

Remove all paths

Returns Promise<unknown>

removeMarker

removeMarker(markerId: string): Promise<void>

Remove marker by id

Parameters
- markerId: string
Returns Promise<void>

setMap

setMap(mapIdOrMap: string | MappedinMap): Promise<unknown>

Change Map/Level

Parameters
- mapIdOrMap: string | MappedinMap
Returns Promise<unknown>

setPolygonColor

setPolygonColor(polygonIdOrPolygon: string | MappedinPolygon, color: string, opacity?: number, textColor?: string): Promise<unknown>

Set Polygon Color

Parameters
- polygonIdOrPolygon: string | MappedinPolygon
- color: string
- opacity: number = 1
- Optional textColor: string
Returns Promise<unknown>

setSafeArea

setSafeArea(padding: { bottom: number; left: number; right: number; top: number }): void

Padding - this is so that the map can be positioned on a portion of the screen

deprecated
Use Camera.setSafeAreaInsets instead

Parameters
- padding: { bottom: number; left: number; right: number; top: number }
  - bottom: number
  - left: number
  - right: number
  - top: number
Returns void

setState

setState(state: STATE): Promise<undefined>

Set SDK state, which controls camera and other features geared towards a particular experience

EXPLORE (default)

FOLLOW - Lock Camera to the BlueDot so it follows it around the screen

Parameters
- state: STATE
Returns Promise<undefined>

Hierarchy

Index

Properties

Methods

Properties

Private #customObjectIds

Private #customObjects

Private Optional #iframe

Private #markers

BlueDot

Type declaration

disable: (() => Promise<undefined>)

Returns Promise<undefined>

enable: ((options?: TEnableBlueDotOptionsBase) => Promise<undefined>)

Parameters

Optional options: TEnableBlueDotOptionsBase

Returns Promise<undefined>

BlueDotState

Camera

Type declaration

rotation: number

set: ((positionOptions?: TAnimatePositionOptions) => Promise<unknown>)

Parameters

Optional positionOptions: TAnimatePositionOptions

Returns Promise<unknown>

setSafeAreaInsets: ((safeAreaInsets: { bottom: number; left: number; right: number; top: number }) => void)

Parameters

safeAreaInsets: { bottom: number; left: number; right: number; top: number }

bottom: number

left: number

right: number

top: number

Returns void

tilt: number

focusOn:function

Parameters

focusOptions: TFocusOnOptions & { animationOptions?: TAnimatePositionOptions }

Returns Promise<unknown>

CameraControls

Type declaration

rotation: number

setRotation: ((rotation: number) => Promise<undefined>)

Parameters

rotation: number

Returns Promise<undefined>

setTilt: ((tilt: number) => Promise<undefined>)

Parameters

tilt: number

Returns Promise<undefined>

tilt: number

Journey

Type declaration

clear: (() => Promise<undefined>)

Returns Promise<undefined>

draw: ((directions: MappedinDirections | MappedinDirections[], options?: TSerializableJourneyOptions) => Promise<undefined>)

Parameters

directions: MappedinDirections | MappedinDirections[]

options: TSerializableJourneyOptions = {}

Returns Promise<undefined>

setStep: ((step: number) => Promise<undefined>)

Parameters

step: number

Returns Promise<undefined>

OfflineSearch

Type declaration

addQuery: ((params: { object: MappedinLocation | MappedinCategory | Record<string, unknown>; query: string; weight?: number }) => Promise<unknown>)

Parameters

params: { object: MappedinLocation | MappedinCategory | Record<string, unknown>; query: string; weight?: number }

object: MappedinLocation | MappedinCategory | Record<string, unknown>

query: string

Optional weight?: number

Returns Promise<unknown>

search: ((query: string) => Promise<TMappedinOfflineSearchResult[]>)

Parameters

query: string

Returns Promise<TMappedinOfflineSearchResult[]>

suggest: ((query: string) => Promise<TMappedinOfflineSearchSuggestions>)

Parameters

query: string

Returns Promise<TMappedinOfflineSearchSuggestions>