Android 基于高德SDK开发的导航项目（入门级）

Android 基于高德 SDK开发的导航项目（入门级）

项目实现了一个功能完备的导航体系，包含：

• 地图显示和控制
  
• 门路规划和导航
  
• 语音播报功能
  
• 实时路况监控
  
• 安全提醒体系
  
• 气候信息和预警
  
• 智能出行建议
  

一、高德地图KEY的申请

①、进入高德的控制台：https://tengyun-console.amap.com
②、完成注册后，点击右边的 应用管理→我的应用→创建新应用→获取KEY （不会的就跟着我下面的步骤来，包会的）

如何获取自己的测试版安全码SHA1：

上述的命令：keytool -list -v -keystore debug.keystore
二、配置安卓干系权限和接入高德KEY

通过上述的操纵我们已经获取了高德地图的KEY，接下来就是对KEY的接入和对项目的权限配置
1、应用高德KEY

在AndroidManifest.xml中标签里面但不要在activity 标签下粘贴：

1. <meta-data
2.             android:name="com.amap.api.v2.apikey"
3.             android:value="换成自己的高德KEY" />

复制代码

2、配置权限

这些是大概会用到的权限，请在AndroidManifest.xml中粘贴（不要在标签里面粘贴，会报错）：

1. <!-- 允许程序访问互联网 -->
2. <uses-permission android:name="android.permission.INTERNET" />
4. <!-- 允许程序设置内置sd卡的写权限 -->
5. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
7. <!-- 允许程序获取网络状态 -->
8. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
10. <!-- 允许程序访问WiFi网络信息 -->
11. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
13. <!-- 允许程序读写手机状态和身份 -->
14. <uses-permission android:name="android.permission.READ_PHONE_STATE" />
16. <!-- 允许程序访问CellID或WiFi热点来获取粗略的位置 -->
17. <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
19. <!-- 允许程序通过GPS芯片接收卫星的定位信息 -->
20. <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
22. <!-- 允许程序修改全局音频设置 -->
23. <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
25. <!-- 允许程序录制音频，用于语音识别功能 -->
26. <uses-permission android:name="android.permission.RECORD_AUDIO" />  
28. <!-- 允许程序控制手机振动器 -->
29. <uses-permission android:name="android.permission.VIBRATE" />

复制代码

三、Android 地图SDK 干系下载与引入

①登录高德地图站点：https://lbs.amap.com/api/android-sdk/download

②将下载的压缩包进行压缩（最好存放在一起我们等会要用）

③引入 JAR包到Android

​
创建一个libs：

选中 JAR包并复制粘贴到libs下，右击这个包点击菜单栏里的“Add AS Library…”

这一步实在就是修改App应用下的“build.gradle”文件，添加了一个依赖 JAR包
在build.gradle（app）里应该会有这一行代码：implementation(files(“libs\AMap3DMap_10.1.200_AMapNavi_10.1.200_AMapSearch_9.7.4_AMapLocation_6.4.9_20241226.jar”))
④在Android应用的app/src/main目录下新建一个jniLibs子目录

末了就是这样的，到这里就算完成了配置，我们要正式开始写程序了
四、开发地图导航功能

1、地图的初始化创建（导入地图）

MainActivity里的代码

1. import android.Manifest;
2. import android.content.pm.PackageManager;
3. import android.graphics.Color;
4. import android.os.Bundle;
5. import android.widget.Toast;
7. import androidx.annotation.NonNull;
8. import androidx.appcompat.app.AppCompatActivity;
9. import androidx.core.app.ActivityCompat;
10. import androidx.core.content.ContextCompat;
12. import com.amap.api.maps.AMap;
13. import com.amap.api.maps.MapView;
14. import com.amap.api.maps.MapsInitializer;
15. import com.amap.api.maps.model.MyLocationStyle;
16. import com.amap.api.maps.CameraUpdateFactory;
18. /**
19. * 主活动类
20. * 用于展示高德地图的主界面
21. */
22. public class MainActivity extends AppCompatActivity {
23.     // 地图视图组件
24.     private MapView mapView;
25.     // 地图控制器对象
26.     private AMap aMap;
27.     // 定位权限请求码
28.     private static final int LOCATION_PERMISSION_REQUEST_CODE = 1;
29.     // 需要进行检测的权限数组
30.     private static final String[] NEEDED_PERMISSIONS = {
31.             Manifest.permission.ACCESS_FINE_LOCATION,
32.             Manifest.permission.ACCESS_COARSE_LOCATION
33.     };
35.     @Override
36.     protected void onCreate(Bundle savedInstanceState) {
37.         super.onCreate(savedInstanceState);
38.         
39.         // 设置高德地图隐私政策
40.         // 更新同意隐私状态，需要在初始化地图之前完成
41.         //如果没有这两行代码，你的地图可能会不显示
42.         MapsInitializer.updatePrivacyShow(this, true, true);  // 展示隐私合规对话框
43.         MapsInitializer.updatePrivacyAgree(this, true);      // 同意隐私合规政策
44.         
45.         setContentView(R.layout.activity_main);
46.         
47.         // 初始化地图组件
48.         mapView = findViewById(R.id.map);
49.         // 必须回调MapView的onCreate方法，否则地图无法显示
50.         mapView.onCreate(savedInstanceState);
51.         
52.         // 初始化地图控制器
53.         // 只有在aMap为空时才重新获取，避免重复初始化
54.         if (aMap == null) {
55.             aMap = mapView.getMap();
56.             // 设置地图UI控件
57.             setupMapUI();
58.         }
60.         // 检查并请求定位权限
61.         checkAndRequestPermissions();
62.     }
64.     /**
65.      * 设置地图UI和定位样式
66.      */
67.     private void setupMapUI() {
68.         // 设置定位蓝点的样式
69.         MyLocationStyle myLocationStyle = new MyLocationStyle();
70.         // 连续定位、且将视角移动到地图中心点，定位点依照设备方向旋转，并且会跟随设备移动
71.         myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);
72.         // 设置定位蓝点的Style
73.         myLocationStyle.strokeColor(Color.argb(180, 3, 145, 255));// 设置圆形的边框颜色
74.         myLocationStyle.radiusFillColor(Color.argb(10, 0, 0, 180));// 设置圆形的填充颜色
75.         myLocationStyle.strokeWidth(5.0f);// 设置圆形的边框粗细
76.         // 设置定位蓝点的 Style
77.         aMap.setMyLocationStyle(myLocationStyle);
79.         // 设置定位监听
80.         aMap.setOnMyLocationChangeListener(location -> {
81.             // 当位置发生变化时，将地图中心点移动到当前位置
82.             aMap.moveCamera(CameraUpdateFactory.newLatLngZoom(
83.                     new com.amap.api.maps.model.LatLng(location.getLatitude(), location.getLongitude()),
84.                     17)); // 设置缩放级别为17
85.         });
86.     }
88.     /**
89.      * 检查并请求定位权限
90.      */
91.     private void checkAndRequestPermissions() {
92.         if (lacksPermissions(NEEDED_PERMISSIONS)) {
93.             ActivityCompat.requestPermissions(this, NEEDED_PERMISSIONS, LOCATION_PERMISSION_REQUEST_CODE);
94.         } else {
95.             // 已经有权限，启用定位图层
96.             enableMyLocation();
97.         }
98.     }
100.     /**
101.      * 检查是否缺少权限
102.      */
103.     private boolean lacksPermissions(String... permissions) {
104.         for (String permission : permissions) {
105.             if (ContextCompat.checkSelfPermission(this, permission) !=
106.                     PackageManager.PERMISSION_GRANTED) {
107.                 return true;
108.             }
109.         }
110.         return false;
111.     }
113.     /**
114.      * 处理权限请求结果
115.      */
116.     @Override
117.     public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
118.             @NonNull int[] grantResults) {
119.         super.onRequestPermissionsResult(requestCode, permissions, grantResults);
120.         if (requestCode == LOCATION_PERMISSION_REQUEST_CODE) {
121.             if (grantResults.length > 0) {
122.                 boolean allGranted = true;
123.                 for (int grantResult : grantResults) {
124.                     if (grantResult != PackageManager.PERMISSION_GRANTED) {
125.                         allGranted = false;
126.                         break;
127.                     }
128.                 }
129.                 if (allGranted) {
130.                     // 获得权限，启用定位图层
131.                     enableMyLocation();
132.                 } else {
133.                     Toast.makeText(this, "需要定位权限才能显示当前位置", Toast.LENGTH_SHORT).show();
134.                 }
135.             }
136.         }
137.     }
139.     /**
140.      * 启用定位图层
141.      */
142.     private void enableMyLocation() {
143.         // 设置为true表示启动显示定位蓝点
144.         aMap.setMyLocationEnabled(true);
145.     }
147.     /**
148.      * Activity生命周期方法 - 恢复
149.      * 必须回调MapView的onResume方法，否则地图会处于暂停状态
150.      */
151.     @Override
152.     protected void onResume() {
153.         super.onResume();
154.         mapView.onResume();
155.     }
157.     /**
158.      * Activity生命周期方法 - 暂停
159.      * 必须回调MapView的onPause方法，暂停地图的绘制
160.      */
161.     @Override
162.     protected void onPause() {
163.         super.onPause();
164.         mapView.onPause();
165.     }
167.     /**
168.      * Activity生命周期方法 - 保存状态
169.      * 保存地图当前的状态，在重建Activity时恢复状态
170.      */
171.     @Override
172.     protected void onSaveInstanceState(Bundle outState) {
173.         super.onSaveInstanceState(outState);
174.         mapView.onSaveInstanceState(outState);
175.     }
177.     /**
178.      * Activity生命周期方法 - 销毁
179.      * 必须回调MapView的onDestroy方法，销毁地图，释放资源
180.      */
181.     @Override
182.     protected void onDestroy() {
183.         super.onDestroy();
184.         mapView.onDestroy();
185.     }
186. }

复制代码

activity_main.xml

1. <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
2.     xmlns:app="http://schemas.android.com/apk/res-auto"
3.     xmlns:tools="http://schemas.android.com/tools"
4.     android:id="@+id/main"
5.     android:layout_width="match_parent"
6.     android:layout_height="match_parent"
7.     tools:context=".MainActivity">
9.     <com.amap.api.maps.MapView
10.         android:id="@+id/map"
11.         android:layout_width="match_parent"
12.         android:layout_height="match_parent"
13.         app:layout_constraintBottom_toBottomOf="parent"
14.         app:layout_constraintEnd_toEndOf="parent"
15.         app:layout_constraintStart_toStartOf="parent"
16.         app:layout_constraintTop_toTopOf="parent" />
18. </androidx.constraintlayout.widget.ConstraintLayout>

复制代码

通过上面的代码，我们能实现地图的导入，也乐成的实现了这个项目的第一步（用真机进行测试，虚拟机会报错）

2、实现门路规划和导航

①类定义和接口实现

1. public class MainActivity extends AppCompatActivity implements
2.     RouteSearch.OnRouteSearchListener, // 路线搜索监听
3.     AMapNaviListener // 导航监听

