Henry Short

Henry Short


React Native Proximi.io Mapbox Library


Welcome to the Proximi.io React Native Mapbox Library, this library provides indoor positioning support for both IOS and Android Mapbox implementations.


Current public version is: 5.0.14


Installation is managed by npm, the library provides autolinking methods to simplify the platform integration.

Run the following inside the project folder to install the library:

npm install https://github.com/proximiio/react-native-proximiio-mapbox

After the installation is finished, enter the ios directory and run pod install

cd ios
pod install

For android make sure to set minSdk to 24 in build.gradle



The library needs to be authenticated at first, in your application you should call the authorize method, once per app start, ideally in componentDidMount method or inside useEffect(() => {}, []) if you prefer functional components. After authorization is successfuly finished, you can subscribe to various events or fetch data from Proximi.io Mapbox SDK.

This repository contains also an example application showcasing the implementation in simple form.

Quick Sample usage

import * as React from 'react';
import MapboxGL from "@react-native-mapbox-gl/maps";

import Proximiio, {
  ProximiioContextProvider, ProximiioEvents, ProximiioLocation
} from 'react-native-proximiio';

import ProximiioMapbox, { UserLocationSource, AmenitySource, GeoJSONSource, RoutingSource } from '../../src/index';
import { Text, Button, View } from 'react-native';



interface Props {


interface State {
  coordinates: number[],
  mapLoaded: boolean,
  mapLevel: number,
  proximiioReady: boolean

export default class App extends React.Component<Props, State> {
  _map : MapboxGL.MapView | null = null
  _camera: MapboxGL.Camera | null = null

