Situm SDK is a set of utilities that allow any developer to build location based apps using Situm's indoor positioning system.
This project contains an app to test some basic examples using this SDK, so that you can get an idea of what you can achieve with Situm's tecnology.
In order to get this examples working you must follow this steps:
-
Create a Situm account, an Api key and a building. Just follow the steps in this link
-
Set your credentials in the app. Go to the
AndroidManifest.xmlfile and add your Situm credentials:
<meta-data
android:name="es.situm.sdk.API_USER"
android:value="@string/api_user"/>
<meta-data
android:name="es.situm.sdk.API_KEY"
android:value="@string/api_key"/>- Set your Google Maps api key in order to run the examples that show a map. Go to the
AndroidManifest.xmlfile and edit this field
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="@string/google_maps_key"/>Perfect! You can now test all the examples in this apps.
Remember that, to start positioning, you need to ask your user for the location permissions at runtime. The method LocationPermissions#request() is a basic example of how to handle this situation.
Check the official Android documentation for more details on this topic.
- Positioning: Download the buildings in your account and how to start the positioning in a building.
- Indoor-Outdoor: Use the indoor-outdoor positioning.
- Wayfinding: Use the new
MapViewto draw a building and interact with it. - Draw building: Draw the floorplan of a building over a map.
- Draw position: Draw the position you obtain from the SDK in the map.
- Animate position: Animate the position and the camera.
- Draw route: Draw a route between to points over the map.
- Guide instructions: Give indications when you are going to a point.
- Draw GeoJSON route: Draw Route as GeoJSON.
- Draw pois: Draw the pois of a building over the map
- Point inside geofence: Draw geofences and calculate if a point is inside them.
- Show realtime: Draw the users that are position inside a building over a map.
- Poi filtering: Filter the pois with a especific key-value.
- Update location parameters: Update the parameters of the location on the fly.
- Fetch resources: Download resources like building info, images, POIs, etc.
Please refer to CHANGELOG.md for a list of notables changes for each version of the plugin.
You can also see the tags on this repository.
You will need to sign a Contributor License Agreement (CLA) before making a submission. Learn more here.
This project is licensed under the MIT - see the LICENSE file for further details.
More info is available at our Developers Page.
For any question or bug report, please send an email to [email protected]