复制代码

写完以后会有这样的报错：那是因为接口里的方法没有写全

解决步骤：
将鼠标放在这行代码上，点击Alt+Enter,Android会自动告诉你解决方法

这样Android就会帮我补全缺失的方法了
②创建一个可以拉动的半透明的面板

在res/layout下创建一个layout Resource File文件 名字叫 bottom_sheet_layout

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
2.     xmlns:app="http://schemas.android.com/apk/res-auto"
3.     android:id="@+id/bottom_sheet"
4.     android:layout_width="match_parent"
5.     android:layout_height="wrap_content"
6.     android:background="#F5FFFFFF"
7.     android:orientation="vertical"
8.     android:padding="16dp"
9.     app:behavior_hideable="false"
10.     app:behavior_peekHeight="180dp"
11.     app:behavior_draggable="true"
12.     app:behavior_fitToContents="true"
13.     app:layout_behavior="com.google.android.material.bottomsheet.BottomSheetBehavior">
15.     <!-- 拖动条指示器 -->
16.     <View
17.         android:layout_width="40dp"
18.         android:layout_height="4dp"
19.         android:layout_gravity="center_horizontal"
20.         android:layout_marginBottom="16dp"
21.         android:background="#CCCCCC" />
23. </LinearLayout>

复制代码

③创建一个搜索框

在res/drawable下创建一个search_background

1. <shape xmlns:android="http://schemas.android.com/apk/res/android"
2.     android:shape="rectangle">
3.     <solid android:color="#F5F5F5" />
4.     <corners android:radius="24dp" />
5.     <stroke
6.         android:width="1dp"
7.         android:color="#E0E0E0" />
8. </shape>

复制代码

在Activity_main.xml文件

1. <!-- 搜索框区域 -->
2.         <LinearLayout
3.             android:layout_width="match_parent"
4.             android:layout_height="wrap_content"
5.             android:orientation="horizontal"
6.             android:padding="8dp"
7.             android:layout_marginHorizontal="16dp"
8.             android:layout_marginBottom="8dp"
9.             android:background="@drawable/search_background"
10.             android:elevation="2dp">
12.             <!-- 搜索图标 -->
13.             <ImageView
14.                 android:id="@+id/search_icon"
15.                 android:layout_width="24dp"
16.                 android:layout_height="24dp"
17.                 android:layout_gravity="center_vertical"
18.                 android:layout_marginStart="8dp"
19.                 android:src="@android:drawable/ic_search_category_default"
20.                 app:tint="#666666" />
22.             <!-- 搜索输入框 -->
23.             <EditText
24.                 android:id="@+id/search_input"
25.                 android:layout_width="0dp"
26.                 android:layout_height="40dp"
27.                 android:layout_weight="1"
28.                 android:background="@null"
29.                 android:hint="搜索目的地"
30.                 android:textColorHint="#999999"
31.                 android:textColor="#333333"
32.                 android:textSize="16sp"
33.                 android:singleLine="true"
34.                 android:imeOptions="actionSearch"
35.                 android:layout_marginStart="8dp"
36.                 android:layout_marginEnd="8dp" />
38.         </LinearLayout>

复制代码

④规划和导航功能完备的代码

• 导航初始化 ：
  在 MainActivity.java 中，通过 initNaviAndRoute 方法初始化了导航功能，使用了高德地图的AMapNavi SDK。
  
• 门路规划 ：
  通过 planRoute 方法进行门路规划，支持驾车导航。
  
• 导航控制 ：
  在底部面板中有一个"开始导航"按钮，点击后会调用 startNavi 方法启动真实导航。
  
• 导航事件监听 ：
  实现了 AMapNaviListener 接口，处理惩罚各种导航事件，如：
  
• 导航初始化乐成/失败
  
• 开始导航
  
• 到达目的地
  
• 门路盘算乐成/失败
  
• 位置变革等
  
• 门路绘制 ：
  通过 drawRouteLine 方法在地图上绘制导航门路。
  
• 导航信息展示 ：
  在底部面板中显示导航干系信息，包括目的地、距离和预计时间，通过 updateBottomSheetInfo 方法更新。
  

