Home
Support
Forum
Dashboard
Introduction
Getting Started
Android
iOS
API
Authorization
Users API
Locations API
Insights API
Trips API
Geofencing API
Moving Geofence API
Nearby API
Events API
Group API
Migration Guide
Backend Libraries
Powered by GitBook

Insights API

Insights APIs are on demand for our enterprise customers. In case you want us to process your location data to know your users Home, Work and POIs, please reach out to our customer support.

get
Get Home Insight API

https://api.geospark.co/v3/api/insights/home/
This API will provide the list of insights with boundary coordinates of the location, last visited detail, type and confidence for the user's home.
Request
Response
Request
Headers
Api-key
required
string
Auth-key E.g.- 33223kjhdcscijhb5sdbsdmjsdcbj5f
Query Parameters
user_id
required
string
Get Home location for the user. E.g.- 5d9450ace47bae6d70064a9b
Response
200: OK
{
    "status": true,
    "msg": "Success.",
    "code": 200,
    "data": {
        "user_id": "5f30d339b36114713d8b610e",
        "app_id": "5ed0e627372279444054d310_2",
        "home": [
            {
                "id": "5f3fa9c6b361144e2fbb94fe",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                4.891497893193696,
                                52.353609136438145
                            ],
                            ...
                            ...
                            [
                                4.891816390473826,
                                52.353578324857374
                            ]                       
                        ]
                    ]
                },
                "last_visited": {
                    "id": "5f36a5529b3043b3240c2c92",
                    "coordinates": {
                        "type": "Point",
                        "coordinates": [
                            4.891546992613287,
                            52.353057861328125
                        ]
                    },
                    "accuracy": null,
                    "altitude": 1.3552925316616893,
                    "recorded_at": "2020-08-14T14:53:06.320",
                    "started_at": null,
                    "created_at": "2020-08-14T14:53:06.505"
                },
                "tz_offset": "+0200",
                "confidence": "Medium",
                "type": "home",
                "created_at": "2020-08-21T11:02:27.831"
            }
        ]
    }
}

Sample Request

curl --location --request GET 'https://api.geospark.co/v3/api/insights/home/?user_id=5f30d339b36114713d8b610e' \
--header 'Api-key: ee5b950fdf284474a8727409cd12bb3b'

get
Get Work Insight API

https://api.geospark.co/v3/api/insights/work/
This API will provide the list of insights with boundary coordinates of the location, last visited detail, type and confidence for the user’s work.
Request
Response
Request
Headers
Api-key
required
string
Auth-key E.g.- 33223kjhdcscijhb5sdbsdmjsdcbj5f
Query Parameters
user_id
required
string
Get Work location for the user. E.g.- 5d9450ace47bae6d70064a9b
Response
200: OK
{
    "status": true,
    "msg": "Success.",
    "code": 200,
    "data": {
        "user_id": "5f30d339b36114713d8b610e",
        "app_id": "5ed0e627372279444054d310_2",
        "work": [
            {
                "id": "5f3fa9c6b361144e2fbb94ff",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                4.907285075174389,
                                52.36281525332162
                            ],
                            ...
                            ...
                            [
                                4.907603638813551,
                                52.36278444174071
                            ]
                        ]
                    ]
                },
                "last_visited": {
                    "id": "5f3bc1fc118fe82b1a623751",
                    "coordinates": {
                        "type": "Point",
                        "coordinates": [
                            4.907237518324856,
                            52.36199951171875
                        ]
                    },
                    "accuracy": null,
                    "altitude": -0.5668405294418335,
                    "recorded_at": "2020-08-17T08:31:24.594",
                    "started_at": null,
                    "created_at": "2020-08-18T11:56:44.237"
                },
                "tz_offset": "+0200",
                "confidence": "Medium",
                "type": "work",
                "created_at": "2020-08-21T11:02:28.295"
            }
        ]
    }
}

Sample Request

curl --location --request GET 'https://api.geospark.co/v3/api/insights/work/?user_id=5f30d339b36114713d8b610e' \
--header 'Api-key: ee5b950fdf284474a8727409cd12bb3b'

