May 24, 2023

Indoor JS API v1.4

Indoor JS API Reference v1.4

1. IndoorRenderer class
2. IndoorService class
3. IndoorWidget class
4. Building Interface
5. Feature Interface
6. FeatureCollection Interface
7. IndoorDirectionLeg Interface
8. IndoorDirectionRequest Interface
9. IndoorDirectionResult Interface
10. IndoorDirectionRoute Interface
11. IndoorDirectionsBounds Interface
12. IndoorDistance Interface
13. IndoorDuration Interface
14. IndoorGeometryType Interface
15. IndoorInstruction Interface
16. IndoorPosition Interface
17. IndoorRendererOptions Interface
18. IndoorRendererOptionsIcon Interface
19. IndoorStep Interface
20. IndoorWidgetOptions Interface
21. IndoorWidgetOptionsui Interface
22. LatLngLevel Interface
23. Level Interface
24. PolylineCoords Interface
25. Prediction Interface
26. Predictions Interface
27. Venue Interface
28. VenuesResult Interface

IndoorRenderer class

woosmap.map.IndoorRenderer

This class extends MVCObject.

Constructor
IndoorRenderer	IndoorRenderer(options?) Parameters: options: IndoorRendererOptions IndoorRendererOptions Creates an Indoor renderer.

Methods
setMap	setMap(map?) Parameters: map: (woosmap.map.Map | null) Sets the map where to render the Indoor map.
getDirectionsRenderer	getDirectionsRenderer() Parameters: None Return Type: IndoorDirectionsRenderer Gets the directions renderer.
getLevel	getLevel() Parameters: None Return Type: number Get the displayed level.
getSelectedFeature	getSelectedFeature() Parameters: None Return Type: (Feature | null) Get the selected feature.
getVenue	getVenue() Parameters: None Return Type: (Venue | null) Get the displayed venue.
getView	getView() Parameters: None Return Type: "mobile" | "desktop" | "auto" Gets view set for the renderer
setDirections	setDirections(directions?, padding?) Parameters: directions: (IndoorDirectionResult | null) result from the indoor directions API padding: (number | null) padding to apply Call this function to draw a polyline on map.
highlightStep	highlightStep(stepToHighlight?, fitBounds, tilt) Parameters: stepToHighlight: (Feature | null) fitBounds: boolean tilt: boolean Highlight the step of the directions
unselectFeature	unselectFeature() Parameters: None Unselect a selected feature
setUserLocation	setUserLocation(lat, lng, level, bearing, forceFocus, adjusted) Parameters: lat: number Latitude lng: number Longitude level: number user level bearing: number user location bearing/heading forceFocus: boolean center on user location adjusted: boolean Set the current user location. A blue dot is going to be displayed.
getUserLocation	getUserLocation() Parameters: None Return Type: IndoorPosition Returns the current user location.
isUserInsideVenue	isUserInsideVenue(lat, lng) Parameters: lat: number lng: number Return Type: boolean Detects whether user location is found inside venue’s bounding box
setFloor	setFloor(floor) Parameters: floor: number The floor value to set Sets the floor for the venue
setVenue	setVenue(venueId) Parameters: venueId: string The unique id of the venue Renders map with the selected venue
highlightFeature	highlightFeature(featureid, silent) Parameters: featureid: string The unique id of the feature to highlight silent: boolean will prevent the indoor_feature_selected event to trigger Renders a map with a POI highlighted by pk or id
highlightFeatureByRef	highlightFeatureByRef(ref) Parameters: ref: string The unique reference of the poi to highlight Renders a map with a POI highlighted by ref
setTheme	setTheme(theme) Parameters: theme: string Theme name Renders map with custom theme

Events
indoor_venue_loaded	This event is fired when the indoor venue is loaded
indoor_level_changed	This event is fired when the indoor level is changed
indoor_user_location	This event is fired when the indoor user location is changed
indoor_feature_selected	This event is fired when any indoor feature on the map is clicked

IndoorService class

woosmap.map.IndoorService

Service used to call the Indoor API.

Constructor
IndoorService	IndoorService() Parameters: None Service used to call the Indoor API.

