背景定位插件配置及向PHP服务器上报定位数据咨询

我经常帮开发者调试这类背景定位上报的需求，先给你整理好完整且规范的配置代码，同时把关键参数的作用拆解清楚：

// 初始化Background Geolocation配置
backgroundGeolocation.configure(
  // 成功获取定位后的回调函数
  function(location) {
    // 插件会自动把经纬度等定位数据上报到指定URL
    console.log('定位成功：', location.latitude, location.longitude);
    // 必须调用此方法告诉插件任务完成
    backgroundGeolocation.finish();
  },
  // 定位失败的回调函数
  function(error) {
    console.error('定位失败：', error.code, error.message);
  },
  {
    // 通用核心配置
    desiredAccuracy: 10, // 定位精度（米），数值越小精度越高
    stationaryRadius: 20, // 静止半径：用户移动距离小于此值时，不触发定位更新
    distanceFilter: 30, // 距离过滤器：用户移动超过此距离（米）才触发定位上报
    url: 'http://192.168.1.120/test.Php', // 接收数据的PHP服务器地址
    httpHeaders: { 'X-FOO': 'bar' }, // 自定义请求头，可用于鉴权或标识请求来源
    maxLocations: 1000, // 无网络时本地缓存的最大定位记录数，联网后自动批量上报

    // Android专属配置
    locationProvider: backgroundGeolocation.provider.ANDROID_ACTIVITY_PROVIDER, // 结合运动传感器的定位提供者，更省电精准
    interval: 60000, // 常规定位间隔（毫秒），默认60秒
    fastInterval: 10000 // 用户移动时的快速定位间隔（毫秒），默认10秒
  }
);

关键配置细节说明 #

• desiredAccuracy: 设置10米属于高精度定位，适合对位置精准度要求高的场景；如果优先考虑省电，可适当调高至100米左右。
• distanceFilter + stationaryRadius: 两者配合控制上报触发逻辑，用户静止时不会频繁上报，仅移动超过30米才触发，有效降低请求量和电量消耗。
• url: 插件会自动以POST请求将定位数据（包含latitude、longitude、timestamp等字段）发送到该地址，无需手动编写上报逻辑。
• httpHeaders: 自定义头可用于身份验证，比如携带用户Token，避免非法请求访问服务器。

PHP服务器端接收示例 #

对应的test.php可以这么写来接收并处理经纬度数据：

<?php
// 获取POST请求中的定位参数
$latitude = $_POST['latitude'] ?? '';
$longitude = $_POST['longitude'] ?? '';
$timestamp = $_POST['timestamp'] ?? date('Y-m-d H:i:s');

// 示例：将数据写入日志文件，也可存入数据库
file_put_contents(
    'location_records.log',
    "[$timestamp] 纬度: $latitude, 经度: $longitude\n",
    FILE_APPEND
);

// 返回200状态码告知插件上报成功
http_response_code(200);
echo json_encode(['status' => 'success']);
?>

另外要注意：Android端需提前申请ACCESS_FINE_LOCATION和ACCESS_BACKGROUND_LOCATION权限；iOS端要在Info.plist中配置对应的定位权限描述，否则插件无法正常工作。

内容的提问来源于stack exchange，提问作者Sandra Lopez