diff --git a/docs/api/location/location-change.md b/docs/api/location/location-change.md
index 85a74c9ca5301af1beead7890b8d4c7f105b46b4..0d160bbf27192a0f181659600070c69c86d2c275 100644
--- a/docs/api/location/location-change.md
+++ b/docs/api/location/location-change.md
@@ -4,7 +4,18 @@
 监听实时地理位置变化事件，需结合 `uni.startLocationUpdate` 或 `uni.startLocationUpdateBackground` 使用。
 
 ::: warning 注意
-Web平台本API调用了腾讯地图的gcj02坐标转换接口，该接口从2024年7月18日起被腾讯逐步下线，导致老版本中本API无法使用。请立即升级到 uni-app 4.26版。
+Web平台本API之前调用了腾讯地图的gcj02坐标免费转换接口，该接口从2024年7月18日起被腾讯逐步下线，导致老版本中本API无法使用。请立即升级到 uni-app 4.24版。
+
+升级后注意：
+1. cli项目需升级cli
+2. manifest中配置好自己的地图厂商key
+3. 确保在地图厂商那里配额足够
+4. 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
+5. 确保自己的域名在地图厂商那里正确配置了域名白名单
+
+如果运行在微信浏览器中，可以使用微信的jssdk的定位能力。这个是微信向腾讯地图申请的key，开发者无需配置自己的key。
+
+地图厂商的商业授权较贵，如需购买，请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
 :::
 
 **平台差异说明**
diff --git a/docs/api/location/location.md b/docs/api/location/location.md
index 8af920ff6e080bdd4612a2dca74e7fcd614ccbb0..227aa07b3523fae790b1903ac98bec2db0c2b7d0 100644
--- a/docs/api/location/location.md
+++ b/docs/api/location/location.md
@@ -2,7 +2,19 @@
 获取当前的地理位置、速度。
 
 ::: warning 注意
-Web平台本API调用了腾讯地图的gcj02坐标转换接口，该接口从2024年7月18日起被腾讯逐步下线，导致老版本中本API无法使用。请立即升级到 uni-app 4.24版。
+Web平台本API之前调用了腾讯地图的gcj02坐标免费转换接口，该接口从2024年7月18日起被腾讯逐步下线，导致老版本中本API无法使用。请立即升级到 `uni-app 4.24版`。
+
+升级后注意：
+1. cli项目需升级cli
+2. manifest中配置好自己的地图厂商key
+3. 确保在地图厂商那里配额足够
+4. 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
+5. 确保自己的域名在地图厂商那里正确配置了域名白名单
+
+如果运行在微信浏览器中，可以使用微信的jssdk的定位能力。这个是微信向腾讯地图申请的key，开发者无需配置自己的key。
+
+地图厂商的商业授权较贵，如需购买，请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
+
 :::
 
 <!-- UNIAPPAPIJSON.getLocation.compatibility -->
@@ -91,7 +103,17 @@ uni.getLocation({
 打开地图选择位置。
 
 ::: warning 注意
-Web平台本API调用了腾讯地图的gcj02坐标转换接口，该接口从2024年7月18日起被腾讯逐步下线，导致老版本中本API无法使用。请立即升级到 uni-app 4.26版。
+Web平台和App平台，本API之前调用了腾讯地图的gcj02坐标免费，该接口从2024年7月18日起被腾讯逐步下线，导致老版本中本API无法使用。请立即升级到 `uni-app 4.24版`。
+
+升级后注意：
+1. 如果是cli或离线打包，需要配套升级cli和离线sdk
+2. manifest中配置好自己的地图厂商key。web和app都需要。一般标准基座正常，自定义基座和打包后异常，都是这个原因
+3. 确保在地图厂商那里配额足够
+4. 确保在地图厂商那里有周边服务的权限。否则无法获取周围地址
+5. web平台确保自己的域名在地图厂商那里正确配置了域名白名单
+
+地图厂商的商业授权较贵，如需购买，请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
+
 :::
 
 **平台差异说明**