1. import android.Manifest;
2. import android.content.Context;
3. import android.content.pm.PackageManager;
4. import android.graphics.Color;
5. import android.os.Bundle;
6. import android.text.TextUtils;
7. import android.view.View;
8. import android.view.inputmethod.EditorInfo;
9. import android.view.inputmethod.InputMethodManager;
10. import android.widget.Button;
11. import android.widget.EditText;
12. import android.widget.TextView;
13. import android.widget.Toast;
15. import androidx.annotation.NonNull;
16. import androidx.appcompat.app.AppCompatActivity;
17. import androidx.core.app.ActivityCompat;
18. import androidx.core.content.ContextCompat;
20. import com.amap.api.maps.AMap;
21. import com.amap.api.maps.MapView;
22. import com.amap.api.maps.MapsInitializer;
23. import com.amap.api.maps.model.MyLocationStyle;
24. import com.amap.api.maps.CameraUpdateFactory;
25. import com.amap.api.maps.model.LatLng;
26. import com.amap.api.maps.model.Marker;
27. import com.amap.api.maps.model.MarkerOptions;
28. import com.amap.api.navi.AMapNavi;
29. import com.amap.api.navi.AMapNaviListener;
30. import com.amap.api.navi.enums.PathPlanningStrategy;
31. import com.amap.api.navi.model.AMapCalcRouteResult;
32. import com.amap.api.navi.model.AMapLaneInfo;
33. import com.amap.api.navi.model.AMapModelCross;
34. import com.amap.api.navi.model.AMapNaviCameraInfo;
35. import com.amap.api.navi.model.AMapNaviCross;
36. import com.amap.api.navi.model.AMapNaviLocation;
37. import com.amap.api.navi.model.AMapNaviPath;
38. import com.amap.api.navi.model.AMapNaviRouteNotifyData;
39. import com.amap.api.navi.model.AMapNaviTrafficFacilityInfo;
40. import com.amap.api.navi.model.AMapServiceAreaInfo;
41. import com.amap.api.navi.model.AimLessModeCongestionInfo;
42. import com.amap.api.navi.model.AimLessModeStat;
43. import com.amap.api.navi.model.NaviInfo;
44. import com.amap.api.navi.model.NaviLatLng;
45. import com.amap.api.services.core.AMapException;
46. import com.amap.api.services.core.LatLonPoint;
47. import com.amap.api.services.core.PoiItem;
48. import com.amap.api.services.route.BusRouteResult;
49. import com.amap.api.services.route.DriveRouteResult;
50. import com.amap.api.services.route.RideRouteResult;
51. import com.amap.api.services.route.RouteSearch;
52. import com.amap.api.services.route.WalkRouteResult;
53. import com.google.android.material.bottomsheet.BottomSheetBehavior;
54. import com.amap.api.services.poisearch.PoiSearch;
55. import com.amap.api.services.poisearch.PoiResult;
56. import com.amap.api.maps.model.PolylineOptions;
57. import com.amap.api.maps.model.LatLngBounds;
59. import java.util.ArrayList;
60. import java.util.List;
62. public class MainActivity extends AppCompatActivity implements RouteSearch.OnRouteSearchListener, AMapNaviListener, PoiSearch.OnPoiSearchListener {
63.     // 地图视图组件
64.     private MapView mapView;
65.     // 地图控制器对象
66.     private AMap aMap;
67.     // 导航控制器对象
68.     private AMapNavi mAMapNavi;
69.     // 路线搜索对象
70.     private RouteSearch routeSearch;
71.     // 目的地标记
72.     private Marker destinationMarker;
73.     // 定位权限请求码
74.     private static final int LOCATION_PERMISSION_REQUEST_CODE = 1;
75.     // 需要进行检测的权限数组
76.     private static final String[] NEEDED_PERMISSIONS = {
77.             Manifest.permission.ACCESS_FINE_LOCATION,
78.             Manifest.permission.ACCESS_COARSE_LOCATION
79.     };
80.     private BottomSheetBehavior<View> bottomSheetBehavior;
81.     private TextView tvDestination, tvDistance, tvTime;
82.     private Button btnStartNavi;
83.     private LatLonPoint destinationPoint;  // 保存目的地坐标
85.     @Override
86.     protected void onCreate(Bundle savedInstanceState) {
87.         super.onCreate(savedInstanceState);
88.         
89.         try {
90.             MapsInitializer.updatePrivacyShow(this, true, true);
91.             MapsInitializer.updatePrivacyAgree(this, true);
92.             
93.         setContentView(R.layout.activity_main);
94.             
95.             // 初始化底部面板
96.             initBottomSheet();
97.             
98.             mapView = findViewById(R.id.map);
99.             mapView.onCreate(savedInstanceState);
100.             
101.             if (aMap == null) {
102.                 aMap = mapView.getMap();
103.                 setupMapUI();
104.             }
106.             initNaviAndRoute();
107.             checkAndRequestPermissions();
108.         } catch (Exception e) {
109.             e.printStackTrace();
110.             Toast.makeText(this, "初始化失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
111.         }
112.     }
114.     /**
115.      * 设置地图UI和定位样式
116.      */
117.     private void setupMapUI() {
118.         try {
119.             // 设置定位蓝点的样式
120.             MyLocationStyle myLocationStyle = new MyLocationStyle();
121.             // 连续定位、且将视角移动到地图中心点，定位点依照设备方向旋转，并且会跟随设备移动
122.             myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);
123.             // 设置定位蓝点的Style
124.             myLocationStyle.strokeColor(Color.argb(180, 3, 145, 255));// 设置圆形的边框颜色
125.             myLocationStyle.radiusFillColor(Color.argb(10, 0, 0, 180));// 设置圆形的填充颜色
126.             myLocationStyle.strokeWidth(5.0f);// 设置圆形的边框粗细
127.             // 设置定位蓝点的 Style
128.             aMap.setMyLocationStyle(myLocationStyle);
130.             // 设置定位监听
131.             aMap.setOnMyLocationChangeListener(location -> {
132.                 // 当位置发生变化时，将地图中心点移动到当前位置
133.                 aMap.moveCamera(CameraUpdateFactory.newLatLngZoom(
134.                         new com.amap.api.maps.model.LatLng(location.getLatitude(), location.getLongitude()),
135.                         17)); // 设置缩放级别为17
136.             });
137.         } catch (Exception e) {
138.             e.printStackTrace();
139.             Toast.makeText(this, "设置地图UI失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
140.         }
141.     }
143.     /**
144.      * 初始化导航和路线搜索
145.      */
146.     private void initNaviAndRoute() {
147.         try {
148.             // 初始化路线规划
149.             routeSearch = new RouteSearch(this);
150.             routeSearch.setRouteSearchListener(this);
152.             // 初始化导航
153.             mAMapNavi = AMapNavi.getInstance(getApplicationContext());
154.             mAMapNavi.addAMapNaviListener(this);
156.             // 设置地图点击监听，用于选择目的地
157.             aMap.setOnMapClickListener(latLng -> {
158.                 try {
159.                     // 清除之前的标记
160.                     if (destinationMarker != null) {
161.                         destinationMarker.remove();
162.                     }
163.                     // 添加新的目的地标记
164.                     MarkerOptions markerOptions = new MarkerOptions()
165.                             .position(latLng)
166.                             .title("目的地");
167.                     destinationMarker = aMap.addMarker(markerOptions);
169.                     // 开始路线规划
170.                     planRoute(latLng);
171.                 } catch (Exception e) {
172.                     e.printStackTrace();
173.                     Toast.makeText(this, "设置目的地失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
174.                 }
175.             });
176.         } catch (Exception e) {
177.             e.printStackTrace();
178.             Toast.makeText(this, "初始化导航失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
179.         }
180.     }
182.     /**
183.      * 检查并请求定位权限
184.      */
185.     private void checkAndRequestPermissions() {
186.         if (lacksPermissions(NEEDED_PERMISSIONS)) {
187.             ActivityCompat.requestPermissions(this, NEEDED_PERMISSIONS, LOCATION_PERMISSION_REQUEST_CODE);
188.         } else {
189.             // 已经有权限，启用定位图层
190.             enableMyLocation();
191.         }
192.     }
194.     /**
195.      * 检查是否缺少权限
196.      */
197.     private boolean lacksPermissions(String... permissions) {
198.         for (String permission : permissions) {
199.             if (ContextCompat.checkSelfPermission(this, permission) !=
200.                     PackageManager.PERMISSION_GRANTED) {
201.                 return true;
202.             }
203.         }
204.         return false;
205.     }
207.     /**
208.      * 处理权限请求结果
209.      */
210.     @Override
211.     public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
212.             @NonNull int[] grantResults) {
213.         super.onRequestPermissionsResult(requestCode, permissions, grantResults);
214.         if (requestCode == LOCATION_PERMISSION_REQUEST_CODE) {
215.             if (grantResults.length > 0) {
216.                 boolean allGranted = true;
217.                 for (int grantResult : grantResults) {
218.                     if (grantResult != PackageManager.PERMISSION_GRANTED) {
219.                         allGranted = false;
220.                         break;
221.                     }
222.                 }
223.                 if (allGranted) {
224.                     // 获得权限，启用定位图层
225.                     enableMyLocation();
226.                 } else {
227.                     Toast.makeText(this, "需要定位权限才能显示当前位置", Toast.LENGTH_SHORT).show();
228.                 }
229.             }
230.         }
231.     }
233.     /*启用定位图层*/
234.     private void enableMyLocation() {
235.         // 设置为true表示启动显示定位蓝点
236.         aMap.setMyLocationEnabled(true);
237.     }
239.     @Override
240.     protected void onResume() {
241.         super.onResume();
242.         mapView.onResume();
243.     }
244.     @Override
245.     protected void onPause() {
246.         super.onPause();
247.         mapView.onPause();
248.     }
249.     @Override
250.     protected void onSaveInstanceState(Bundle outState) {
251.         super.onSaveInstanceState(outState);
252.         mapView.onSaveInstanceState(outState);
253.     }
254.     @Override
255.     protected void onDestroy() {
256.         super.onDestroy();
257.         try {
258.             if (mapView != null) {
259.                 mapView.onDestroy();
260.             }
261.             if (mAMapNavi != null) {
262.                 mAMapNavi.destroy();
263.             }
264.         } catch (Exception e) {
265.             e.printStackTrace();
266.         }
267.     }
269.     @Override
270.     public void onInitNaviFailure() {
271.         // 导航初始化失败
272.         Toast.makeText(this, "导航初始化失败", Toast.LENGTH_SHORT).show();
273.     }
275.     @Override
276.     public void onInitNaviSuccess() {
277.         // 导航初始化成功
278.         Toast.makeText(this, "导航初始化成功", Toast.LENGTH_SHORT).show();
279.     }
281.     @Override
282.     public void onStartNavi(int type) {
283.         // 开始导航回调
284.         Toast.makeText(this, "开始导航", Toast.LENGTH_SHORT).show();
285.     }
287.     @Override public void onTrafficStatusUpdate() {}
289.     @Override
290.     public void onLocationChange(AMapNaviLocation location) {
291.         // 导航过程中位置变化
292.         }
294.     @Override public void onGetNavigationText(int i, String s) {}
295.     @Override public void onGetNavigationText(String s) {}
296.     @Override public void onEndEmulatorNavi() {}
298.     @Override
299.     public void onArriveDestination() {
300.         // 到达目的地
301.         Toast.makeText(this, "到达目的地", Toast.LENGTH_SHORT).show();
302.     }
304.     @Override public void onCalculateRouteFailure(int i) {}
305.     @Override public void onReCalculateRouteForYaw() {}
306.     @Override public void onReCalculateRouteForTrafficJam() {}
307.     @Override
308.     public void onArrivedWayPoint(int i) {}
309.     @Override public void onGpsOpenStatus(boolean b) {}
310.     @Override public void onNaviInfoUpdate(NaviInfo naviInfo) {}
311.     @Override
312.     public void updateCameraInfo(AMapNaviCameraInfo[] aMapNaviCameraInfos) {}
313.     @Override
314.     public void updateIntervalCameraInfo(AMapNaviCameraInfo aMapNaviCameraInfo, AMapNaviCameraInfo aMapNaviCameraInfo1, int i) {}
315.     @Override public void onServiceAreaUpdate(AMapServiceAreaInfo[] aMapServiceAreaInfos) {}
316.     @Override public void showCross(AMapNaviCross aMapNaviCross) {}
317.     @Override public void hideCross() {}
318.     @Override public void showModeCross(AMapModelCross aMapModelCross) {}
319.     @Override public void hideModeCross() {}
320.     @Override public void showLaneInfo(AMapLaneInfo[] aMapLaneInfos, byte[] bytes, byte[] bytes1) {}
321.     @Override public void showLaneInfo(AMapLaneInfo aMapLaneInfo) {}
322.     @Override public void hideLaneInfo() {}
323.     @Override public void onCalculateRouteSuccess(int[] ints) {}
324.     @Override public void notifyParallelRoad(int i) {}
325.     @Override public void OnUpdateTrafficFacility(AMapNaviTrafficFacilityInfo[] aMapNaviTrafficFacilityInfos) {}
326.     @Override public void OnUpdateTrafficFacility(AMapNaviTrafficFacilityInfo aMapNaviTrafficFacilityInfo) {}
327.     @Override public void updateAimlessModeStatistics(AimLessModeStat aimLessModeStat) {}
328.     @Override public void updateAimlessModeCongestionInfo(AimLessModeCongestionInfo aimLessModeCongestionInfo) {}
329.     @Override public void onPlayRing(int i) {}
331.     @Override
332.     public void onCalculateRouteSuccess(AMapCalcRouteResult result) {
333.         Toast.makeText(this, "路线规划成功", Toast.LENGTH_SHORT).show();
334.         AMapNaviPath path = mAMapNavi.getNaviPath();
335.         if (path != null) {
336.             // 更新底部面板信息
337.             updateBottomSheetInfo(path);
338.             // 绘制路线
339.             drawRouteLine(path);
340.         }
341.     }
343.     @Override
344.     public void onCalculateRouteFailure(AMapCalcRouteResult result) {
345.         // 路线规划失败
346.         Toast.makeText(this, "路线规划失败：" + result.getErrorDetail(), Toast.LENGTH_SHORT).show();
347.     }
349.      @Override public void onNaviRouteNotify(AMapNaviRouteNotifyData aMapNaviRouteNotifyData) {}
350.     @Override public void onGpsSignalWeak(boolean b) {}
351.     @Override public void onBusRouteSearched(BusRouteResult result, int errorCode) {}
352.     @Override public void onDriveRouteSearched(DriveRouteResult result, int errorCode) {}
353.     @Override public void onWalkRouteSearched(WalkRouteResult result, int errorCode) {}
354.     @Override public void onRideRouteSearched(RideRouteResult result, int errorCode) {}
356.     private void planRoute(LatLng destination) {
357.         try {
358.             if (aMap.getMyLocation() == null) {
359.                 Toast.makeText(this, "等待定位信息...", Toast.LENGTH_SHORT).show();
360.                 return;
361.             }
363.             // 获取起点（当前位置）
364.             LatLonPoint startPoint = new LatLonPoint(
365.                     aMap.getMyLocation().getLatitude(),
366.                     aMap.getMyLocation().getLongitude()
367.             );
368.             // 终点
369.             LatLonPoint endPoint = new LatLonPoint(destination.latitude, destination.longitude);
371.             // 构建导航数据
372.             List<NaviLatLng> startList = new ArrayList<>();
373.             List<NaviLatLng> endList = new ArrayList<>();
374.             startList.add(new NaviLatLng(startPoint.getLatitude(), startPoint.getLongitude()));
375.             endList.add(new NaviLatLng(endPoint.getLatitude(), endPoint.getLongitude()));
377.             // 开始算路
378.             mAMapNavi.calculateDriveRoute(startList, endList, null, 2);
379.         } catch (Exception e) {
380.             e.printStackTrace();
381.             Toast.makeText(this, "路线规划失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
382.         }
383.     }
385.     private void initBottomSheet() {
386.         try {
387.             View bottomSheet = findViewById(R.id.bottom_sheet);
388.             bottomSheetBehavior = BottomSheetBehavior.from(bottomSheet);
389.             
390.             // 设置初始状态为折叠
391.             bottomSheetBehavior.setState(BottomSheetBehavior.STATE_COLLAPSED);
392.             
393.             // 初始化视图
394.             tvDestination = findViewById(R.id.tv_destination);
395.             tvDistance = findViewById(R.id.tv_distance);
396.             tvTime = findViewById(R.id.tv_time);
397.             btnStartNavi = findViewById(R.id.btn_start_navi);
399.             // 初始化搜索框
400.             EditText searchInput = findViewById(R.id.search_input);
401.             searchInput.setOnEditorActionListener((v, actionId, event) -> {
402.                 if (actionId == EditorInfo.IME_ACTION_SEARCH) {
403.                     String keyword = searchInput.getText().toString().trim();
404.                     if (!TextUtils.isEmpty(keyword)) {
405.                         // 隐藏键盘
406.                         InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
407.                         imm.hideSoftInputFromWindow(searchInput.getWindowToken(), 0);
408.                         
409.                         // 开始搜索
410.                         searchLocation(keyword);
411.                         return true;
412.                     }
413.                 }
414.                 return false;
415.             });
417.             // 设置底部面板的状态改变监听
418.             bottomSheetBehavior.addBottomSheetCallback(new BottomSheetBehavior.BottomSheetCallback() {
419.                 @Override
420.                 public void onStateChanged(@NonNull View bottomSheet, int newState) {
421.                     switch (newState) {
422.                         case BottomSheetBehavior.STATE_COLLAPSED:
423.                             // 面板折叠状态
424.                             break;
425.                         case BottomSheetBehavior.STATE_EXPANDED:
426.                             // 面板展开状态
427.                             break;
428.                     }
429.                 }
431.                 @Override
432.                 public void onSlide(@NonNull View bottomSheet, float slideOffset) {
433.                     // 滑动时的处理
434.                 }
435.             });
437.             // 设置开始导航按钮点击事件
438.             btnStartNavi.setOnClickListener(v -> {
439.                 if (mAMapNavi != null) {
440.                     mAMapNavi.startNavi(1); // 1表示真实导航
441.                     bottomSheetBehavior.setState(BottomSheetBehavior.STATE_COLLAPSED);
442.                 }
443.             });
444.         } catch (Exception e) {
445.             e.printStackTrace();
446.             Toast.makeText(this, "初始化底部面板失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
447.         }
448.     }
450.     /**搜索位置*/
451.     private void searchLocation(String keyword) {
452.         try {
453.             Toast.makeText(this, "正在搜索: " + keyword, Toast.LENGTH_SHORT).show();
454.             
455.             // 创建POI搜索对象
456.             PoiSearch.Query query = new PoiSearch.Query(keyword, "", "全国");  // 设置搜索范围为全国
457.             query.setPageSize(10); // 设置每页最多返回多少条数据
458.             query.setPageNum(1);   // 设置查询第几页，从1开始
460.             PoiSearch poiSearch = new PoiSearch(this, query);
461.             poiSearch.setOnPoiSearchListener(this);
462.             
463.             // 如果当前位置可用，设置搜索中心点
464.             if (aMap != null && aMap.getMyLocation() != null) {
465.                 poiSearch.setBound(new PoiSearch.SearchBound(
466.                     new LatLonPoint(aMap.getMyLocation().getLatitude(),
467.                                   aMap.getMyLocation().getLongitude()),
468.                     50000));  // 设置搜索半径为50公里
469.             }
470.             
471.             poiSearch.searchPOIAsyn(); // 开始异步搜索
472.         } catch (AMapException e) {
473.             e.printStackTrace();
474.             Toast.makeText(this, "搜索初始化失败：" + e.getErrorMessage(), Toast.LENGTH_SHORT).show();
475.         } catch (Exception e) {
476.             e.printStackTrace();
477.             Toast.makeText(this, "搜索失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
478.         }
479.     }
481.     @Override
482.     public void onPoiSearched(PoiResult result, int rCode) {
483.         if (rCode == AMapException.CODE_AMAP_SUCCESS) {
484.             if (result != null && result.getPois() != null && !result.getPois().isEmpty()) {
485.                 // 获取第一个POI点
486.                 PoiItem poi = result.getPois().get(0);
487.                 // 更新目的地信息
488.                 updateDestinationInfo(poi);
489.                 // 移动地图到搜索位置
490.                 moveMapToLocation(poi.getLatLonPoint());
491.                 // 规划路线
492.                 planRouteToDestination(poi.getLatLonPoint());
493.             } else {
494.                 Toast.makeText(this, "未找到相关地点，请尝试其他关键词", Toast.LENGTH_SHORT).show();
495.             }
496.         } else {
497.             String errorMessage;
498.             switch (rCode) {
499.                 case AMapException.CODE_AMAP_ENGINE_RESPONSE_ERROR:
500.                     errorMessage = "服务响应错误";
501.                     break;
502.                 case AMapException.CODE_AMAP_ENGINE_CONNECT_TIMEOUT:
503.                     errorMessage = "连接超时";
504.                     break;
505.                 case AMapException.CODE_AMAP_ENGINE_RETURN_TIMEOUT:
506.                     errorMessage = "请求超时";
507.                     break;
508.                 default:
509.                     errorMessage = "未知错误（错误码：" + rCode + "）";
510.             }
511.             Toast.makeText(this, "搜索失败：" + errorMessage, Toast.LENGTH_SHORT).show();
512.         }
513.     }
515.     @Override
516.     public void onPoiItemSearched(PoiItem poiItem, int rCode) {
517.         // 处理单个POI搜索结果
518.     }
520.     private void updateDestinationInfo(PoiItem poi) {
521.         tvDestination.setText("目的地：" + poi.getTitle());
522.         // 保存目的地信息，用于后续导航
523.         destinationPoint = poi.getLatLonPoint();
524.         // 展开面板
525.         bottomSheetBehavior.setState(BottomSheetBehavior.STATE_EXPANDED);
526.     }
528.     private void moveMapToLocation(LatLonPoint point) {
529.         if (aMap != null) {
530.             // 清除之前的标记
531.             aMap.clear();
532.             // 添加新的标记
533.             LatLng latLng = new LatLng(point.getLatitude(), point.getLongitude());
534.             aMap.addMarker(new MarkerOptions()
535.                     .position(latLng)
536.                     .title("目的地"));
537.             // 移动地图
538.             aMap.animateCamera(CameraUpdateFactory.newLatLngZoom(latLng, 15));
539.         }
540.     }
542.     private void planRouteToDestination(LatLonPoint destination) {
543.         if (aMap.getMyLocation() == null) {
544.             Toast.makeText(this, "无法获取当前位置", Toast.LENGTH_SHORT).show();
545.             return;
546.         }
548.         // 构建导航起终点
549.         List<NaviLatLng> startList = new ArrayList<>();
550.         List<NaviLatLng> endList = new ArrayList<>();
552.         // 起点为当前位置
553.         startList.add(new NaviLatLng(aMap.getMyLocation().getLatitude(),
554.                 aMap.getMyLocation().getLongitude()));
555.         // 终点为搜索的位置
556.         endList.add(new NaviLatLng(destination.getLatitude(),
557.                 destination.getLongitude()));
559.         // 开始算路
560.         mAMapNavi.calculateDriveRoute(startList, endList, null,
561.                 PathPlanningStrategy.DRIVING_DEFAULT);
562.     }
564.     private void drawRouteLine(AMapNaviPath path) {
565.         if (aMap != null) {
566.             // 清除之前的路线
567.             aMap.clear();
568.             // 绘制新路线
569.             AMapNaviPath naviPath = mAMapNavi.getNaviPath();
570.             if (naviPath != null) {
571.                 // 获取路线坐标点
572.                 List<NaviLatLng> coordinates = naviPath.getCoordList();
573.                 if (coordinates != null && coordinates.size() > 0) {
574.                     List<LatLng> latLngs = new ArrayList<>();
575.                     for (NaviLatLng coordinate : coordinates) {
576.                         latLngs.add(new LatLng(coordinate.getLatitude(), coordinate.getLongitude()));
577.                     }
578.                     // 绘制路线
579.                     aMap.addPolyline(new PolylineOptions()
580.                             .addAll(latLngs)
581.                             .width(20)
582.                             .color(Color.BLUE));
583.                     
584.                     // 添加起点和终点标记
585.                     LatLng startPoint = latLngs.get(0);
586.                     LatLng endPoint = latLngs.get(latLngs.size() - 1);
587.                     
588.                     // 添加起点标记
589.                     aMap.addMarker(new MarkerOptions()
590.                             .position(startPoint)
591.                             .title("起点"));
592.                     
593.                     // 添加终点标记
594.                     aMap.addMarker(new MarkerOptions()
595.                             .position(endPoint)
596.                             .title("终点"));
598.                     // 调整地图视野以显示整条路线
599.                     LatLngBounds bounds = new LatLngBounds.Builder()
600.                             .include(startPoint)
601.                             .include(endPoint)
602.                             .build();
603.                     aMap.animateCamera(CameraUpdateFactory.newLatLngBounds(bounds, 100));
604.                 }
605.             }
606.         }
607.     }
609.     private void updateBottomSheetInfo(AMapNaviPath path) {
610.         if (path != null) {
611.             // 更新距离信息（转换为公里）
612.             String distance = String.format("距离：%.1f公里", path.getAllLength() / 1000.0);
613.             tvDistance.setText(distance);
615.             // 更新时间信息（转换为分钟）
616.             String time = String.format("预计用时：%d分钟", path.getAllTime() / 60);
617.             tvTime.setText(time);
619.             // 如果有目的地标记，更新目的地信息
620.             if (destinationMarker != null) {
621.                 String destination = "目的地：" + destinationMarker.getTitle();
622.                 tvDestination.setText(destination);
623.             }
624.         }
625.     }
626. }

复制代码

XML文件

1. <androidx.coordinatorlayout.widget.CoordinatorLayout    xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:app="http://schemas.android.com/apk/res-auto"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:fitsSystemWindows="true"    tools:context=".MainActivity">    <!-- 地图容器 -->    <com.amap.api.maps.MapView        android:id="@+id/map"        android:layout_width="match_parent"        android:layout_height="match_parent" />    <!-- 底部导航面板 -->    <LinearLayout        android:id="@+id/bottom_sheet"        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:background="#F5FFFFFF"        android:orientation="vertical"        android:elevation="8dp"        app:behavior_peekHeight="180dp"        app:behavior_hideable="false"        app:layout_behavior="com.google.android.material.bottomsheet.BottomSheetBehavior">        <!-- 拖动条指示器 -->        <View            android:layout_width="40dp"            android:layout_height="4dp"            android:layout_gravity="center_horizontal"            android:layout_marginTop="8dp"            android:layout_marginBottom="16dp"            android:background="#CCCCCC" />        <!-- 搜索框区域 -->
2.         <LinearLayout
3.             android:layout_width="match_parent"
4.             android:layout_height="wrap_content"
5.             android:orientation="horizontal"
6.             android:padding="8dp"
7.             android:layout_marginHorizontal="16dp"
8.             android:layout_marginBottom="8dp"
9.             android:background="@drawable/search_background"
10.             android:elevation="2dp">
12.             <!-- 搜索图标 -->
13.             <ImageView
14.                 android:id="@+id/search_icon"
15.                 android:layout_width="24dp"
16.                 android:layout_height="24dp"
17.                 android:layout_gravity="center_vertical"
18.                 android:layout_marginStart="8dp"
19.                 android:src="@android:drawable/ic_search_category_default"
20.                 app:tint="#666666" />
22.             <!-- 搜索输入框 -->
23.             <EditText
24.                 android:id="@+id/search_input"
25.                 android:layout_width="0dp"
26.                 android:layout_height="40dp"
27.                 android:layout_weight="1"
28.                 android:background="@null"
29.                 android:hint="搜索目的地"
30.                 android:textColorHint="#999999"
31.                 android:textColor="#333333"
32.                 android:textSize="16sp"
33.                 android:singleLine="true"
34.                 android:imeOptions="actionSearch"
35.                 android:layout_marginStart="8dp"
36.                 android:layout_marginEnd="8dp" />
38.         </LinearLayout>
39.         <!-- 导航信息区域 -->        <LinearLayout            android:layout_width="match_parent"            android:layout_height="wrap_content"            android:orientation="vertical"            android:padding="16dp">            <!-- 目的地信息 -->            <TextView                android:id="@+id/tv_destination"                android:layout_width="match_parent"                android:layout_height="wrap_content"                android:layout_marginBottom="8dp"                android:text="目的地："                android:textColor="#333333"                android:textSize="16sp"                android:textStyle="bold" />            <!-- 距离信息 -->            <TextView                android:id="@+id/tv_distance"                android:layout_width="match_parent"                android:layout_height="wrap_content"                android:layout_marginBottom="8dp"                android:text="距离："                android:textColor="#666666"                android:textSize="16sp" />            <!-- 预计时间 -->            <TextView                android:id="@+id/tv_time"                android:layout_width="match_parent"                android:layout_height="wrap_content"                android:layout_marginBottom="8dp"                android:text="预计时间："                android:textColor="#666666"                android:textSize="16sp" />            <!-- 导航按钮 -->            <Button                android:id="@+id/btn_start_navi"                android:layout_width="match_parent"                android:layout_height="wrap_content"                android:layout_marginTop="16dp"                android:background="@android:color/holo_blue_light"                android:elevation="4dp"                android:padding="12dp"                android:text="开始导航"                android:textColor="#FFFFFF"                android:textSize="16sp" />        </LinearLayout>    </LinearLayout></androidx.coordinatorlayout.widget.CoordinatorLayout>

复制代码

末了实现的效果：

3、处理惩罚偏航

①onReCalculateRouteForYaw 方法（核心偏航处理惩罚方法）

1. @Override
2. public void onReCalculateRouteForYaw() {
3.     // 偏航重新计算路线回调
4.     requireActivity().runOnUiThread(() -> {
5.         String message = "您已偏离规划路线，正在重新规划";
6.         Toast.makeText(requireContext(), message, Toast.LENGTH_SHORT).show();
7.         if (!isMuted && textToSpeech != null) {
8.             textToSpeech.speak(message, TextToSpeech.QUEUE_FLUSH, null, null);
9.         }
10.     });
11. }

复制代码

②、calculateRoute 方法（门路重新规划）

1. private void calculateRoute() {
2.     if (mStartPoint == null) {
3.         // 如果没有起点，使用当前位置
4.         Location location = aMap.getMyLocation();
5.         if (location != null) {
6.             mStartPoint = new LatLng(location.getLatitude(), location.getLongitude());
7.         } else {
8.             Toast.makeText(requireContext(), "无法获取当前位置", Toast.LENGTH_SHORT).show();
9.             return;
10.         }
11.     }
13.     try {
14.         // 清除之前的路线
15.         aMap.clear();
17.         // 准备导航起终点
18.         List<NaviLatLng> startPoints = new ArrayList<>();
19.         startPoints.add(new NaviLatLng(mStartPoint.latitude, mStartPoint.longitude));
20.         List<NaviLatLng> endPoints = new ArrayList<>();
21.         endPoints.add(new NaviLatLng(mEndPoint.latitude, mEndPoint.longitude));
23.         // 根据出行方式计算路线
24.         switch (currentNaviMode) {
25.             case 0: // 驾车
26.                 mAMapNavi.calculateDriveRoute(startPoints, endPoints, null,
27.                     PathPlanningStrategy.DRIVING_DEFAULT);
28.                 break;
29.   
30.         }
31.     } catch (Exception e) {
32.         e.printStackTrace();
33.         Toast.makeText(requireContext(), "路线规划失败：" + e.getMessage(),
34.             Toast.LENGTH_SHORT).show();
35.     }
36. }

复制代码

③、onCalculateRouteSuccess 方法（门路重新规划乐成回调）

1. @Override
2. public void onCalculateRouteSuccess(AMapCalcRouteResult result) {
3.     if (result != null) {
4.         try {
5.             // 清除之前的标记和路线
6.             aMap.clear();
7.             mapPolylines.clear();
9.             // 添加起点和终点标记
10.             if (mStartPoint != null) {
11.                 MarkerOptions startMarker = new MarkerOptions()
12.                     .position(mStartPoint)
13.                     .title("起点")
14.                     .snippet("当前位置")
15.                     .icon(BitmapDescriptorFactory.defaultMarker(
16.                         BitmapDescriptorFactory.HUE_GREEN));
17.                 aMap.addMarker(startMarker);
18.             }
20.             if (mEndPoint != null) {
21.                 MarkerOptions endMarker = new MarkerOptions()
22.                     .position(mEndPoint)
23.                     .title("终点")
24.                     .snippet("目的地")
25.                     .icon(BitmapDescriptorFactory.defaultMarker(
26.                         BitmapDescriptorFactory.HUE_RED));
27.                 aMap.addMarker(endMarker);
28.             }
30.             // 获取所有路线ID并绘制路线
31.             int[] routeIds = result.getRouteid();
32.             if (routeIds != null && routeIds.length > 0) {
33.                 currentRouteIds = routeIds;
34.                 updateRouteOptions();
35.                 drawSelectedRoute();
36.             }
37.         } catch (Exception e) {
38.             e.printStackTrace();
39.             Toast.makeText(requireContext(), "路线显示失败：" + e.getMessage(),
40.                 Toast.LENGTH_SHORT).show();
41.         }
42.     }
43. }

复制代码

④、drawSelectedRoute 方法（绘制新门路）

1. private void drawSelectedRoute() {
2.     try {
3.         // 选择路线
4.         mAMapNavi.selectRouteId(currentRouteIds[selectedRouteIndex]);
6.         // 清除之前的路线
7.         for (Polyline line : mapPolylines) {
8.             line.remove();
9.         }
10.         mapPolylines.clear();
12.         // 获取路线信息
13.         List<NaviLatLng> pathPoints = mAMapNavi.getNaviPath().getCoordList();
15.         if (pathPoints != null && !pathPoints.isEmpty()) {
16.             // 设置路线颜色
17.             int pathColor;
18.             switch (currentNaviMode) {
19.                 case 1: // 步行
20.                     pathColor = Color.GREEN;
21.                     break;
22.             }
24.             // 转换坐标点并绘制路线
25.             List<LatLng> mapPoints = new ArrayList<>();
26.             for (NaviLatLng point : pathPoints) {
27.                 mapPoints.add(new LatLng(point.getLatitude(), point.getLongitude()));
28.             }
30.             // 添加新路线
31.             Polyline polyline = aMap.addPolyline(new PolylineOptions()
32.                 .addAll(mapPoints)
33.                 .width(20)
34.                 .color(pathColor)
35.                 .zIndex(1)
36.                 .setDottedLine(false));
37.             mapPolylines.add(polyline);
39.             // 调整地图视野以显示整条路线
40.             LatLngBounds.Builder builder = new LatLngBounds.Builder();
41.             for (LatLng point : mapPoints) {
42.                 builder.include(point);
43.             }
44.             aMap.animateCamera(CameraUpdateFactory.newLatLngBounds(
45.                 builder.build(), 100));
46.         }
47.     } catch (Exception e) {
48.         e.printStackTrace();
49.         Toast.makeText(requireContext(), "路线绘制失败：" + e.getMessage(),
50.             Toast.LENGTH_SHORT).show();
51.     }
52. }

复制代码

五、其他功能

1、语音播报功能

① TextToSpeech 基本先容与用法

​ TextToSpeech 是 Android 提供的文字转语音引擎，可以将文本转换为语音输出。
1）初始化方式

1. private TextToSpeech textToSpeech;
3. // 方式一：基础初始化
4. textToSpeech = new TextToSpeech(context, new TextToSpeech.OnInitListener() {
5.     @Override
6.     public void onInit(int status) {
7.         if (status == TextToSpeech.SUCCESS) {
8.             // 设置语言
9.             int result = textToSpeech.setLanguage(Locale.CHINESE);
10.             
11.             // 检查语言是否支持
12.             if (result == TextToSpeech.LANG_MISSING_DATA ||
13.                 result == TextToSpeech.LANG_NOT_SUPPORTED) {
14.                 Toast.makeText(context, "语言不支持", Toast.LENGTH_SHORT).show();
15.             }
16.         } else {
17.             Toast.makeText(context, "初始化失败", Toast.LENGTH_SHORT).show();
18.         }
19.     }
20. });
22. // 方式二：Lambda表达式（简化写法）
23. textToSpeech = new TextToSpeech(requireContext(), status -> {
24.     if (status == TextToSpeech.SUCCESS) {
25.         textToSpeech.setLanguage(Locale.CHINESE);
26.     }
27. });

复制代码

2）主要配置方法

1. // 设置语言
2. textToSpeech.setLanguage(Locale.CHINESE);
4. // 设置语速（1.0为正常速度）
5. textToSpeech.setSpeechRate(1.0f);
7. // 设置音调（1.0为正常音调）
8. textToSpeech.setPitch(1.0f);
10. // 设置音量（0.0-1.0）
11. textToSpeech.setVolume(1.0f);
13. // 设置音频流类型
14. textToSpeech.setAudioAttributes(new AudioAttributes.Builder()
15.     .setUsage(AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE)
16.     .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
17.     .build());

复制代码

3）语音播报方法

1. // 1. 基本播报方法
2. textToSpeech.speak(
3.     "要播报的文本",           // 文本内容
4.     TextToSpeech.QUEUE_FLUSH, // 播报模式
5.     null,                    // Bundle参数
6.     "utteranceId"           // 话语ID
7. );
9. // 2. 立即播报（清除队列）
10. textToSpeech.speak(
11.     "紧急提示信息",
12.     TextToSpeech.QUEUE_FLUSH,
13.     null,
14.     null
15. );
17. // 3. 加入播报队列
18. textToSpeech.speak(
19.     "普通提示信息",
20.     TextToSpeech.QUEUE_ADD,
21.     null,
22.     null
23. );
25. // 4. 带参数的播报
26. Bundle params = new Bundle();
27. params.putFloat(TextToSpeech.Engine.KEY_PARAM_VOLUME, 0.8f);
28. params.putFloat(TextToSpeech.Engine.KEY_PARAM_PITCH, 1.2f);
29. textToSpeech.speak(
30.     "自定义参数播报",
31.     TextToSpeech.QUEUE_FLUSH,
32.     params,
33.     "customId"
34. );

复制代码

4）播报状态监听

1. textToSpeech.setOnUtteranceProgressListener(new UtteranceProgressListener() {
2.     @Override
3.     public void onStart(String utteranceId) {
4.         // 开始播报
5.     }
7.     @Override
8.     public void onDone(String utteranceId) {
9.         // 播报完成
10.     }
12.     @Override
13.     public void onError(String utteranceId) {
14.         // 播报错误
15.     }
16. });

复制代码

5）权限要求

1. <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>

复制代码

②使用示例（步骤分析）

1). 初始化语音体系

1. // 在类成员变量中声明
2. private TextToSpeech textToSpeech;
4. // 在 onCreateView 中初始化
5. textToSpeech = new TextToSpeech(requireContext(), status -> {
6.     if (status == TextToSpeech.SUCCESS) {
7.         // 设置语音为中文
8.         textToSpeech.setLanguage(Locale.CHINESE);
9.     }
10. });

复制代码

2).导航语音播报实现

1. //开始导航
2. private void startNavi() {
3.     if (mStartPoint == null || mEndPoint == null) {
4.         Toast.makeText(requireContext(), "请先规划路线", Toast.LENGTH_SHORT).show();
5.         return;
6.     }
8.     try {
9.         mAMapNavi.selectRouteId(currentRouteIds[selectedRouteIndex]);
10.         mAMapNavi.startNavi(NaviType.GPS);
11.         isNavigating = true;
12.         updateNavigationButtons(true);
13.         showNavigationInfoPanel();
15.         // 这里可以添加开始导航的语音提示
16.         if (!isMuted && textToSpeech != null) {
17.             textToSpeech.speak("开始导航", TextToSpeech.QUEUE_FLUSH, null, null);
18.         }
19.         
20.         // ... 其他代码
21.     } catch (Exception e) {
22.         e.printStackTrace();
23.     }
24. }
27. //导航过程中的语音提示：
28. @Override
29. public void onGetNavigationText(String text) {
30.     try {
31.         // 这是导航过程中的语音播报核心方法
32.         if (!isMuted && textToSpeech != null && text != null) {
33.             textToSpeech.speak(text, TextToSpeech.QUEUE_FLUSH, null, null);
34.         }
35.     } catch (Exception e) {
36.         e.printStackTrace();
37.     }
38. }
39. @Override
40. public void onGetNavigationText(int type, String text) {
41.     onGetNavigationText(text);
42. }
45. // 到达目的地提醒
46. @Override
47. public void onArriveDestination() {
48.     String message = "已到达目的地，本次导航结束";
49.     Toast.makeText(requireContext(), message, Toast.LENGTH_LONG).show();
50.     // 播放语音提醒
51.     if (!isMuted && textToSpeech != null) {
52.         textToSpeech.speak(message, TextToSpeech.QUEUE_FLUSH, null, null);
53.     }
54.     // 震动提醒
55.     if (ContextCompat.checkSelfPermission(requireContext(),
56.         android.Manifest.permission.VIBRATE) == PackageManager.PERMISSION_GRANTED) {
57.         android.os.Vibrator vibrator = (android.os.Vibrator)
58.             requireContext().getSystemService(Context.VIBRATOR_SERVICE);
59.         if (vibrator != null && vibrator.hasVibrator()) {
60.             vibrator.vibrate(500); // 震动500毫秒
61.         }
62.     }
63. }

复制代码

3). 特殊情况的语音提醒(按需选择)

2. // 偏航重新规划提醒
3. @Override
4. public void onReCalculateRouteForYaw() {
5.     requireActivity().runOnUiThread(() -> {
6.         String message = "您已偏离规划路线，正在重新规划";
7.         Toast.makeText(requireContext(), message, Toast.LENGTH_SHORT).show();
8.         if (!isMuted && textToSpeech != null) {
9.             textToSpeech.speak(message, TextToSpeech.QUEUE_FLUSH, null, null);
10.         }
11.     });
12. }
14. // 拥堵重新规划提醒
15. @Override
16. public void onReCalculateRouteForTrafficJam() {
17.     requireActivity().runOnUiThread(() -> {
18.         String message = "前方道路拥堵，正在重新规划路线";
19.         Toast.makeText(requireContext(), message, Toast.LENGTH_LONG).show();
20.         if (!isMuted && textToSpeech != null) {
21.             textToSpeech.speak(message, TextToSpeech.QUEUE_FLUSH, null, null);
22.         }
23.     });
24. }

复制代码

4). 交通办法语音提醒

1. @Override
2. public void OnUpdateTrafficFacility(AMapNaviTrafficFacilityInfo facility) {
3.     if (facility == null || !isTrafficEnabled) return;
5.     String message = "";
6.     switch (facility.getBroadcastType()) {
7.         case 0:  // 测速摄像头
8.             message = String.format("前方%d米有测速摄像头，限速%d公里/小时",
9.                 facility.getDistance(), facility.getLimitSpeed());
10.             break;
11.         case 1:  // 监控摄像头
12.             message = String.format("前方%d米有监控摄像头",
13.                 facility.getDistance());
14.             break;
15.         case 2:  // 事故
16.             message = String.format("前方%d米发生交通事故，请谨慎驾驶",
17.                 facility.getDistance());
18.             break;
19.         case 3:  // 施工
20.             message = String.format("前方%d米正在施工，请减速慢行",
21.                 facility.getDistance());
22.             break;
23.         case 4:  // 交通拥堵
24.             message = String.format("前方%d米出现拥堵，建议绕行",
25.                 facility.getDistance());
26.             break;
27.     }
29.     if (!TextUtils.isEmpty(message)) {
30.         final String finalMessage = message;
31.         requireActivity().runOnUiThread(() -> {
32.             // 显示提示信息
33.             Toast.makeText(requireContext(), finalMessage, Toast.LENGTH_LONG).show();
35.             // 播放语音提醒
36.             if (!isMuted && textToSpeech != null) {
37.                 textToSpeech.speak(finalMessage, TextToSpeech.QUEUE_ADD, null, null);
38.             }
39.         });
40.     }
41. }

复制代码

5). 速率超限提醒

