如果需要使用地理围栏服务API，需要在“AndroidManifest.xml”文件中配置ACCESS_FINE_LOCATION权限和ACCESS_COARSE_LOCATION权限：
收起
自动换行
深色代码主题
复制
```
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
```
在Android 10版本中，您还需要在“AndroidManifest.xml”文件中配置ACCESS_BACKGROUND_LOCATION权限，确保在后台能够持续定位：
收起
自动换行
深色代码主题
复制
```
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
```

说明

以上地理围栏相关权限属于危险权限，使用时需要动态申请。

注册静态广播

地理围栏触发信息通过广播接收，需要在“AndroidManifest.xml”文件中注册广播接收器。

收起
自动换行
深色代码主题
复制
<!--注册地理围栏服务广播接收器-->
<receiver
    android:name=".geofence.GeoFenceBroadcastReceiver
"
    android:exported="true">
    <intent-filter>
        <action android:name="com.huawei.hmssample.geofence.GeoFenceBroadcastReceiver.ACTION_PROCESS_LOCATION
" />
    </intent-filter>
</receiver>

初始化地理围栏客户端

请在主线程中声明GeofenceService类对象，传入Context或Activity类型参数。

Java

Kotlin

收起
自动换行
深色代码主题
复制
private GeofenceService geofenceService
;
private ArrayList<String> idList
;
private ArrayList<Geofence> geofenceList
;
private String TAG
;
private PendingIntent pendingIntent
;
// 创建一个新的GeofenceService实例    
geofenceService
 = LocationServices.getGeofenceService(this);
// 获取PendingIntent对象
pendingIntent
 = getPendingIntent();
idList
 = new ArrayList<String>();
geofenceList
 = new ArrayList<Geofence>();

收起
自动换行
深色代码主题
复制
private var geofenceService
: GeofenceService? = null
private var idList
: ArrayList<String>? = null
private var geofenceList
: ArrayList<Geofence>? = null
private var TAG
: String? = null
private var pendingIntent
: PendingIntent? = null
// 创建一个新的GeofenceService实例    
geofenceService
 = LocationServices.getGeofenceService(this)
// 获取PendingIntent对象
pendingIntent
 = getPendingIntent()
idList
 = ArrayList()
geofenceList
 = ArrayList()

创建并添加地理围栏

您可以先创建地理围栏实例，并构建添加地理围栏的请求。在发送请求之后，会通过Task通知您是否添加成功。

创建地理围栏实例。

Java

Kotlin

收起
自动换行
深色代码主题
复制
geofenceList
.add(new Geofence.Builder()    
    .setUniqueId("mGeofence"
)    
    .setValidContinueTime(10000
)    
    // 传入经纬度信息，圆形地理围栏半径（单位:米）
    .setRoundArea(latitude
, longitude, radius
)    
    // 进入或退出围栏时触发回调
    .setConversions(Geofence.ENTER_GEOFENCE_CONVERSION | Geofence.EXIT_GEOFENCE_CONVERSION)    
    .build());
idList
.add("mGeofence"
);

收起
自动换行
深色代码主题
复制
geofenceList
!!.add(
    Geofence.Builder()
        .setUniqueId("mGeofence"
)
        // 传入经纬度信息，圆形地理围栏半径（单位:米）
        .setValidContinueTime(10000
) 
        // 进入或退出围栏时触发回调
        .setRoundArea(latitude
, longitude
, radius
.toFloat()) 
        .setConversions(Geofence.ENTER_GEOFENCE_CONVERSION or Geofence.EXIT_GEOFENCE_CONVERSION)
        .build()
)
idList
!!.add("mGeofence"
)

Geofence.builder的核心方法解析

展开

方法名	参数说明	返回值说明	方法效果
setConversions(int conversions)	设置地理围栏触发类型，触发类型包含进入(值为1)、退出(值为2)、驻留(值为4)三种，支持“或”位运算	Geofence.Builder对象	设置地理围栏触发类型
setDwellDelayTime(int dwellDelayTime)	设置地理围栏驻留触发时间，当用户在围栏中并停留超过这个时间，则会触发围栏上报	Geofence.Builder对象	设置地理围栏驻留触发时间
setNotificationInterval(int notificationInterval)	设置通知响应能力，默认为0秒，如果设置的值较大，可以相应地降低功耗，但是可能会延迟上报围栏事件。	Geofence.Builder对象	设置通知响应能力
setRoundArea(double latitude, double longitude, float radius)	设置圆形围栏的中心点经纬度和半径	Geofence.Builder对象	设置圆形围栏的中心点经纬度和半径
setUniqueId(String uniqueId)	设置地理围栏的唯一ID。唯一ID是一个字符串，用于标识地理围栏。当创建地理围栏的uniqueId已存在时，新的围栏会替换旧的围栏。	Geofence.Builder对象	设置地理围栏的唯一ID
setValidContinueTime(long validContinueTime)	设置地理围栏超时时间。超过该时间，该地理围栏将自动移除。如果值小于0时，地理围栏将会设置为永不过期。	Geofence.Builder对象	设置地理围栏超时时间

