/geofencing/v0/collections/{CollectionName}/positions

The Amazon Location Service multi-region endpoint

http://geo.{region}.amazonaws.com

POST

Evaluates device positions against the geofence geometries from a given geofence collection.

This operation always returns an empty response because geofences are asynchronously evaluated. The evaluation determines if the device has entered or exited a geofenced area, and then publishes one of the following events to Amazon EventBridge:

ENTER if Amazon Location determines that the tracked device has entered a geofenced area.
EXIT if Amazon Location determines that the tracked device has exited a geofenced area.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠480InternalServerException

🟠481ResourceNotFoundException

🟠482AccessDeniedException

🟠483ValidationException

🟠484ThrottlingException

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http://geo.{region}.amazonaws.com/geofencing/v0/collections//positions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "DevicePositionUpdates": [
        {
            "DeviceId": "string",
            "Position": [],
            "SampleTime": "string"
        }
    ]
}'

Response Example

200 - Example 1

{
    "Errors": []
}

Modified at 2022-09-10 19:59:22

/geofencing/v0/collections/{CollectionName}/delete-geofences

/tracking/v0/trackers/{TrackerName}/get-positions