（一）高德地图之基本属性以及显示模式

我们在开发中常常会用到地图功能，那么我们最常用的就是百度地图和高德地图了，今天我们就来看一下高德地图怎么用，我个人认为高德地图封装的还是比较好的，使用起来方便快捷。

首先我们需要到高德开发者平台注册账号，根据API进行操作即可，高德开放平台链接我放在下面：

https://lbs.amap.com/api/android-sdk/summary/

下面主要介绍我个人开发使习惯用的步骤，仅供参考

一、首先是开发前的准备工作，配置工程

1、在高德开放平台下载SDK；

2、添加jar文件：将下载的SDK的jar包复制到工程的libs目录下；

3、添加so库：在main目录下创建文件夹jniLibs（如果有就不需要创建了），将下载的so库复制到这个目录即可；

4、在Project的build.gradle文件中配置repositories，添加maven或jcenter仓库地址

Android Studio默认会在Project的build.gradle为所有module自动添加jcenter的仓库地址，如果已存在，则不需要重复添加。

配置如下：

allprojects {
    repositories {
        jcenter() // 或者 mavenCentral()
    }
 }

5、为了保证高德 Android SDK 的功能正常使用，您需要申请高德 Key 并且配置到项目中。

项目的 “AndroidManifest.xml” 文件中，添加如下代码：

<application
         android:icon="@drawable/icon"
         android:label="@string/app_name" >
         <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="请输入您的用户Key"/>
            ……
</application>

6、配置权限

在AndroidManifest.xml中配置权限:

//地图包、搜索包需要的基础权限
<!--允许程序打开网络套接字-->
<uses-permission android:name="android.permission.INTERNET" />  
<!--允许程序设置内置sd卡的写权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />    
<!--允许程序获取网络状态-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> 
<!--允许程序访问WiFi网络信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 
<!--允许程序读写手机状态和身份-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />     
<!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

二、工程配置完成，接下来我们进入开发阶段

1、建立.xml布局文件activity_showmap

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.amap.api.maps.MapView
        android:id="@+id/map"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
    <LinearLayout
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_margin="20dp"
        android:orientation="vertical">

        <Button
            android:id="@+id/btn_NORMAL"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="标准地图"/>
        <Button
            android:id="@+id/btn_SATELLITE"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="卫星地图"/>
        <Button
            android:id="@+id/btn_NIGHT"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="夜景地图"/>
        <Button
            android:id="@+id/btn_NAVI"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="导航地图"/>
        <Button
            android:id="@+id/btn_BUS"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="车路线地图"/>
        <CheckBox
            android:id="@+id/cb_traffic"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="显示实时交通状况"/>
        <CheckBox
            android:id="@+id/cb_building"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="显示3D 楼块"/>
        <CheckBox
            android:id="@+id/cb_maptext"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="显示底图文字"/>

    </LinearLayout>

</RelativeLayout>

2、创建显示地图的类文件ShowMapactivity

package com.junto.gdmaptest.activity;

import android.app.Activity;
import android.os.Bundle;
import android.support.annotation.Nullable;
import android.view.View;
import android.widget.Button;
import android.widget.CheckBox;

import com.amap.api.maps.AMap;
import com.amap.api.maps.AMapOptions;
import com.amap.api.maps.MapView;
import com.amap.api.maps.UiSettings;
import com.junto.gdmaptest.R;

/**
 * Created by WangJinyong on 2018/10/19.
 */

public class ShowMapActivity extends Activity implements View.OnClickListener {