创建添加地理围栏的请求。

Java

Kotlin

收起
自动换行
深色代码主题
复制
private GeofenceRequest getAddGeofenceRequest() {    
    GeofenceRequest.Builder builder
 = new GeofenceRequest.Builder();    
    // 当用户在围栏中时，添加围栏后立即触发回调
    builder
.setInitConversions(GeofenceRequest.ENTER_INIT_CONVERSION);    
    builder
.createGeofenceList(geofenceList
);    
    return builder
.build();
}

收起
自动换行
深色代码主题
复制
private fun getAddGeofenceRequest(): GeofenceRequest? {
    val builder
 = GeofenceRequest.Builder()
    // 当用户在围栏中时，添加围栏后立即触发回调
    builder
.setInitConversions(GeofenceRequest.ENTER_INIT_CONVERSION)
    builder
.createGeofenceList(geofenceList
)
    return builder
.build()
}

GeofenceRequest.Builder核心方法解析

展开

方法名	参数说明	返回值说明	方法效果
createGeofence(Geofence geofence)	添加一个地理围栏。	GeofenceRequest.Builder对象。	添加单个地理围栏。
createGeofenceList(List<Geofence> geofences)	添加多个地理围栏。当前对于每个应用仅支持最多添加100个围栏。	GeofenceRequest.Builder对象。	添加多个地理围栏。
setCoordinateType(int coordinateType)	设置地理围栏坐标系类型，当前仅支持WGS-84坐标系。	GeofenceRequest.Builder对象。	设置地理围栏坐标系。类型
setInitConversions(int initConversions)	初始化触发类型，如果设置为0，则参数失效；默认值为GeofenceRequest.ENTER_INIT_CONVERSION \| GeofenceRequest.DWELL_INIT_CONVERSION。	GeofenceRequest.Builder对象。	设置初始化触发类型。

动态注册GeoFenceBroadcastReceiver广播接收器。

Java

Kotlin

收起
自动换行
深色代码主题
复制
// 通过PendingIntent动态注册GeoFenceBroadcastReceiver广播接收器,当触发围栏的时候，会通过广播通知。
private PendingIntent getPendingIntent() {
    Intent intent
 = new Intent(this, GeoFenceBroadcastReceiver.class
);
    intent
.setAction(GeoFenceBroadcastReceiver.ACTION_PROCESS_LOCATION
);
    if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.R) {
        return PendingIntent.getBroadcast(this, 0, intent
, PendingIntent.FLAG_UPDATE_CURRENT);
    } else {
        // 针对android12及以上设备需要主动配置pendingIntent的可变性，默认配置PendingIntent.FLAG_MUTABLE
        // 如果compileSdkVersion为30及以下，可将PendingIntent.FLAG_MUTABLE用 1<<25 替换
        // buildToolsVersion为31及以上才可使用PendingIntent.FLAG_MUTABLE
        return PendingIntent.getBroadcast(this, 0, intent
,
            PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_MUTABLE);
    }
}

收起
自动换行
深色代码主题
复制
// 通过PendingIntent动态注册GeoFenceBroadcastReceiver广播接收器,当触发围栏的时候，会通过广播通知。
private fun getPendingIntent(): PendingIntent? {
    val intent
 = Intent(this, GeoFenceBroadcastReceiver::class.java
)
    intent.action = GeoFenceBroadcastReceiver.ACTION_PROCESS_LOCATION
    return if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.R) {
        PendingIntent.getBroadcast(this, 0, intent
, PendingIntent.FLAG_UPDATE_CURRENT)
    } else {
        // 针对android12及以上设备需要主动配置pendingIntent的可变性，默认配置PendingIntent.FLAG_MUTABLE
        // 如果compileSdkVersion为30及以下，可将PendingIntent.FLAG_MUTABLE用 1<<25 替换
        // buildToolsVersion为31及以上才可使用PendingIntent.FLAG_MUTABLE
        PendingIntent.getBroadcast(
            this,
            0,
            intent
,
            PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_MUTABLE
        )
    }
}

发送添加地理围栏请求。

Java

Kotlin

