Android应用激活定位后，自定义定位按钮需多次点击生效问题求助

Hey there, let's break down why your custom location button needs multiple taps to show the user's position and fix it step by step.

核心问题原因 #

1. getLastLocation() 首次返回 null 未处理
   当用户刚激活GPS从设置页面返回时，系统还没来得及获取到有效位置，getLastLocation()会返回null。你的代码虽然发起了位置更新请求，但在LocationCallback中拿到新位置后，没有触发任何地图更新逻辑——这就导致第一次点击没有反馈，必须等后续点击时getLastLocation()能拿到缓存的位置才生效。

2. 重复调用 getMapAsync() 导致延迟
   每次点击按钮都调用supportMapFragment.getMapAsync()，但地图Fragment可能已经处于ready状态，重复初始化会增加不必要的延迟，甚至阻塞UI线程，造成“点击没反应”的错觉。

3. 硬编码Google Map内部控件ID不可靠
   你在geoButton()和getCurrentLocation()中用findViewById(Integer.parseInt("1"))获取系统定位按钮，Google Map的内部控件ID是不公开且可能随版本变化的，这会导致隐藏系统按钮的逻辑不稳定，甚至干扰自定义按钮的交互。

4. 从设置返回后未同步定位状态
   用户从系统定位设置页面返回后，你的Activity没有重新检查定位服务状态，可能导致按钮点击时的状态判断滞后。

修复方案 #

1. 处理getLastLocation()返回null的情况，拿到新位置立即更新地图

抽离地图更新逻辑为单独方法，在获取到新位置后直接触发地图渲染：

// 添加全局变量保存GoogleMap实例
private GoogleMap googleMap;

@SuppressLint("MissingPermission")
private void getCurrentLocation() {
    LocationManager locationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
    if (locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER) || locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER)){
        client.getLastLocation().addOnCompleteListener(new OnCompleteListener<Location>() {
            @Override
            public void onComplete(@NonNull Task<Location> task) {
                Location location = task.getResult();
                if (location != null){
                    updateMapWithLocation(location);
                }else {
                    LocationRequest locationRequest = new LocationRequest()
                            .setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY)
                            .setInterval(10000)
                            .setFastestInterval(1000)
                            .setNumUpdates(1);
                    LocationCallback locationCallback = new LocationCallback(){
                        @Override
                        public void onLocationResult(LocationResult locationResult) {
                            Location location1 = locationResult.getLastLocation();
                            if (location1 != null) {
                                updateMapWithLocation(location1);
                            }
                            // 获取到位置后停止更新，避免资源浪费
                            client.removeLocationUpdates(this);
                        }
                    };
                    client.requestLocationUpdates(locationRequest, locationCallback, Looper.myLooper());
                }
            }
        });
    }else {
        buildAlertMessageNoGps();
    }
}

// 抽离地图更新逻辑，避免重复代码
private void updateMapWithLocation(Location location) {
    // 地图已初始化完成，直接更新UI
    if (googleMap != null) {
        updateMapUI(location);
        return;
    }
    // 地图未初始化，等待ready后更新
    supportMapFragment.getMapAsync(new OnMapReadyCallback() {
        @Override
        public void onMapReady(GoogleMap map) {
            googleMap = map;
            updateMapUI(location);
        }
    });
}

// 单独处理地图UI更新
private void updateMapUI(Location location) {
    LatLng myposition = new LatLng(location.getLatitude(), location.getLongitude());
    googleMap.animateCamera(CameraUpdateFactory.newLatLngZoom(myposition, 12));
    try {
        googleMap.setMyLocationEnabled(true);
    } catch (SecurityException e) {
        e.printStackTrace();
    }
    // 用官方API隐藏系统定位按钮，替代硬编码ID
    googleMap.getUiSettings().setMyLocationButtonEnabled(false);
    googleMap.getUiSettings().setCompassEnabled(false);
    googleMap.getUiSettings().setMapToolbarEnabled(false);
    
    // 保留你的地图点击逻辑
    googleMap.setOnMapClickListener(new GoogleMap.OnMapClickListener() {
        @Override
        public void onMapClick(LatLng latLng) {
            final LinearLayout layout_scroll = findViewById(R.id.layout_scroll);
            final ViewGroup.LayoutParams params = layout_scroll.getLayoutParams();
            layout_scroll.setVisibility(View.INVISIBLE);
            params.height = 0;
            layout_scroll.setLayoutParams(params);
            final LinearLayout layout_more_block = findViewById(R.id.layout_more_block);
            final ViewGroup.LayoutParams params_more = layout_more_block.getLayoutParams();
            layout_more_block.setVisibility(View.INVISIBLE);
            params_more.height = 0;
            layout_more_block.setLayoutParams(params_more);
            Animation slideDown = AnimationUtils.loadAnimation(getApplicationContext(), R.anim.slide_down);
            layout_more_block.startAnimation(slideDown);
        }
    });
}

2. 删除不可靠的geoButton()方法

用官方API替代硬编码隐藏系统定位按钮，也就是上面代码中的googleMap.getUiSettings().setMyLocationButtonEnabled(false);，这是Google推荐的稳定方式，不会因为Map版本更新失效。

3. 从设置返回后同步定位状态

重写onResume()方法，每次Activity回到前台时检查定位服务状态：

@Override
protected void onResume() {
    super.onResume();
    LocationManager manager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
    boolean isLocationEnabled = manager.isProviderEnabled(LocationManager.GPS_PROVIDER) && manager.isProviderEnabled(LocationManager.NETWORK_PROVIDER);
    // 可以根据状态更新按钮样式或提示用户
}

4. 完善权限请求后的逻辑

在onRequestPermissionsResult()中处理权限授予后的初始化：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 100) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED && grantResults[1] == PackageManager.PERMISSION_GRANTED) {
            // 权限授予成功，可初始化定位相关逻辑
        } else {
            // 权限被拒绝，提示用户开启权限以使用定位功能
        }
    }
}

额外建议 #

• 添加加载提示（比如ProgressDialog），在获取位置的过程中给用户反馈，避免用户以为按钮没反应而多次点击。
• 地图点击逻辑只需要在首次ready时设置一次，不需要每次更新位置都重复设置。

内容的提问来源于stack exchange，提问作者Mehdi.ncb