Core - Places

Places represent the zones the user can access.

The base url for the APIs in this page is at:

/api/mobile

A JSON file with OpenAPI data abount all core-related mobile APIs can be downloaded here.

Get User’s Places

Retrieves the list of available places for the current user

Once the request has been made, the User Agent will require the list of the available places for the requesting user.

This request always waits 5 seconds before sending back a response.

GET /v1/places/available

Retrieves the list of available places for the current user

Status Codes

The resulting object is like this:

[
  {
    "CreatedDate": "2020-09-01T10:12:58Z",                            // DateTime
    "Guid": "673d5f92-c065-46b8-b3fb-fe7082faf5b2",                   // Guid
    "Labels": null,                                                   // String
    "Latitude": 45.660513,                                            // Double (nullable)
    "Longitude": 9.704467999999991,                                   // Double (nullable)
    "Name": "Milan Orio al Serio International Airport - ParkinGO",   // String
    "AdditionalData": null,                                           // String (nullable)
    "IsRoundtripArea": true,                                          // Boolean
    "IsFreefloatingArea": false,                                      // Boolean
    "UtcOffsetMinutes": 120,                                          // Int
    "ID": 3809                                                        // Int
  }
]

In this response example JSON data is formatted for clarity, but in the actual data stream there are no newlines inside JSON objects. The newline character is used to separate the streaming event data.

The User Agent should start a long-runnig request for updates, to be sure to get all the available updates.