Geofencing

This topic describes the geofencing features.

Concepts

LBS

Location-based services (LBS) are software services that use geographic data and information to provide services to users. With the control database, the mobile client can access users’ geographic coordinates through the wireless communication network or satellite navigation system. This information is then integrated with other data to offer location-based services.

Geofencing

Geofencing is a new LBS application that creates a virtual perimeter around a physical location. Like a real fence, a geofence creates a separation between that location and the area around it. Unlike a real fence, it can detect movement inside the virtual boundary. When a device enters or leaves a specific area, users will receive notifications.

Geofencing applications

To create a geofence for travel devices, specify the radius with the device’s current location as the central point. The following describes how to use the standard geofencing features.

• Enable geofencing and set alerts: Use the geofencing setup method to enable this feature and set alert preferences, such as app notifications, SMS messages, and phone calls.

• Location of the geofence center: Usually the location where the vehicle was last locked, changing as the vehicle moves. When the vehicle is locked, it reports its current location. An alert will be triggered if the reported location deviates beyond the specified radius. Set the respective DP to receive an alert when the status of other features changes.

  These features allow users to monitor vehicle location and receive live alerts when unusual activities occur.

Geofencing services

Set a geofence

- (void)setGeofenceWithRequestModel:(TSODGeofenceModel *)requestModel
                            success:(nullable ThingSuccessBOOL)success
                            failure:(nullable ThingFailureError)failure NS_SWIFT_NAME(setGeofence(requestModel:success:failure:));

Example

    TSODGeofenceModel *requestModel = [[TSODGeofenceModel alloc] init];
    requestModel.devID = self.device.deviceModel.devId;
    requestModel.geofenceInfo.open = YES;
    requestModel.geofenceInfo.radius = 50;
    requestModel.geofenceInfo.noticeType = noticeType;
    requestModel.geofenceInfo.dpCode = @"blelock_switch";
    requestModel.geofenceInfo.dpValue = @NO;

    self.service = [[TSODGeofenceService alloc] init]
    [self.service setGeofenceWithRequestModel:requestModel success:^(**BOOL** result) {
		//...
    } failure:^(NSError *error) {

    }];

Get geofence information

- (void)getGeofenceInfoWithDevID:(NSString *)devID
                         success:(nullable void(^)(TSODGeofenceModel *geofenceModel))success
                         failure:(nullable ThingFailureError)failure NS_SWIFT_NAME(getGeofenceInfo(devID:success:failure:));

Example

self.service = [[TSODGeofenceService alloc] init]
[self.service getGeofenceInfoWithDevID:self.deviceModel.devId success:^(TSODGeofenceModel * _Nonnull geofenceModel) {
        BOOL isOpen = geofenceModel.geofenceInfo.isOpen;
        //...
    } failure:^(NSError *error) {

    }];

Data model of TSODGeofenceModel

Data model of TSODGeofenceInfoModel