Methods
venues	venues(callback) Parameters: callback: (venues: VenuesResult) => void Retrieve all the venues
venue	venue(venueId, callback) Parameters: venueId: string callback: (venue: Venue) => void Retrieve detailed venue data
search	search(venueId, query, ref?, id?, callback) Parameters: venueId: string query: string ref: (string | null) id: (string | null) callback: (featureCollection: FeatureCollection) => any Search for features by their names
directions	directions(request, callback) Parameters: request: IndoorDirectionRequest callback: ((IndoorDirectionResult | null)) => void Gets indoor directions
feature	feature(venueId, featureId, callback) Parameters: venueId: string featureId: number callback: (feature: Feature) => void Gets feature by feature id
autocomplete	autocomplete(venueId, query, ref?, id?, callback, fromLocation?) Parameters: venueId: string query: string ref: (string | null) id: (string | null) callback: (predictions: Predictions) => any fromLocation: (string | null) Autocomplete for pois

IndoorWidget class

woosmap.map.IndoorWidget

Constructor
IndoorWidget	IndoorWidget(widgetOptions?, rendererOptions?) Parameters: widgetOptions: IndoorWidgetOptions IndoorWidgetOptions rendererOptions: IndoorRendererOptions IndoorRendererOptions Creates a new Indoor widget.

Methods
setMap	setMap(map) Parameters: map: Map Sets the map where to render the Indoor.
setVenue	setVenue(venueId) Parameters: venueId: string Renders map with the selected venue
highlightFeature	highlightFeature(id, silent) Parameters: id: string silent: boolean Renders a map with a POI highlighted by pk / id silent parameter will prevent the indoor_feature_selected event to trigger
highlightFeatureByRef	highlightFeatureByRef(ref) Parameters: ref: string Renders a map with a POI highlighted by its ref
unselectFeature	unselectFeature() Parameters: None Unselect a selected feature: it closes the widget and unhighlight the feature.
setDirections	setDirections(directions?) Parameters: directions: (IndoorDirectionResult | null) Call this function to draw a polyline on map.
setUnits	setUnits(units) Parameters: units: "imperial" | "metric" Sets the distance units.
getUnits	getUnits() Parameters: None Return Type: "imperial" | "metric" Gets the distance units.
setDirectionsMode	setDirectionsMode(profile) Parameters: profile: string Sets the routing profile (or directions mode) (‘security’ | ‘wheelchair’) for way finding
getDirectionsMode	getDirectionsMode() Parameters: None Return Type: (string | null) Gets the distance units.
setUserLocation	setUserLocation(lat, lng, level, bearing?, forceFocus) Parameters: lat: number lng: number level: number bearing: number forceFocus: boolean Sets the current user location.
setNavigationMode	setNavigationMode(allowNavigation) Parameters: allowNavigation: boolean Sets the navigation mode
getNavigationMode	getNavigationMode() Parameters: None Return Type: boolean Gets the navigates mode
getAutocompleteWithDistance	getAutocompleteWithDistance() Parameters: None Return Type: boolean Gets the autocompleteWithDistance option
setTheme	setTheme(theme) Parameters: theme: string Theme name Renders map with custom theme
setZonesToAvoid	setZonesToAvoid(avoidZones) Parameters: avoidZones: string Return Type: (string | null) Sets the zones to avoid during routing. Argument expected in the format level;lat,lng;lat,lng;lat,lng…|level;lat,lng;lat,lng;lat,lng…
getZonesToAvoid	getZonesToAvoid() Parameters: None Return Type: (string | null) Gets the zones to avoid while routing
setFloor	setFloor(floor) Parameters: floor: number Sets the floor for the venue
addListener	addListener(eventName, handler) Parameters: eventName: string handler: any Return Type: MapEventListener Adds a listener for eventName.

Building Interface

Building of a venue.

Properties
cover?	Type: (string | null)
description?	Type: (string | null)
levels	Type: Level[]
localized_name?	Type: ({} | null)
logo?	Type: (string | null)
name?	Type: (string | null)
opening_hours?	Type: (string | null)
ref?	Type: (string | null)

Feature Interface

Feature

Properties
geometry	Type: {coordinates: any, type: IndoorGeometryType}
id?	Type: (number | null)
properties	Type: {}

FeatureCollection Interface

Collection of features

Properties
features	Type: Feature[]
type	Type: "FeatureCollection"

IndoorDirectionLeg Interface

Indoor directions leg.

Properties
distance	Type: IndoorDistance
duration	Type: IndoorDuration
end_location	Type: LatLngLevel
start_location	Type: LatLngLevel
steps	Type: IndoorStep[]

IndoorDirectionRequest Interface

Request to get directions between an origin and a destination.

Properties
avoid?	Type: (string | null)
destination?	Type: (LatLng | null)
destinationId?	Type: (number | null)
destinationLevel?	Type: (number | null)
language?	Type: (string | null)
mode?	Type: (string | null)
origin?	Type: (LatLng | null)
originId?	Type: (number | null)
originLevel?	Type: (number | null)
units	Type: "metric" | "imperial"
venueId	Type: string

