IndoorAtlas Data REST API allows to access user's positioning data:


Conditions for Usage / Data Storage Opt-In


You can only get data of those positioning sessions from the Data API that have been created using an Apikey that has opt-in for storing data. Please see more in Creating Applications and API Keys.


Usage

  1. Fetch a list of user's daily positioning session identifiers (sdkSetupId) and the related metadata. 
  2. Using the sdkSetupIds, make requests to get positioning data. 
  3. Metadata includes venue identities (venueIds), i.e., the venues user has visited during the positioning session. See more about accessing Venue metadata from Venue REST API.


API Keys

You need to create an API key with Data API scope enabled.  Use that as the key query string parameter in all requests to Data API. See details in Creating Applications and API Keys



Examples


Requesting a list of daily sdk setup identities (sdkSetupId) and related metadata of sessions for given day (year/month/day) and apikey ($APIKEY).


curl "https://data-api.indooratlas.com/public/v1/sdk-sessions/2018/9/1?key=$APIKEY"


[
    {
        "apikeyId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
        "bundleId": "com.example.app",
        "idaUuid": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "sdkSetupId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
        "venueIds": [
            "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"
        ]
    },
    {
        "apikeyId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
        "bundleId": "com.example.app",
        "idaUuid": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "sdkSetupId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
        "venueIds": [
            "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"
        ]
    }
]


Requesting session event data for given sdk setup id ($SDK_SETUP_ID) and user's apikey ($APIKEY).


curl "https://data-api.indooratlas.com/public/v1/sdk-sessions/$SDK_SETUP_ID/events?key=$APIKEY"


[
    {
        "content": {
            "context": {
                "indooratlas": {
                    "floorPlan": {
                        "id": null
                    },
                    "venue": {
                        "id": null
                    }
                }
            },
            "location": {
                "accuracy": 34,
                "altitude": 0,
                "bearing": 0,
                "coordinates": {
                    "lat": 65.0607161,
                    "lon": 25.4407358
                },
                "floorCertainty": 0.3333333432674408,
                "floorNumber": 0
            }
        },
        "ts": "2018-09-01T06:27:53.226Z",
        "type": "OUTPUT"
    },
    {
        "content": {
            "context": {
                "indooratlas": {
                    "floorPlan": {
                        "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"
                    },
                    "venue": {
                        "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx"
                    }
                }
            },
            "location": {
                "accuracy": 24,
                "altitude": 12,
                "bearing": 200.9311065673828,
                "coordinates": {
                    "lat": 65.06072753049021,
                    "lon": 25.440664564774256
                },
                "floorCertainty": 0.9601538181304932,
                "floorNumber": 3
            }
        },
        "ts": "2018-09-01T06:27:53.240Z",
        "type": "OUTPUT"
    },
    {
        "content": {
            "location": {
                "accuracy": 16,
                "altitude": 12,
                "bearing": 146.44210815429688,
                "coordinates": {
                    "lat": 65.0607469870066,
                    "lon": 25.440710648741646
                },
                "floorCertainty": 0.9996431469917297,
                "floorNumber": 3
            }
        },
        "ts": "2018-09-01T06:27:54.072Z",
        "type": "OUTPUT"
    },
]