1. private void showSpeedWarning(int currentSpeed) {
2.     String speedWarning = String.format("当前速度%d公里/小时，请注意行车安全",
3.         currentSpeed);
4.     Toast.makeText(requireContext(), speedWarning, Toast.LENGTH_SHORT).show();
5.     if (!isMuted && textToSpeech != null) {
6.         textToSpeech.speak("您的车速较快，请注意行车安全",
7.             TextToSpeech.QUEUE_ADD, null, null);
8.     }
9. }

复制代码

6). 资源释放

1. @Override
2. public void onDestroy() {
3.     super.onDestroy();
4.     if (textToSpeech != null) {
5.         textToSpeech.stop();    // 停止播报
6.         textToSpeech.shutdown(); // 关闭引擎
7.     }
8. }

复制代码

2、实时路况监控

①路况开关控制

1. //MainActivity
2. private ImageButton btnTraffic;
3.     private boolean isTrafficEnabled = true;  // 默认开启实时路况
5. // 初始化实时路况按钮
6.         btnTraffic = rootView.findViewById(R.id.btn_traffic);
9. // 实时路况按钮点击事件
10. btnTraffic.setOnClickListener(v -> {
11.     isTrafficEnabled = !isTrafficEnabled;
12.     aMap.setTrafficEnabled(isTrafficEnabled);  // 设置地图是否显示实时路况
13.     updateTrafficButton();
15.     // 显示提示
16.     String message = isTrafficEnabled ? "已开启实时路况" : "已关闭实时路况";
17.     Toast.makeText(requireContext(), message, Toast.LENGTH_SHORT).show();
18. });
20. // 更新路况按钮状态
21. private void updateTrafficButton() {
22.     btnTraffic.setSelected(isTrafficEnabled);
23.     btnTraffic.setAlpha(isTrafficEnabled ? 1.0f : 0.5f);
24. }