  state = {
    coordinates: [ 25.22717761, 55.32300908 ],
    mapLoaded: false,
    mapLevel: 0,
    proximiioReady: false

  componentDidMount() {

  async initProximiio() {
    await Proximiio.authorize(TOKEN)
    await ProximiioMapbox.authorize(TOKEN)
    await Proximiio.requestPermissions()

    Proximiio.subscribe(ProximiioEvents.PositionUpdated, (location: ProximiioLocation) => {
        centerCoordinate: [location.lng, location.lat],
        animationDuration: 2000,

    await this.setState({
      proximiioReady: true

  render() {
    if (!this.state.proximiioReady ) {
      return <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>

    return (<React.Fragment>
        ref={map => (this._map = map)}
        style={{ flex: 1 }}
        onDidFinishLoadingMap={() => this.setState({ mapLoaded: true })}>
          ref={camera => {this._camera = camera}}
        { this.state.mapLoaded && <ProximiioContextProvider>
          <AmenitySource />
          <GeoJSONSource level={this.state.mapLevel} />
          <RoutingSource level={this.state.mapLevel} />
          <UserLocationSource level={this.state.mapLevel} />
        </ProximiioContextProvider> }
      <View style={styles.buttons}>
        <Button title="UP" onPress={() => this.setState({ mapLevel: this.state.mapLevel + 1 }) }/>
        <Button title="DOWN" onPress={() => this.setState({ mapLevel: this.state.mapLevel -1 }) }/>
        <Button title="CANCEL ROUTE" onPress={() => {
        } }/>

const styles = StyleSheet.create({
  buttons: {
    position: 'absolute', 
    zIndex: 100, 
    right: 20, 
    top: 100, 
    width: 150, 
    height: 140, 
    backgroundColor: 'white'

Available MapBox Sources


this compoment provides Proximi.io amenities support (icons), its required to include this source to automatically manage images for POIs and other GeoJSON points


provides Proximi.io GeoJSON data and styling

GeoJSONSourceProps {
  level: number // filters features for level that is shown on map
  selection?: string[] // filters selected POI ids, undefined = no filtering, empty array = no pois shown
  onPress?: (features: Feature[]) => void; // tap action trigger for geojson data, see note

note: onPress action features attribute contains all features at the coordinates where the tap action occured, those should be further filtered based on your usecase, eg. const points = features.filter((f) => f.isPoint);


provides Proximi.io Routing data & styling

RoutingSourceProps {
  level: number // filters features for level that is shown on map
  showSymbols?: boolean // enables start & target symbols visibility on top of routing line
  startImage?: string // custom image - see note below
  targetImage?: string // custom image - see note below
  directionImage?: string // custom image repeated on top of routing line- see note below
  symbolLayerStyle?: SymbolLayerStyle (https://github.com/react-native-mapbox-gl/maps/blob/master/docs/SymbolLayer.md)
  lineSymbolLayerStyle?: SymbolLayerStyle (https://github.com/react-native-mapbox-gl/maps/blob/master/docs/SymbolLayer.md)

note: Image should be represented by amenity id or the reference name of the image loaded via MapboxGL.Images (https://github.com/react-native-mapbox-gl/maps/blob/master/docs/Images.md)

example with require images from project folder:

const images = {
  routeStart: require('./assets/icons8-marker-a-50.png'),
  routeTarget: require('./assets/icons8-marker-b-50.png'),
  routeDirection: require('./assets/direction.png')

// routeStart, routeTarget, routeDirection are the reference image names in this case

...inside <MapboxGL.Camera> object...
<MapboxGL.Images images={images}/>


provides user location point and accuracy circle

UserLocationSourceProps {
  level: number // filters features for level that is shown on map
  markerStyle?: StyleProp<SymbolLayerStyle>
  accuracyStyle?: StyleProp<FillLayerStyle>


provides Proximi.io raster floormaps

RasterSourceProps {
  level: number // filters features for level that is shown on map

Methods & Properties

ProximiioMapbox.authorize(token: string): void

authorizes Proximi.io Mapbox SDK, also enables styleURL property

ProximiioMapbox.styleURL: string

provides authorized url for Proximi.io Mapbox Style

ProximiioMapbox.isReady: boolean

returns loaded state of the Proximi.io Mapbox library

ProximiioMapbox.getAmenities(): Promise<ProximiioAmenity[]>

returns all available amenity objects

ProximiioMapbox.getFeatures(): Promise<ProximiioFeature[]>

returns all available feature objects


Our RoutingSource minimizes the effort to implement the routing in your application. Depending on your usecase, you can call one of the route.find methods and after the user is finished with the navigation, call the routeCancel method. The methods also provide preview option, if set to true, the route will be displayed for preview but actual routing will not start.


Use this method to route to specific POI, when its id is known (eg. user taps one of the POIs)

ProximiioMapbox.route.find(poi_id: string, previewRoute: boolean): void


Use this method to route to custom coordinate specified by latitude, longitude and level

  latitude: number,
  longitude: number,
  level: number,
  preview: boolean,
): void


Provides route between two custom coordinates, both specified by latitude, longitude and level

  latitudeFrom: number,
  longitudeFrom: number,
  levelFrom: number,
  latitudeTo: number,
  longitudeTo: number,
  levelTo: number,
  preview: boolean,
): void


Provides route between two geojson features, both specified by id

  idFrom: number,
  idTo: number,
  preview: boolean,
): void


Cancels the current route and removes the routing visuals

Other methods

ProximiioMapbox.setUnitConversion(unit: string, conversionCoefficient: number): void

configure unit that should be used for guidance (please make sure you have defined this unit in guidance translations in editor)

ProximiioMapbox.setStepImmediateThreshold(thresholdInMeters: number): void

set distance before a change in direction when the instruction should be considered ‘immediate’

ProximiioMapbox.setStepPreparationThreshold(thresholdInMeters: number): void

set distance before a change in direction when the instruction should be considered comming ‘soon’ and possibly warn the user about upcoming event

ProximiioMapbox.setRouteFinishThreshold(thresholdInMeters: number): void

set a threshold which regulates how far from a destination user must be to be considered he arrived,

ProximiioMapbox.setRerouteEnabled(enabled: boolean): void

enable rerouting if the user strays from path

ProximiioMapbox.setReRouteThreshold(thresholdInMeters: number): void

configure threshold when the user is considered strayed from path

ProximiioMapbox.setUserLocationToRouteSnappingEnabled(enabled: boolean): void

toggle snapping the user’s location on map to the current route

ProximiioMapbox.ttsEnable(): void

Enable TTS

ProximiioMapbox.ttsDisable(): void

Disable TTS

ttsHeadingCorrectionEnabled(enabled: boolean): void

Enable heading correction warnings. This will enable two spoken warnings - tell user starting orientation of route, and when the user is walking the wrong way.

ttsReassuranceInstructionEnabled(enabled: boolean): void

Enable reassurance instructions (meaning TTS will speak even if there is not a direction change to keep user confidence about current direction) using ttsReassuranceInstructionEnabled(boolean enabled) and configure distance between reassurance updates with ttsReassuranceInstructionDistance(double distanceInMeters)

ttsRepeatLastInstruction(): void

Repeat last instruction

ttsHazardAlert(enabled: boolean): void

Toggle spoken information about hazards

ttsSegmentAlert(enabled: boolean): void

Toggle spoken information about segments

ttsDecisionAlert(enabled: boolean): void

Toggle spoken information about decision points

ttsLandmarkAlert(enabled: boolean): void

Toggle spoken information about landmarks



called after the Proximi.io Mapbox finishes the authorization & data initialization


called if the Proximi.io Mapbox authorization or data initialization fails


called after the route is started, provides ProximiioRoute object

  (route: ProximiioRoute) => console.log(`route features: ${route.features}`)


called after the route was canceled

  () => console.log(`route canceled`)


called when the route is updated, use this method to provide navigation instructions to the user, available as route.text property

  (routeUpdate: ProximiioMapboxRouteUpdateEvent) => console.log(`route updated`)


called when user is passing landmark, provides Landmark GeoJSON Features

  (landmarks: ProximiioFeature[]) => console.log(`passing landmarks: ${landmarks}`)


called when user is passing a hazard, provides hazard GeoJSON Feature

  (hazard: ProximiioFeature) => console.log(`passing hazard: ${hazard}`)


called when user is passing a segment, provides segment GeoJSON Feature

  (segment: ProximiioFeature) => console.log(`passing segment: ${segment}`)


called when user is passing a decision point, provides decision point GeoJSON Feature

  (decisionPoint: ProximiioFeature) => console.log(`passing hazard: ${decisionPoint}`)

Download Details:

Author: proximiio

Source Code: https://github.com/proximiio/react-native-proximiio-mapbox

#react-native #react #mobile-apps

What is GEEK

Buddha Community

React Native Proximi.io Mapbox Library
Autumn  Blick

Autumn Blick


How native is React Native? | React Native vs Native App Development

If you are undertaking a mobile app development for your start-up or enterprise, you are likely wondering whether to use React Native. As a popular development framework, React Native helps you to develop near-native mobile apps. However, you are probably also wondering how close you can get to a native app by using React Native. How native is React Native?

In the article, we discuss the similarities between native mobile development and development using React Native. We also touch upon where they differ and how to bridge the gaps. Read on.

A brief introduction to React Native

Let’s briefly set the context first. We will briefly touch upon what React Native is and how it differs from earlier hybrid frameworks.

React Native is a popular JavaScript framework that Facebook has created. You can use this open-source framework to code natively rendering Android and iOS mobile apps. You can use it to develop web apps too.

Facebook has developed React Native based on React, its JavaScript library. The first release of React Native came in March 2015. At the time of writing this article, the latest stable release of React Native is 0.62.0, and it was released in March 2020.

Although relatively new, React Native has acquired a high degree of popularity. The “Stack Overflow Developer Survey 2019” report identifies it as the 8th most loved framework. Facebook, Walmart, and Bloomberg are some of the top companies that use React Native.

The popularity of React Native comes from its advantages. Some of its advantages are as follows:

  • Performance: It delivers optimal performance.
  • Cross-platform development: You can develop both Android and iOS apps with it. The reuse of code expedites development and reduces costs.
  • UI design: React Native enables you to design simple and responsive UI for your mobile app.
  • 3rd party plugins: This framework supports 3rd party plugins.
  • Developer community: A vibrant community of developers support React Native.

Why React Native is fundamentally different from earlier hybrid frameworks

Are you wondering whether React Native is just another of those hybrid frameworks like Ionic or Cordova? It’s not! React Native is fundamentally different from these earlier hybrid frameworks.

React Native is very close to native. Consider the following aspects as described on the React Native website:

  • Access to many native platforms features: The primitives of React Native render to native platform UI. This means that your React Native app will use many native platform APIs as native apps would do.
  • Near-native user experience: React Native provides several native components, and these are platform agnostic.
  • The ease of accessing native APIs: React Native uses a declarative UI paradigm. This enables React Native to interact easily with native platform APIs since React Native wraps existing native code.

Due to these factors, React Native offers many more advantages compared to those earlier hybrid frameworks. We now review them.

#android app #frontend #ios app #mobile app development #benefits of react native #is react native good for mobile app development #native vs #pros and cons of react native #react mobile development #react native development #react native experience #react native framework #react native ios vs android #react native pros and cons #react native vs android #react native vs native #react native vs native performance #react vs native #why react native #why use react native

Hire Dedicated React Native Developer

Have you ever thought of having your own app that runs smoothly over multiple platforms?

React Native is an open-source cross-platform mobile application framework which is a great option to create mobile apps for both Android and iOS. Hire Dedicated React Native Developer from top React Native development company, HourlyDeveloper.io to design a spectacular React Native application for your business.

Consult with experts:- https://bit.ly/2A8L4vz

#hire dedicated react native developer #react native development company #react native development services #react native development #react native developer #react native

React Native Mobile App Development

React Native is a framework that allows you to build mobile applications for both Android and iOS platforms using a similar codebase. This can shorten the development time and reduce the overall cost of building mobile apps.

Looking to create Mobile Applications but low in the budget? Contact Skenix Infotech now to get the most effective React Native Mobile App Development Services.

#react native development #mobile app development #react native ios app #react native ui #react native mobile app #react native

Hire Dedicated React Native Developers - WebClues Infotech

Being one of the emerging frameworks for app development the need to develop react native apps has increased over the years.

Looking for a react native developer?

Worry not! WebClues infotech offers services to Hire React Native Developers for your app development needs. We at WebClues Infotech offer a wide range of Web & Mobile App Development services based o your business or Startup requirement for Android and iOS apps.

WebClues Infotech also has a flexible method of cost calculation for hiring react native developers such as Hourly, Weekly, or Project Basis.

Want to get your app idea into reality with a react native framework?

Get in touch with us.

Hire React Native Developer Now: https://www.webcluesinfotech.com/hire-react-native-app-developer/

For inquiry: https://www.webcluesinfotech.com/contact-us/

Email: sales@webcluesinfotech.com

#hire react native developers #hire dedicated react native developers #hire react native developer #hiring a react native developer #hire freelance react native developers #hire react native developers in 1 hour

Factors affecting the cost of hiring a React Native developer in USA - TopDevelopers.co

Want to develop app using React Native? Here are the tips that will help to reduce the cost of react native app development for you.
Cost is a major factor in helping entrepreneurs take decisions about investing in developing an app and the decision to hire react native app developers in USA can prove to be fruitful in the long run. Using react native for app development ensures a wide range of benefits to your business. Understanding your business and working on the aspects to strengthen business processes through a cost-efficient mobile app will be the key to success.

#best react native development companies from the us #top react native app development companies in usa #cost of hiring a react native developer in usa #top-notch react native developer in usa #best react native developers usa #react native