收起
自动换行
深色代码主题
复制
// 通过传入PendingIntent的方式添加地理围栏,并处理地理围栏添加行为的响应数据
geofenceService
.createGeofenceList(getAddGeofenceRequest(), pendingIntent
)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task
) {
            if (task.isSuccessful()) {
                // TODO: 添加围栏成功处理
            } else {
                // TODO: 添加围栏失败处理
            }
        }
    });

收起
自动换行
深色代码主题
复制
// 通过传入PendingIntent的方式添加地理围栏,并处理地理围栏添加行为的响应数据
geofenceService
.createGeofenceList(getAddGeofenceRequest(), pendingIntent
)
    .addOnCompleteListener(OnCompleteListener<Void?> { task ->
        if (task.isSuccessful) {
            // TODO: 添加围栏成功处理
        } else {
            // TODO: 添加围栏失败处理
        }
    })

地理围栏触发信息处理。

当检测到用户触发围栏事件时，会通过PendingIntent发送广播通知用户。

Java

Kotlin

收起
自动换行
深色代码主题
复制
// 地理围栏服务广播接收器
public class GeoFenceBroadcastReceiver
 extends BroadcastReceiver {
    public static final String ACTION_PROCESS_LOCATION
 = 
        "com.huawei.hmssample.geofence.GeoFenceBroadcastReceiver.ACTION_PROCESS_LOCATION";

    @Override
    public void onReceive(Context context
, Intent intent
) {
        if (intent
 != null) {
            final String action
 = intent
.getAction();
            if (ACTION_PROCESS_LOCATION
.equals(action
)) {
                // 从intent中解析出GeofenceData对象
                GeofenceData geofenceData
 = GeofenceData.getDataFromIntent(intent
);
                if (geofenceData
 != null) {
                   // 获取错误码
                   int errorCode
 = geofenceData
.getErrorCode();
                   // 获取地理围栏触发类型
                   int conversion
 = geofenceData
.getConversion();
                   // 获取触发的地理围栏信息
                   List<Geofence> list
 = geofenceData
.getConvertingGeofenceList();
                   // 获取触发时的位置信息
                   Location mLocation
 = geofenceData
.getConvertingLocation();
                   // 是否是正常触发围栏事件，返回false时表示出现错误
                   boolean status
 = geofenceData
.isSuccess();
                   // TODO: 您可以根据返回的地理围栏信息，做相应的
                }
            }
        }
    }
}

收起
自动换行
深色代码主题
复制
// 地理围栏服务广播接收器
class GeoFenceBroadcastReceiver
 : BroadcastReceiver() {
    override fun onReceive(
        context
: Context,
        intent
: Intent
    ) {
        if (intent
 != null) {
            val action
 = intent
.action
            if (ACTION_PROCESS_LOCATION
 == action
) {
                // 从intent中解析出GeofenceData对象
                val geofenceData
 = GeofenceData.getDataFromIntent(intent
)
                if (geofenceData
 != null) {
                    // 获取错误码
                    val errorCode
 = geofenceData
.errorCode
                    // 获取地理围栏触发类型
                    val conversion
 = geofenceData
.conversion
                    // 获取触发的地理围栏信息
                    val list
 = geofenceData
.convertingGeofenceList
                    // 获取触发时的位置信息
                    val mLocation
: Location = geofenceData
.convertingLocation
                    // 是否是正常触发围栏事件，返回false时表示出现错误
                    val status
 = geofenceData
.isSuccess
                    // TODO：您可以根据返回的地理围栏信息，做相应的处理
                }
            }
        }
    }

    companion object {
        const val ACTION_PROCESS_LOCATION
 =
            "com.huawei.hmssample.geofence.GeoFenceBroadcastReceiver.ACTION_PROCESS_LOCATION"
    }
}

移除地理围栏。除了通过id移除地理围栏，您还可以通过PendingIntent进行移除。

Java

Kotlin

收起
自动换行
深色代码主题
复制
// 通过围栏id移除地理围栏，并处理地理围栏移除行为的响应数据
geofenceService
.deleteGeofenceList(idList
).addOnCompleteListener(new OnCompleteListener<Void>() {
    @Override
    public void onComplete(Task<Void> task
) {
        if (task.isSuccessful()) {
            // TODO: 移除围栏成功处理
        } else {
            // TODO: 移除围栏失败处理
        }
    }
});

收起
自动换行
深色代码主题
复制
// 通过围栏id移除地理围栏，并处理地理围栏移除行为的响应数据
geofenceService
.deleteGeofenceList(idList
)
    .addOnCompleteListener(OnCompleteListener<Void?> { task ->
        if (task.isSuccessful) {
             // TODO: 移除围栏成功处理 
        } else {
            // TODO: 移除围栏失败处理
        }
    })

活动识别开发

室外高精度开发

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问 AI 助手提问