复制代码

XML文件

1. <!-- 实时路况按钮 -->
2. <ImageButton
3.     android:id="@+id/btn_traffic"
4.     android:layout_width="40dp"
5.     android:layout_height="40dp"
6.     android:layout_margin="8dp"
7.     android:background="@drawable/bg_map_button"
8.     android:contentDescription="@string/traffic_button"
9.     android:src="@drawable/ic_traffic" />

复制代码

按钮样式： res/drawable/bg_map_button.xml

1. <?xml version="1.0" encoding="utf-8"?>
2. <selector xmlns:android="http://schemas.android.com/apk/res/android">
3.     <item android:state_pressed="true">
4.         <shape android:shape="oval">
5.             <solid android:color="#E0E0E0" />
6.         </shape>
7.     </item>
8.     <item android:state_selected="true">
9.         <shape android:shape="oval">
10.             <solid android:color="#E3F2FD" />
11.         </shape>
12.     </item>
13.     <item>
14.         <shape android:shape="oval">
15.             <solid android:color="#FFFFFF" />
16.         </shape>
17.     </item>
18. </selector>

复制代码

路况图标样式：res/drawable/ic_traffic.xml

1. <?xml version="1.0" encoding="utf-8"?>
2. <selector xmlns:android="http://schemas.android.com/apk/res/android">
3.     <item android:state_selected="true"
4.         android:drawable="@drawable/ic_traffic_on" />
5.     <item
6.         android:drawable="@drawable/ic_traffic_off" />
7. </selector>

