【Android】接入高德地圖SDK

第一步 申請開發者權限

進入高德地圖開放平台https://console.amap.com/dev/index申請認證個人開發者

第二步 建立應用

第三步 下載下傳Android地圖SDK

進入https://lbs.amap.com/api/android-sdk/download/下載下傳 Android地圖SDK，然後導入項目工程

第四步 添加依賴

app/build.gradle中添加依賴

implementation fileTree(dir: "libs", include: ["*.jar"])
           

第五步 實作地圖展示代碼

1.layout檔案添加一個MapView

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    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">
    </com.amap.api.maps.MapView>

</LinearLayout>
           

2.AndroidManifest檔案添權重限

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.lbstest">

    <!--允許程式打開網絡套接字-->
    <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" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

    <application
        ...
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="ff7d55ecc5f5bc56560e69e9633dd73a" />
    </application>

</manifest>
           

3.代碼調用

package com.example.lbstest;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.widget.Toast;

import com.amap.api.maps.AMap;
import com.amap.api.maps.MapView;
import com.amap.api.maps.model.MyLocationStyle;

public class MainActivity extends AppCompatActivity {

    MapView mMapView = null;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mMapView = findViewById(R.id.map);
        mMapView.onCreate(savedInstanceState); // 此方法必須重寫

        // 顯示地圖
        AMap aMap = mMapView.getMap();

        // 首先處理權限
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.INTERNET)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.INTERNET}, 1);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 2);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_NETWORK_STATE)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_NETWORK_STATE}, 3);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_WIFI_STATE)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_WIFI_STATE}, 4);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.READ_PHONE_STATE)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.READ_PHONE_STATE}, 5);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_COARSE_LOCATION)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_COARSE_LOCATION}, 6);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_FINE_LOCATION)
                != PackageManager.PERMISSION_GRANTED){
            ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 7);
        }

        // 顯示定位藍點
        MyLocationStyle myLocationStyle;
        myLocationStyle = new MyLocationStyle();//初始化定位藍點樣式類myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);
        // 連續定位、且将視角移動到地圖中心點，定位點依照裝置方向旋轉，并且會跟随裝置移動。（1秒1次定位）如果不設定myLocationType，預設也會執行此種模式。
        myLocationStyle.interval(2000); //設定連續定位模式下的定位間隔，隻在連續定位模式下生效，單次定位模式下不會生效。機關為毫秒。
        myLocationStyle.myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE);
        myLocationStyle.showMyLocation(true);
        aMap.setMyLocationStyle(myLocationStyle);//設定定位藍點的Style
        aMap.getUiSettings().setMyLocationButtonEnabled(true);// 設定預設定位按鈕是否顯示，非必需設定。
        aMap.setMyLocationEnabled(true);// 設定為true表示啟動顯示定位藍點，false表示隐藏定位藍點并不進行定位，預設是false。
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 銷毀地圖
        mMapView.onDestroy();
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 重新繪制加載地圖
        mMapView.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();
        // 暫停地圖的繪制
        mMapView.onPause();
    }

    @Override
    protected void onSaveInstanceState(@NonNull Bundle outState) {
        super.onSaveInstanceState(outState);
        // 儲存地圖目前狀态
        mMapView.onSaveInstanceState(outState);
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        switch (requestCode){
            case 1:
            case 2:
            case 3:
            case 4:
            case 5:
            case 6:
            case 7:
                if (grantResults.length > 0 && grantResults[0]!=PackageManager.PERMISSION_GRANTED){
                    Toast.makeText(this, "拒絕權限将無法使用程式", Toast.LENGTH_SHORT).show();
                    finish();
                }
                break;
            default:
        }
    }
}
           

4.展示效果

備注：

高德開放平台AndroidSDK學習指南：https://lbs.amap.com/api/android-sdk/gettingstarted