get
Get POI Insight API

https://api.geospark.co/v3/api/insights/poi/
This API will provide the list of insights with boundary coordinates of the location, last visited detail, type and confidence for POIs frequently visited by the user.
Request
Response
Request
Headers
Api-key
required
string
Auth-key E.g.- 33223kjhdcscijhb5sdbsdmjsdcbj5f
Query Parameters
user_id
required
string
Get POIs for the user. E.g.- 5d9450ace47bae6d70064a9b
Response
200: OK
{
    "status": true,
    "msg": "Success.",
    "code": 200,
    "data": {
        "user_id": "5f30d339b36114713d8b610e",
        "app_id": "5ed0e627372279444054d310_2",
        "insights": [
            {
                "id": "5f3fa9c6b361144e2fbb9500",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                4.909168389987688,
                                52.3609200524679
                            ],
                            ...
                            ...
                            [
                                4.909486939963033,
                                52.360889240887005
                            ]
                        ]
                    ]
                },
                "last_visited": {
                    "id": "5f350a1a23c368e44d9a4854",
                    "coordinates": {
                        "type": "Point",
                        "coordinates": [
                            4.909168389987687,
                            52.36029052734375
                        ]
                    },
                    "accuracy": null,
                    "altitude": -1.8016777038574219,
                    "recorded_at": "2020-08-13T09:38:27.361",
                    "started_at": null,
                    "created_at": "2020-08-13T09:38:34.169"
                },
                "tz_offset": "+0200",
                "confidence": "Medium",
                "type": "road",
                "created_at": "2020-08-21T11:02:28.865"
            },
            {
                "id": "5f3fa9c6b361144e2fbb9501",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                4.893461598938197,
                                52.35548792356163
                            ],
                            [
                                4.893780109757986,
                                52.35545711198083
                            ],
                            ...
                            ...
                            [
                                4.894067441293753,
                                52.355367693412276
                            ]
                        ]
                    ]
                },
                "last_visited": {
                    "id": "5f3bc1fa118fe82b1a623744",
                    "coordinates": {
                        "type": "Point",
                        "coordinates": [
                            4.893461598938197,
                            52.3548583984375
                        ]
                    },
                    "accuracy": null,
                    "altitude": -2.023803234100342,
                    "recorded_at": "2020-08-16T16:23:16.131",
                    "started_at": null,
                    "created_at": "2020-08-18T11:56:42.142"
                },
                "tz_offset": "+0200",
                "confidence": "Medium",
                "type": "residential",
                "created_at": "2020-08-21T11:02:29.710"
            },
            {
                "id": "5f3fa9c6b361144e2fbb9502",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                4.891453618793093,
                                52.35234461301476
                            ],
                            ...
                            ...
                            [
                                4.891772106961156,
                                52.35231380143401
                            ]
                        ]
                    ]
                },
                "last_visited": {
                    "id": "5f38f7a9113938bc6862e138",
                    "coordinates": {
                        "type": "Point",
                        "coordinates": [
                            4.891453618793093,
                            52.351715087890625
                        ]
                    },
                    "accuracy": null,
                    "altitude": 1.5472954213619232,
                    "recorded_at": "2020-08-16T09:08:57.303",
                    "started_at": null,
                    "created_at": "2020-08-16T09:08:57.513"
                },
                "tz_offset": "+0200",
                "confidence": "Medium",
                "type": "house_number",
                "created_at": "2020-08-21T11:02:30.202"
            }
        ]
    }
}

Sample Request

curl --location --request GET 'https://api.geospark.co/v3/api/insights/poi/?user_id=5f30d339b36114713d8b610e' \
--header 'Api-key: ee5b950fdf284474a8727409cd12bb3b'
Previous
Locations API
Next
Trips API
Last updated 7 months ago
Contents
get
Get Home Insight API
Sample Request
get
Get Work Insight API
Sample Request
get
Get POI Insight API
Sample Request