复制代码

字符串资源：在values/strings

1. <string name="traffic_button">实时路况</string>

复制代码

②路况状态更新

1. @Override
2. public void onTrafficStatusUpdate() {
3.     // 路况更新时的处理
4.     if (isTrafficEnabled) {
5.         requireActivity().runOnUiThread(() -> {
6.             // 可以在这里更新UI
7.         });
8.     }
9. }
11. @Override
12. public void onNaviInfoUpdate(NaviInfo naviInfo) {
13.     if (isNavigating && navigationInfoPanel.getVisibility() == View.VISIBLE && naviInfo != null) {
14.         requireActivity().runOnUiThread(() -> {
15.             // 更新路况状态（根据当前速度判断）
16.             int currentSpeed = naviInfo.getCurrentSpeed();
17.             String trafficText;
18.             int trafficColor;
20.             // 根据当前速度判断路况状态
21.             if (currentSpeed < 15) { // 低于15km/h认为是拥堵
22.                 trafficText = "拥堵";
23.                 trafficColor = Color.parseColor("#F44336"); // 红色
24.             } else if (currentSpeed < 30) { // 低于30km/h认为是缓行
25.                 trafficText = "缓行";
26.                 trafficColor = Color.parseColor("#FF9800"); // 橙色
27.             } else { // 高于30km/h认为是畅通
28.                 trafficText = "畅通";
29.                 trafficColor = Color.parseColor("#4CAF50"); // 绿色
30.             }
32.             tvTrafficStatus.setText("当前路况：" + trafficText);
33.             tvTrafficStatus.setTextColor(trafficColor);
34.         });
35.     }
36. }

复制代码

③拥堵重新规划

1. @Override
2. public void onReCalculateRouteForTrafficJam() {
3.     requireActivity().runOnUiThread(() -> {
4.         String message = "前方道路拥堵，正在重新规划路线";
5.         Toast.makeText(requireContext(), message, Toast.LENGTH_LONG).show();
6.         if (!isMuted && textToSpeech != null) {
7.             textToSpeech.speak(message, TextToSpeech.QUEUE_FLUSH, null, null);
8.         }
9.     });
10. }

复制代码

3、安全提醒体系

①OnUpdateTrafficFacility 方法（交通办法安全提醒）