IndoorDirectionResult Interface

Indoor directions result.

Properties
routes	Type: IndoorDirectionRoute[]

IndoorDirectionRoute Interface

Indoor directions route.

Properties
bounds	Type: IndoorDirectionsBounds
legs	Type: IndoorDirectionLeg[]

IndoorDirectionsBounds Interface

Type: number[]

Indoor directions bounds.

IndoorDistance Interface

Indoor distance object.

Properties
text	Type: string
value	Type: number

IndoorDuration Interface

Indoor duration object.

Properties
text	Type: string
value	Type: number

IndoorGeometryType Interface

Type: "Point" | "LineString" | "Polygon"

Type of Indoor geometry

IndoorInstruction Interface

Indoor instrction object.

Properties
instruction_type	Type: string
summary	Type: string

IndoorPosition Interface

Position indoor.

Properties
adjusted?	Type: (boolean | null)
bearing?	Type: (number | null)
forceFocus?	Type: (boolean | null)
level	Type: number
position	Type: LatLngLiteral

IndoorRendererOptions Interface

Options to configure the Indoor Renderer.

Properties
centerMap?	Type: boolean Center the map on the venue when initializing.
defaultFloor?	Type: number Set default floor for the venue
forceExtrusion?	Type: boolean Force the extrusion to be always visible.
hideLevelSelector?	Type: boolean Hide the level selector
highlightPOI?	Type: string Renders map with a POI selected by pk or id
highlightPOIByRef?	Type: string Renders map with a POI selected by ref
icon?	Type: IndoorRendererOptionsIcon Sets custom icon for venue markers
responsive?	Type: "mobile" | "desktop" | "auto" Enforces the view of the renderer. Possible values could be ‘auto’ ‘mobile’ ‘desktop’
theme?	Type: string Renders map with the custom theme provided.
useInfoWindow?	Type: boolean Display an infowindow to highlight a selected POI
venue?	Type: string Set default venue

IndoorRendererOptionsIcon Interface

Icons to use to display venues on the map.

Properties
anchor	Type: {x: number, y: number}
scaledSize	Type: {height: number, width: number}
url	Type: string

IndoorStep Interface

Indoor directions step.

Properties
bearing_end	Type: number
bearing_start	Type: number
distance	Type: IndoorDistance
duration	Type: IndoorDuration
end_location	Type: LatLngLevel
instruction?	Type: (IndoorInstruction | null)
polyline	Type: PolylineCoords
start_location	Type: LatLngLevel

IndoorWidgetOptions Interface

Options of the Indoor widget.

Properties
autocompleteWithDistance?	Type: boolean Set directions mode/routing profile
avoidZones?	Type: string Areas to avoid while routing. Useful when certain areas of the venues are restricted or under maintenance. Expected format evel;lat,lng;lat,lng;lat,lng… level;lat,lng;lat,lng;lat,lng…
directionsMode?	Type: string Set directions mode/routing profile
navigationMode?	Type: boolean Sets whether to enable/disable navigation mode.
ui?	Type: IndoorWidgetOptionsui Set the custom colors of the indoor widget
units?	Type: "imperial" | "metric" | "" Set units to use to show distance in directions itinerary

IndoorWidgetOptionsui Interface

UI Option of the Indoor widget.

Properties
primaryColor	Type: string
secondaryColor	Type: string

LatLngLevel Interface

Indoor location composed of a latitude, a longitude and a level.

Properties
lat	Type: number
level	Type: number
lng	Type: number

Level Interface

Level of a Venue

Properties
bbox	Type: number[]
level	Type: number
name?	Type: (string | null)

PolylineCoords Interface

Type: Array<[number, number]>

Array of lat, lon coordinates.

Prediction Interface

Autocomplete predictions

Properties
building?	Type: (string | null)
distance?	Type: (number | null)
id	Type: number
level	Type: number
name	Type: string
ref?	Type: (string | null)

Predictions Interface

Collection of poi predictions

Properties
predictions	Type: Prediction[]
type	Type: "Array"

Venue Interface

Venue

Properties
bbox	Type: number[]
buildings?	Type: (Building[] | null)
categories?	Type: (string[] | null)
levels	Type: Level[]
name?	Type: (string | null)
routing_profiles?	Type: (string[] | null)
venue_id	Type: string

VenuesResult Interface

List of venues.

Properties
venues	Type: Venue[]

‹ Indoor Map Js Widget Get Started ›

Was this article helpful?

Have more questions? Submit a request