如何用Android Studio、Firebase、Kotlin实现同地图展示多注册用户位置

• 现状：已实现地图展示自身位置功能，当前固定把位置存储到/users/userlocation节点，无法区分不同用户
• 实现目标：
  • 按用户UID将位置信息独立存储到对应用户的节点下，和现有用户资料（UID、用户名、头像URL）的存储结构对齐
  • 在同一张地图上加载展示所有用户的实时位置标记
• 已试操作的问题点：
  • 给User类添加String类型的locationlogging字段，方向有偏差
  • 尝试在注册流程的用户入库方法中加位置逻辑，多次触发报错

1. 修正数据结构设计 #

不要把位置信息存为单字符串：位置是结构化的经纬度数据，不需要强行定义字符串字段存储。
正确的Firebase数据库结构应为：

/users
  /{用户的UID}
    uid: "xxx"
    username: "xxx"
    profileImageUrl: "xxx"
    location: 
      latitude: 39.123
      longitude: 116.456

对应的代码修正：

// 先定义可被Firebase正常序列化的位置类，必须包含无参构造
data class LocationLogging(
  val latitude: Double = 0.0,
  val longitude: Double = 0.0
) {
  constructor() : this(0.0, 0.0)
}

// 修正后的User类，用结构化位置字段替换原来的字符串型locationlogging
@Parcelize
data class User(
  val uid: String = "",
  val username: String = "",
  val profileImageUrl: String = "",
  val location: LocationLogging = LocationLogging()
) : Parcelable {
  // 保留无参构造适配Firebase序列化要求
  constructor() : this("", "", "", LocationLogging())
}

2. 修正位置写入逻辑 #

原代码将位置固定写到公共节点/users/userlocation的问题会导致所有用户的位置互相覆盖，需要改成写入当前登录用户的专属节点：

// 先校验当前登录状态，未登录直接跳过写入
val currentUid = FirebaseAuth.getInstance().currentUser?.uid ?: return@LocationCallback
val databaseRef = Firebase.database.reference
val locationData = LocationLogging(location.latitude, location.longitude)
// 写入对应用户节点下的location字段
databaseRef.child("/users/$currentUid/location").setValue(locationData)
  .addOnSuccessListener {
    Toast.makeText(applicationContext, "位置信息已同步", Toast.LENGTH_LONG).show()
  }
  .addOnFailureListener {
    Toast.makeText(applicationContext, "位置同步失败：${it.message}", Toast.LENGTH_LONG).show()
  }

3. 修正注册流程的入库逻辑 #

在注册阶段同步位置存储的思路是正确的，但不需要强行在注册时填写位置信息：注册完成时用户可能尚未授权位置权限，硬写默认坐标没有实际意义。
原代码在saveUserToFirebaseDatabase方法中漏了setValue的入库调用，这也是之前报错的核心原因之一。修正后的写法：

private fun saveUserToFirebaseDatabase(profileImageUrl: String) {
  val uid = FirebaseAuth.getInstance().uid ?: return
  val ref = FirebaseDatabase.getInstance().getReference("/users/$uid")
  // 构建完整User对象，位置字段用默认值初始化，后续拿到真实位置后动态覆盖更新即可
  val user = User(
    uid = uid,
    username = username_edittext_register.text.toString(),
    profileImageUrl = profileImageUrl,
    location = LocationLogging()
  )
  // 补全缺失的入库调用
  ref.setValue(user)
}

4. 实现全量用户位置的地图展示 #

通过监听/users节点的全量数据变化，自动在地图上加载所有用户的位置标记：
在MapsActivity的onMapReady方法中添加监听逻辑：

override fun onMapReady(googleMap: GoogleMap) {
  map = googleMap
  getLocationAccess()
  // 监听所有用户节点的位置数据变化
  Firebase.database.reference.child("/users").addValueEventListener(object : ValueEventListener {
    override fun onDataChange(snapshot: DataSnapshot) {
      // 每次数据更新时先清空旧标记，避免重复添加
      map.clear()
      // 遍历所有用户节点
      for (userSnapshot in snapshot.children) {
        val user = userSnapshot.getValue(User::class.java) ?: continue
        // 跳过无效的默认坐标数据（经纬度为0,0的占位数据）
        if (user.location.latitude == 0.0 && user.location.longitude == 0.0) continue
        val userLatLng = LatLng(user.location.latitude, user.location.longitude)
        // 为每个有效位置添加地图标记，可自定义标记样式
        map.addMarker(
          MarkerOptions()
            .position(userLatLng)
            .title(user.username)
        )
      }
    }

    override fun onCancelled(error: DatabaseError) {
      Toast.makeText(this@MapsActivity, "拉取用户位置失败：${error.message}", Toast.LENGTH_SHORT).show()
    }
  })
}

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