1. @Override
2. public void OnUpdateTrafficFacility(AMapNaviTrafficFacilityInfo[] facilities) {
3.     // 批量交通设施提醒
4.     if (facilities == null || facilities.length == 0 || !isTrafficEnabled) return;
6.     for (AMapNaviTrafficFacilityInfo facility : facilities) {
7.         String message = "";
8.         switch (facility.getBroadcastType()) {
9.             case 0:  // 测速摄像头
10.                 message = String.format("前方%d米有测速摄像头，限速%d公里/小时",
11.                     facility.getDistance(), facility.getLimitSpeed());
12.                 break;
13.             case 1:  // 监控摄像头
14.                 message = String.format("前方%d米有监控摄像头", facility.getDistance());
15.                 break;
16.             case 2:  // 事故
17.                 message = String.format("前方%d米发生交通事故，请谨慎驾驶", facility.getDistance());
18.                 break;
19.             case 3:  // 施工
20.                 message = String.format("前方%d米正在施工，请减速慢行", facility.getDistance());
21.                 break;
22.             case 4:  // 交通拥堵
23.                 message = String.format("前方%d米出现拥堵，建议绕行", facility.getDistance());
24.                 break;
25.         }
27.         // 发送提醒
28.         if (!TextUtils.isEmpty(message)) {
29.             final String finalMessage = message;
30.             requireActivity().runOnUiThread(() -> {
31.                 // 显示提示信息
32.                 Toast.makeText(requireContext(), finalMessage, Toast.LENGTH_LONG).show();
33.                 // 语音播报
34.                 if (!isMuted && textToSpeech != null) {
35.                     textToSpeech.speak(finalMessage, TextToSpeech.QUEUE_ADD, null, null);
36.                 }
37.             });
38.         }
39.     }
40. }

复制代码

②onNaviInfoUpdate 方法中的速率监控

1. @Override
2. public void onNaviInfoUpdate(NaviInfo naviInfo) {
3.     if (isNavigating && navigationInfoPanel.getVisibility() == View.VISIBLE && naviInfo != null) {
4.         requireActivity().runOnUiThread(() -> {
5.             // ... 其他代码 ...
7.             // 速度监控
8.             int currentSpeed = naviInfo.getCurrentSpeed();
9.             if (currentSpeed > 80) {
10.                 String speedWarning = String.format("当前速度%d公里/小时，请注意行车安全",
11.                     currentSpeed);
12.                 Toast.makeText(requireContext(), speedWarning, Toast.LENGTH_SHORT).show();
13.                 if (!isMuted && textToSpeech != null) {
14.                     textToSpeech.speak("您的车速较快，请注意行车安全",
15.                         TextToSpeech.QUEUE_ADD, null, null);
16.                 }
17.             }
18.         });
19.     }
20. }

复制代码

③getWarningMessage 方法（气候安全提醒）

1. private String getWarningMessage(String weatherType) {
2.     if (weatherType.contains("雨")) {
3.         return "注意：当前降雨可能影响出行安全，请携带雨具，谨慎驾驶。";
4.     } else if (weatherType.contains("雪")) {
5.         return "注意：当前降雪可能导致路面结冰，建议减少出行。";
6.     } else if (weatherType.contains("雾")) {
7.         return "注意：空气质量较差，建议戴口罩出行。";
8.     } else if (weatherType.contains("霾")) {
9.         return "注意：空气质量较差，建议戴口罩出行。";
10.     }
11.     return "";
12. }

复制代码

4、气候信息和预警

①获取高德气候服务KEY

大要的流程与上面获取高德地图KEY相同，只有一些渺小的差别：

将获取的KEY复制到AndroidManifest里

②调用气候服务的方法

1）updateWeatherInfo 方法（核心方法）

1. private void updateWeatherInfo(LatLng destination) {
2.     try {
3.         // 清除旧的天气信息
4.         clearWeatherInfo();
6.         // 计算并显示距离
7.         float distance = calculateDistance(null, destination);
8.         if (distance > 0) {
9.             final float finalDistance = distance;
10.             requireActivity().runOnUiThread(() -> {
11.                 tvDistance.setText(String.format("距离: %.1fkm", finalDistance));
12.             });
13.         }
15.         // 使用逆地理编码获取城市名称
16.         GeocodeSearch geocodeSearch = new GeocodeSearch(requireContext());
17.         geocodeSearch.setOnGeocodeSearchListener(new GeocodeSearch.OnGeocodeSearchListener() {
18.             @Override
19.             public void onRegeocodeSearched(RegeocodeResult result, int rCode) {
20.                 if (rCode == AMapException.CODE_AMAP_SUCCESS) {
21.                     // 获取城市名称
22.                     String city = result.getRegeocodeAddress().getCity();
23.                     if (TextUtils.isEmpty(city)) {
24.                         city = result.getRegeocodeAddress().getDistrict();
25.                     }
27.                     // 使用城市名称查询天气
28.                     WeatherSearchQuery query = new WeatherSearchQuery(
29.                         city,
30.                         WeatherSearchQuery.WEATHER_TYPE_LIVE
31.                     );
32.                     WeatherSearch weatherSearch = new WeatherSearch(requireContext());
33.                     weatherSearch.setOnWeatherSearchListener(NavigationFragment.this);
34.                     weatherSearch.setQuery(query);
35.                     weatherSearch.searchWeatherAsyn();
36.                 }
37.             }
38.         });
39.     } catch (Exception e) {
40.         e.printStackTrace();
41.     }
42. }

复制代码

2）onWeatherLiveSearched 方法（气候查询回调）

1. @Override
2. public void onWeatherLiveSearched(LocalWeatherLiveResult weatherLiveResult, int rCode) {
3.     requireActivity().runOnUiThread(() -> {
4.         if (rCode == AMapException.CODE_AMAP_SUCCESS) {
5.             LocalWeatherLive weatherLive = weatherLiveResult.getLiveResult();
6.             
7.             // 更新天气信息UI
8.             tvWeather.setText(String.format("%s %s°C",
9.                 weatherLive.getWeather(),
10.                 weatherLive.getTemperature()));
11.             tvHumidity.setText(weatherLive.getHumidity() + "%");
12.             tvWind.setText(String.format("%s风 %s级",
13.                 weatherLive.getWindDirection(),
14.                 weatherLive.getWindPower()));
16.             // 更新空气质量
17.             String airQuality = getAirQualityByWeather(weatherLive.getWeather());
18.             tvAqi.setText("空气质量：" + airQuality);
19.             tvAqi.setTextColor(getAirQualityColor(airQuality));
21.             // 更新天气图标
22.             updateWeatherIcon(weatherLive.getWeather());
24.             // 生成出行建议
25.             String recommendation = generateRecommendation(
26.                 weatherLive.getWeather(),
27.                 calculateDistance(mStartPoint, mEndPoint)
28.             );
29.             tvRecommendation.setText(recommendation);
31.             // 显示天气警告
32.             if (shouldShowWarning(weatherLive.getWeather())) {
33.                 tvWeatherWarning.setVisibility(View.VISIBLE);
34.                 tvWeatherWarning.setText(getWarningMessage(weatherLive.getWeather()));
35.             }
36.         }
37.     });
38. }

复制代码

3）getAirQualityByWeather 方法（获取氛围质量）

1. private String getAirQualityByWeather(String weather) {
2.     if (weather.contains("霾") || weather.contains("沙尘")) {
3.         return "重度污染";
4.     } else if (weather.contains("雾")) {
5.         return "中度污染";
6.     } else if (weather.contains("阴") || weather.contains("多云")) {
7.         return "良";
8.     } else if (weather.contains("雨") || weather.contains("雪")) {
9.         return "良";
10.     } else if (weather.contains("晴")) {
11.         return "优";
12.     } else {
13.         return "良";
14.     }
15. }
17. //获取空气质量对应颜色
18. private int getAirQualityColor(String quality) {
19.     switch (quality) {
20.         case "优":
21.             return Color.parseColor("#00C853");
22.         case "良":
23.             return Color.parseColor("#FFB300");
24.         case "轻度污染":
25.             return Color.parseColor("#FB8C00");
26.         case "中度污染":
27.             return Color.parseColor("#F4511E");
28.         case "重度污染":
29.             return Color.parseColor("#C62828");
30.         case "严重污染":
31.             return Color.parseColor("#6A1B9A");
32.         default:
33.             return Color.GRAY;
34.     }
35. }

复制代码

4）clearWeatherInfo 方法（扫除气候信息）

1. private void clearWeatherInfo() {
2.     requireActivity().runOnUiThread(() -> {
3.         if (tvWeather != null) tvWeather.setText("正在获取天气...");
4.         if (tvHumidity != null) tvHumidity.setText("");
5.         if (tvWind != null) tvWind.setText("");
6.         if (tvDistance != null) tvDistance.setText("");
7.         if (tvRecommendation != null) tvRecommendation.setText("");
8.         if (tvWeatherWarning != null) {
9.             tvWeatherWarning.setText("");
10.             tvWeatherWarning.setVisibility(View.GONE);
11.         }
12.     });
13. }

复制代码

上述只是调用气候服务的方法，你还要创建一个显示气候信息的结构weather_info，例如：

