Android Studio从Cloud Firestore取经纬度添加地图标记失败求助

可能的原因 #

• Firestore数据读取逻辑问题：集合名称拼写错误（大小写敏感）、查询未使用异步回调导致数据未加载完成就执行标记添加，或者查询条件过滤了所有数据。
• 模型类字段映射不匹配：ListPlacesModel的字段名、get/set方法与Firestore文档中的字段名不一致，导致数据无法正确解析。
• 经纬度处理错误：placeLat/placeLng为空、格式错误（如字符串未转为double），或值超出有效范围（纬度-90_{90，经度-180}180）。
• 地图标记添加逻辑问题：未正确获取GoogleMap实例，或标记位置不在当前地图可视范围内。
• Firestore权限限制：当前用户无读取该集合的权限，导致数据未获取但无报错提示。

对应解决方法 #

1. 修复Firestore数据读取逻辑 #

• 核对Firestore控制台中的集合名称与代码中的完全一致（注意大小写）。
• 必须在Firestore异步回调中处理标记添加，确保数据加载完成后再执行操作，示例代码：

  @Override
  public void onMapReady(GoogleMap googleMap) {
      mMap = googleMap;
      FirebaseFirestore db = FirebaseFirestore.getInstance();
      db.collection("your_collection_name")
        .get()
        .addOnSuccessListener(queryDocumentSnapshots -> {
            List<ListPlacesModel> places = queryDocumentSnapshots.toObjects(ListPlacesModel.class);
            // 打印日志确认是否获取到数据
            Log.d("Firestore", "获取到的地点数量：" + places.size());
            for (ListPlacesModel place : places) {
                // 后续添加标记逻辑
            }
        })
        .addOnFailureListener(e -> {
            // 捕获读取失败的异常，排查问题
            Log.e("Firestore", "读取数据失败", e);
        });
  }
  

2. 修正模型类字段映射 #

• 确保ListPlacesModel的字段名与Firestore文档字段完全一致，若字段名风格不同（如Firestore用place_lat，模型类用placeLat），需添加@PropertyName注解指定映射：

  public class ListPlacesModel {
      @PropertyName("place_lat")
      private Double placeLat;
      @PropertyName("place_lng")
      private Double placeLng;
      @PropertyName("place_name")
      private String placeName;
  
      // 对应的get/set方法
      @PropertyName("place_lat")
      public Double getPlaceLat() { return placeLat; }
      @PropertyName("place_lat")
      public void setPlaceLat(Double placeLat) { this.placeLat = placeLat; }
      // 其他字段的get/set同理
  }
  

3. 验证并修复经纬度处理 #

• 处理经纬度前先判空并验证有效性：

  for (ListPlacesModel place : places) {
      Double lat = place.getPlaceLat();
      Double lng = place.getPlaceLng();
      if (lat == null || lng == null) {
          Log.w("Map", "地点" + place.getPlaceName() + "经纬度为空，跳过");
          continue;
      }
      if (lat < -90 || lat > 90 || lng < -180 || lng > 180) {
          Log.w("Map", "地点" + place.getPlaceName() + "经纬度无效：" + lat + "," + lng);
          continue;
      }
      LatLng latLng = new LatLng(lat, lng);
      mMap.addMarker(new MarkerOptions().position(latLng).title(place.getPlaceName()));
      // 将地图视角移动到第一个标记位置
      mMap.moveCamera(CameraUpdateFactory.newLatLngZoom(latLng, 12));
  }
  

4. 确保地图标记添加逻辑正确 #

• 确认onMapReady中已成功初始化GoogleMap实例，避免在实例为空时调用addMarker。
• 添加标记后调用moveCamera将地图视角定位到标记区域，防止标记在可视范围外导致看不到。

5. 检查Firestore权限 #

• 临时修改Firestore规则为允许公开读取（仅测试用，上线需改回安全规则）：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /{document=**} {
        allow read, write: if true;
      }
    }
  }
  

• 若需用户认证，确保App已完成Firebase Auth登录流程，再执行Firestore数据读取。

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