    MapView mapView = null;
    AMap aMap;
    private UiSettings mUiSettings;
    Button btn_NORMAL, btn_SATELLITE, btn_NIGHT, btn_NAVI, btn_BUS;
    CheckBox cb_traffic,cb_building,cb_maptext;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_showmap);
        //获取地图控件引用
        mapView = findViewById(R.id.map);
        //在activity执行onCreat时执行mapView.onCreate(savedInstanceState),创建地图，必需要写的
        mapView.onCreate(savedInstanceState);
        initView();
    }

    private void initView() {
        //初始化AMap对象
        if (aMap == null) {
            aMap = mapView.getMap();
            mUiSettings = aMap.getUiSettings();
        }
        mUiSettings.setLogoBottomMargin(20);//设置LOGO图标距离页面底部的距离
        mUiSettings.setZoomControlsEnabled(true);//设置地图默认缩放控件是否显示
        mUiSettings.setZoomPosition(AMapOptions.ZOOM_POSITION_RIGHT_BUTTOM);//设置缩放控件位置
        mUiSettings.setScaleControlsEnabled(true);//设置地图默认的比例尺是否显示
        mUiSettings.setCompassEnabled(true);//设置地图默认的指南针是否显示
        mUiSettings.setTiltGesturesEnabled(true);// 设置地图是否可以倾斜
        mUiSettings.setMyLocationButtonEnabled(true);//设置地图默认的定位按钮是否显示
        aMap.setMyLocationEnabled(true);//是否可触发定位并显示定位层

//        mUiSettings.setLogoPosition(AMapOptions.LOGO_POSITION_BOTTOM_LEFT);// 设置地图logo显示在左下方
//        mUiSettings.setLogoPosition(AMapOptions.LOGO_POSITION_BOTTOM_CENTER);// 设置地图logo显示在底部居中
//        mUiSettings.setLogoPosition(AMapOptions.LOGO_POSITION_BOTTOM_RIGHT);// 设置地图logo显示在右下方
        btn_NORMAL = findViewById(R.id.btn_NORMAL);
        btn_NORMAL.setOnClickListener(this);
        btn_SATELLITE = findViewById(R.id.btn_SATELLITE);
        btn_SATELLITE.setOnClickListener(this);
        btn_NIGHT = findViewById(R.id.btn_NIGHT);
        btn_NIGHT.setOnClickListener(this);
        btn_NAVI = findViewById(R.id.btn_NAVI);
        btn_NAVI.setOnClickListener(this);
        btn_BUS = findViewById(R.id.btn_BUS);
        btn_BUS.setOnClickListener(this);
        cb_traffic = findViewById(R.id.cb_traffic);
        cb_traffic.setOnClickListener(this);
        cb_building = findViewById(R.id.cb_building);
        cb_building.setOnClickListener(this);
        cb_maptext = findViewById(R.id.cb_maptext);
        cb_maptext.setOnClickListener(this);
    }

    @Override
    protected void onResume() {
        super.onResume();
        //在activity执行onResume时执行mMapView.onResume ()，重新绘制加载地图
        mapView.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();
        //在activity执行onPause时执行mMapView.onPause ()，暂停地图的绘制
        mapView.onPause();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        //在activity执行onDestroy时执行mMapView.onDestroy()，销毁地图
        mapView.onDestroy();
    }

    @Override
    public void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);
        //在activity执行onSaveInstanceState时执行mMapView.onSaveInstanceState (outState)，保存地图当前的状态
        mapView.onSaveInstanceState(outState);
    }

    @Override
    public void onClick(View view) {
        switch (view.getId()) {
            case R.id.btn_NORMAL://标准地图
                aMap.setMapType(AMap.MAP_TYPE_NORMAL);
                break;
            case R.id.btn_SATELLITE://卫星地图
                aMap.setMapType(AMap.MAP_TYPE_SATELLITE);
                break;
            case R.id.btn_NIGHT://夜景地图
                aMap.setMapType(AMap.MAP_TYPE_NIGHT);
                break;
            case R.id.btn_NAVI://导航地图
                aMap.setMapType(AMap.MAP_TYPE_NAVI);
                break;
            case R.id.btn_BUS://车路线地图
                aMap.setMapType(AMap.MAP_TYPE_BUS);
                break;
            case R.id.cb_traffic://显示实时交通状况
                aMap.setTrafficEnabled(((CheckBox) view).isChecked());
                break;
            case R.id.cb_building://显示3D楼块
                aMap.showBuildings(((CheckBox) view).isChecked());
                break;
            case R.id.cb_maptext://显示底图文字
                aMap.showMapText(((CheckBox) view).isChecked());
                break;
        }
    }
}

在项目中使用地图的时候需要注意，需要合理的管理地图生命周期，这非常的重要。

这样一个基本地图就完成了。

下一节将介绍高德地图的手势交互功能。