The location.change event is triggered when a thing changes location.
Form
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| Thing key | String | This trigger can be limited to a thing specified by key. Leave blank to not limit this trigger to a specific thing. | |
| Thing tags | String | This trigger can be limited to things specified by tags. Leave blank to not limit this trigger to things specified by tag. When multiple tags are specified in the trigger event, the thing must have at least one tag in common for the trigger to execute. | |
| Fixtype | String | This trigger can be limited to the location fixation type. Typically "gps", "gnss", "manual", or "m2m-locate". |
Event variables
| Name | Type | Description |
|---|---|---|
| $(event.location.city) | String | The city of the thing's current location. |
| $(event.location.corrId) | String | The correlation ID of the location record. |
| $(event.location.delta) | Float | The distance from the previous location to the current location in meters. |
| $(event.location.fixAcc) | Float | The altitude of the thing's current location. |
| $(event.location.fixType) | String | The fixation type(s) of the location record. |
| $(event.location.country) | String | The country of the thing's current location. |
| $(event.location.lat) | Float | The latitude of the thing's current location. |
| $(event.location.lng) | Float | The longitude of the thing's current location. |
| $(event.location.heading) | Float | The heading of the thing's current location. |
| $(event.location.altitude) | Float | The accuracy (in meters) of the thing's current location. |
| $(event.location.speed) | Integer | The speed of the thing at the thing's current location. |
| $(event.location.state) | String | The state of the thing's current location. |
| $(event.location.street) | String | The street of the thing's current location. |
| $(event.location.streetNumber) | String | The street number of the thing's current location. |
| $(event.location.ts) | String | The timestamp associated with the thing's current location. |
| $(event.location.ts_prev) | String | The timestamp associated with the thing's previously published location. |
| $(event.location.zipCode) | String | The zip code of the thing's current location. |
| $(event.thing.key) | String | The key of the thing that initiated this trigger. |
| $(event.thing.name) | String | The name of the thing that initiated this trigger. |