Android开发遇类型转换异常：无法转为com.google.android.gms.location.LocationListener

这个类型转换错误通常是因为位置更新的API使用方式和Google Play Services版本不匹配，或者接口实现/导入出现了问题。我来帮你一步步排查解决：

一、核心原因分析 #

你的MapsActivity已经声明实现了com.google.android.gms.location.LocationListener，但报错说明代码中某个地方尝试将当前类实例转换成该接口时失败了，最常见的场景是：

• 你使用了新版本的Play Services Location库（18.0.0+），但仍然沿用旧版的LocationListener回调方式；
• 不小心导入了错误的LocationListener类（比如系统自带的android.location.LocationListener，而非谷歌服务的版本）。

二、针对性解决方案 #

方案1：适配新版Play Services Location库（推荐） #

从Play Services 18.0.0开始，旧的FusedLocationApi和LocationListener已被弃用，官方推荐使用FusedLocationProviderClient和LocationCallback来处理位置更新。按以下步骤修改代码：

1. 更新类的实现和成员变量
   移除LocationListener接口实现，添加新版API所需的成员：

   // 移除implements LocationListener
   public class MapsActivity extends Fragment implements OnMapReadyCallback, GoogleApiClient.ConnectionCallbacks, GoogleApiClient.OnConnectionFailedListener {
       // 添加新的成员变量
       private FusedLocationProviderClient fusedLocationClient;
       private LocationCallback locationCallback;
       
       // ... 保留原有其他变量
   

2. 初始化新版API组件
   在onViewCreated方法中初始化FusedLocationProviderClient和位置回调：

   @Override
   public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
       super.onViewCreated(view, savedInstanceState);
       // ... 原有代码
       
       // 初始化FusedLocationClient
       fusedLocationClient = LocationServices.getFusedLocationProviderClient(getActivity());
       
       // 创建LocationCallback处理位置更新
       locationCallback = new LocationCallback() {
           @Override
           public void onLocationResult(LocationResult locationResult) {
               if (locationResult == null) {
                   return;
               }
               // 获取最新位置并更新UI和GeoFire
               myLastLoaction = locationResult.getLastLocation();
               displayLocation();
           }
       };
       
       // ... 原有代码
   }
   

3. 修改位置更新启动方法
   替换旧的位置更新请求逻辑：

   private void startLocationUpdates() {
       if (ActivityCompat.checkSelfPermission(getActivity(), Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(getActivity(), Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
           return;
       }
       // 用新版API请求位置更新
       fusedLocationClient.requestLocationUpdates(myLocationRequest, locationCallback, Looper.getMainLooper());
   }
   

4. 修改位置更新停止方法

   private void stopLocationUpdate() {
       // 移除位置更新回调
       fusedLocationClient.removeLocationUpdates(locationCallback);
   }
   

方案2：继续使用旧版API（仅兼容旧项目，不推荐） #

如果你想保留LocationListener的使用方式，需要做以下检查：

1. 确认导入的类正确
   确保你的导入是谷歌服务的位置监听器：

   import com.google.android.gms.location.LocationListener;
   

   避免导入系统自带的android.location.LocationListener（两者接口不兼容）。

2. 降低Play Services Location库版本
   在Module级别的build.gradle中，将位置库版本降到17.x：

   implementation 'com.google.android.gms:play-services-location:17.1.0'
   

3. 确保位置更新请求代码正确
   旧版API的位置更新请求逻辑应该是：

   private void startLocationUpdates() {
       if (ActivityCompat.checkSelfPermission(getActivity(), Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(getActivity(), Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
           return;
       }
       LocationServices.FusedLocationApi.requestLocationUpdates(myGoogleApiClient, myLocationRequest, this);
   }
   

三、额外注意事项 #

• 如果使用旧版API，确保GoogleApiClient构建正确：

  protected synchronized void buildGoogleApiClient() {
      myGoogleApiClient = new GoogleApiClient.Builder(getActivity())
              .addConnectionCallbacks(this)
              .addOnConnectionFailedListener(this)
              .addApi(LocationServices.API)
              .build();
      myGoogleApiClient.connect();
  }
  

• 始终在请求位置更新前完成权限检查，避免因权限缺失导致的其他异常。

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