1.     <!-- 天气信息卡片 -->
2.     <androidx.cardview.widget.CardView
3.         android:layout_width="match_parent"
4.         android:layout_height="wrap_content"
5.         android:layout_marginBottom="16dp"
6.         app:cardCornerRadius="12dp"
7.         app:cardElevation="2dp">
9.         <LinearLayout
10.             android:layout_width="match_parent"
11.             android:layout_height="wrap_content"
12.             android:orientation="vertical"
13.             android:padding="16dp">
15.             <LinearLayout
16.                 android:layout_width="match_parent"
17.                 android:layout_height="wrap_content"
18.                 android:orientation="horizontal"
19.                 android:gravity="center_vertical">
21.                 <ImageView
22.                     android:id="@+id/weather_icon"
23.                     android:layout_width="48dp"
24.                     android:layout_height="48dp"
25.                     android:src="@drawable/ic_weather_sunny"/>
27.                 <LinearLayout
28.                     android:layout_width="0dp"
29.                     android:layout_height="wrap_content"
30.                     android:layout_weight="1"
31.                     android:layout_marginStart="16dp"
32.                     android:orientation="vertical">
34.                     <TextView
35.                         android:id="@+id/tv_destination"
36.                         android:layout_width="wrap_content"
37.                         android:layout_height="wrap_content"
38.                         android:textSize="16sp"
39.                         android:textColor="#333333"
40.                         android:textStyle="bold"
41.                         android:text="目的地"/>
43.                     <TextView
44.                         android:id="@+id/tv_weather"
45.                         android:layout_width="wrap_content"
46.                         android:layout_height="wrap_content"
47.                         android:layout_marginTop="4dp"
48.                         android:textSize="14sp"
49.                         android:textColor="#666666"
50.                         android:text="晴天 26°C"/>
51.                 </LinearLayout>
53.                 <TextView
54.                     android:id="@+id/tv_distance"
55.                     android:layout_width="wrap_content"
56.                     android:layout_height="wrap_content"
57.                     android:textSize="14sp"
58.                     android:textColor="#2196F3"
59.                     android:text="距离: 5.2km"/>
60.             </LinearLayout>
62.             <View
63.                 android:layout_width="match_parent"
64.                 android:layout_height="1dp"
65.                 android:layout_marginTop="12dp"
66.                 android:layout_marginBottom="12dp"
67.                 android:background="#E0E0E0"/>
69.             <LinearLayout
70.                 android:layout_width="match_parent"
71.                 android:layout_height="wrap_content"
72.                 android:orientation="horizontal">
74.                 <LinearLayout
75.                     android:layout_width="0dp"
76.                     android:layout_height="wrap_content"
77.                     android:layout_weight="1"
78.                     android:orientation="vertical"
79.                     android:gravity="center">
81.                     <TextView
82.                         android:id="@+id/tv_humidity"
83.                         android:layout_width="wrap_content"
84.                         android:layout_height="wrap_content"
85.                         android:textSize="14sp"
86.                         android:textColor="#333333"
87.                         android:text="湿度"/>
89.                     <TextView
90.                         android:layout_width="wrap_content"
91.                         android:layout_height="wrap_content"
92.                         android:layout_marginTop="4dp"
93.                         android:textSize="12sp"
94.                         android:textColor="#666666"
95.                         android:text="65%"/>
96.                 </LinearLayout>
98.                 <LinearLayout
99.                     android:layout_width="0dp"
100.                     android:layout_height="wrap_content"
101.                     android:layout_weight="1"
102.                     android:orientation="vertical"
103.                     android:gravity="center">
105.                     <TextView
106.                         android:id="@+id/tv_wind"
107.                         android:layout_width="wrap_content"
108.                         android:layout_height="wrap_content"
109.                         android:textSize="14sp"
110.                         android:textColor="#333333"
111.                         android:text="风速"/>
113.                     <TextView
114.                         android:layout_width="wrap_content"
115.                         android:layout_height="wrap_content"
116.                         android:layout_marginTop="4dp"
117.                         android:textSize="12sp"
118.                         android:textColor="#666666"
119.                         android:text="3级"/>
120.                 </LinearLayout>
122.                 <LinearLayout
123.                     android:layout_width="0dp"
124.                     android:layout_height="wrap_content"
125.                     android:layout_weight="1"
126.                     android:orientation="vertical"
127.                     android:gravity="center">
129.                     <TextView
130.                         android:id="@+id/tv_aqi"
131.                         android:layout_width="wrap_content"
132.                         android:layout_height="wrap_content"
133.                         android:textSize="14sp"
134.                         android:textColor="#333333"
135.                         android:text="空气质量：优"/>
137.                 </LinearLayout>
138.             </LinearLayout>
139.         </LinearLayout>
140.     </androidx.cardview.widget.CardView>

复制代码

对控件进行初始化：

1. // 在 onCreateView 方法中初始化天气信息相关的控件
2. View weatherInfo = rootView.findViewById(R.id.weather_info);
3. weatherIcon = weatherInfo.findViewById(R.id.weather_icon);
4. tvDestination = weatherInfo.findViewById(R.id.tv_destination);
5. tvWeather = weatherInfo.findViewById(R.id.tv_weather);
6. tvDistance = weatherInfo.findViewById(R.id.tv_distance);
7. tvHumidity = weatherInfo.findViewById(R.id.tv_humidity);
8. tvWind = weatherInfo.findViewById(R.id.tv_wind);
9. tvAqi = weatherInfo.findViewById(R.id.tv_aqi);

复制代码

气候信息面板的显示控制

1. View weatherInfo = rootView.findViewById(R.id.weather_info);
2.     weatherInfo.setVisibility(View.VISIBLE);  // 显示天气
3.    //  weatherInfo.setVisibility(View.GONE);  // 隐藏天气

复制代码

5、智能出行建议

①、generateRecommendation 方法（核心方法）

1. private String generateRecommendation(String weatherType, float distance) {
2.     // 根据天气类型给出建议
3.     if (weatherType.contains("暴雨") || weatherType.contains("大雨") || weatherType.contains("雷")) {
4.         return "当前天气恶劣，建议选择驾车出行或推迟行程，注意道路积水和打滑。";
5.     } else if (weatherType.contains("中雨") || weatherType.contains("小雨")) {
6.         return "当前有降雨，建议携带雨具，选择驾车出行较为安全。";
7.     } else if (weatherType.contains("雪")) {
8.         return "当前降雪天气，路面可能结冰，建议驾车出行并保持低速行驶。";
9.     } else if (weatherType.contains("雾") || weatherType.contains("霾")) {
10.         return "当前能见度较低，建议戴好防护口罩，驾车出行时开启雾灯并保持安全车距。";
11.     }
12.    
13.     // 根据天气和距离组合给出建议
14.     else if (weatherType.contains("阴")) {
15.         if (distance > 5) {
16.             return "天气阴沉，距离较远，建议驾车出行。";
17.         } else if (distance > 2) {
18.             return "虽然天气阴沉，但温度适宜，可以考虑骑行或步行。";
19.         } else {
20.             return "距离较近，阴天适合运动，建议步行前往。";
21.         }
22.     } else if (weatherType.contains("晴")) {
23.         if (distance > 5) {
24.             return "天气晴朗，但距离较远，建议驾车出行。";
25.         } else if (distance > 2) {
26.             return "阳光明媚，距离适中，非常适合骑行，记得防晒。";
27.         } else {
28.             return "天气晴好，距离不远，建议步行，享受阳光。";
29.         }
30.     } else if (weatherType.contains("多云")) {
31.         if (distance > 5) {
32.             return "天气较好，但距离较远，建议驾车出行。";
33.         } else if (distance > 2) {
34.             return "云朵遮阳，温度舒适，是骑行的好天气。";
35.         } else {
36.             return "天气舒适，距离不远，非常适合步行。";
37.         }
38.     }
39.    
40.     // 默认建议
41.     if (distance > 5) {
42.         return "距离较远，建议选择驾车出行。";
43.     } else if (distance > 2) {
44.         return "距离适中，可以考虑骑行方式。";
45.     } else {
46.         return "距离较近，建议步行前往。";
47.     }
48. }

复制代码

②、calculateDistance 方法（盘算距离）

1. private float calculateDistance(LatLng start, LatLng end) {
2.     try {
3.         if (end == null) {
4.             return 0;
5.         }
7.         // 获取当前位置作为起点
8.         Location currentLocation = aMap.getMyLocation();
9.         if (currentLocation == null) {
10.             if (start == null) {
11.                 return 0;
12.             }
13.         } else {
14.             // 使用当前实际位置作为起点
15.             start = new LatLng(currentLocation.getLatitude(), currentLocation.getLongitude());
16.         }
18.         // 计算距离
19.         if (start != null && end != null) {
20.             float distance = AMapUtils.calculateLineDistance(start, end);
21.             return distance / 1000.0f; // 转换为公里
22.         }
23.         return 0;
24.     } catch (Exception e) {
25.         e.printStackTrace();
26.         return 0;
27.     }
28. }

复制代码

③、onWeatherLiveSearched 方法中的智能建议部分

1. @Override
2. public void onWeatherLiveSearched(LocalWeatherLiveResult weatherLiveResult, int rCode) {
3.     requireActivity().runOnUiThread(() -> {
4.         if (rCode == AMapException.CODE_AMAP_SUCCESS) {
5.             LocalWeatherLive weatherLive = weatherLiveResult.getLiveResult();
6.             
7.             // 生成出行建议
8.             String recommendation = generateRecommendation(
9.                 weatherLive.getWeather(),
10.                 calculateDistance(mStartPoint, mEndPoint)
11.             );
12.             tvRecommendation.setText(recommendation);
14.             // 更新推荐的出行方式
15.             updateRecommendedMode(weatherLive.getWeather(),
16.                 calculateDistance(mStartPoint, mEndPoint));
17.         }
18.     });
19. }

复制代码

总结：

上述的方法与代码仅供参考，当然这个项目并不完善，能修改的地方尚有很多，例如：我们还可以添加一个出行方式的选择，驾车、骑车、步行、公交等等，由于篇幅有限这里就不赘述了。
} else if (weatherType.contains(“晴”)) {
if (distance > 5) {
return “气候晴朗，但距离较远，建议驾车出行。”;
} else if (distance > 2) {
return “阳光妖冶，距离适中，非常得当骑行，记得防晒。”;
} else {
return “气候晴好，距离不远，建议步行，享受阳光。”;
}
} else if (weatherType.contains(“多云”)) {
if (distance > 5) {
return “气候较好，但距离较远，建议驾车出行。”;
} else if (distance > 2) {
return “云朵遮阳，温度舒适，是骑行的好气候。”;
} else {
return “气候舒适，距离不远，非常得当步行。”;
}
}

1. // 默认建议
2. if (distance > 5) {
3.     return "距离较远，建议选择驾车出行。";
4. } else if (distance > 2) {
5.     return "距离适中，可以考虑骑行方式。";
6. } else {
7.     return "距离较近，建议步行前往。";
8. }

复制代码

}

1. ##### ②、calculateDistance 方法（盘算距离）```Javaprivate float calculateDistance(LatLng start, LatLng end) {
2.     try {
3.         if (end == null) {
4.             return 0;
5.         }
7.         // 获取当前位置作为起点
8.         Location currentLocation = aMap.getMyLocation();
9.         if (currentLocation == null) {
10.             if (start == null) {
11.                 return 0;
12.             }
13.         } else {
14.             // 使用当前实际位置作为起点
15.             start = new LatLng(currentLocation.getLatitude(), currentLocation.getLongitude());
16.         }
18.         // 计算距离
19.         if (start != null && end != null) {
20.             float distance = AMapUtils.calculateLineDistance(start, end);
21.             return distance / 1000.0f; // 转换为公里
22.         }
23.         return 0;
24.     } catch (Exception e) {
25.         e.printStackTrace();
26.         return 0;
27.     }
28. }

复制代码

③、onWeatherLiveSearched 方法中的智能建议部分

1. @Override
2. public void onWeatherLiveSearched(LocalWeatherLiveResult weatherLiveResult, int rCode) {
3.     requireActivity().runOnUiThread(() -> {
4.         if (rCode == AMapException.CODE_AMAP_SUCCESS) {
5.             LocalWeatherLive weatherLive = weatherLiveResult.getLiveResult();
6.             
7.             // 生成出行建议
8.             String recommendation = generateRecommendation(
9.                 weatherLive.getWeather(),
10.                 calculateDistance(mStartPoint, mEndPoint)
11.             );
12.             tvRecommendation.setText(recommendation);
14.             // 更新推荐的出行方式
15.             updateRecommendedMode(weatherLive.getWeather(),
16.                 calculateDistance(mStartPoint, mEndPoint));
17.         }
18.     });
19. }

复制代码

总结：

上述的方法与代码仅供参考，当然这个项目并不完善，能修改的地方尚有很多，例如：我们还可以添加一个出行方式的选择，驾车、骑车、步行、公交等等，由于篇幅有限这里就不赘述了。
通过这个项目，对于高德地图SDK的使用，气候服务和数据处理惩罚，Android生命周期管理，异步编程和线程处理惩罚，错误处理惩罚和异常管理都有不小的劳绩，对于这些不认识的可以跟着做一下。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。